filestore version 2.0 (user guide) 1. introduction filestore
TRANSCRIPT
Filestore version 2.0 (User Guide)
1. Introduction
Filestore is a simple web application that should be used for transferring large volumes of
data within Skanska or with Joint Venture partners and Suppliers.
Currently Filestore is only written in English and in Czech and the maximum file size for
uploading is 1024MB (1GB).
To access the Filestore web application you will need to go to http://filestore.skanska.cz/ by
clicking the link or by typing it in to your web browser.
Depending on if you are a Skanska user or someone logging in from outside of Skanska, one
of two differing pages will be displayed:
Filestore as viewed from within Skanska
Filestore as viewed from outside of Skanska
It is not possible to “Create deposit ticket” if you are accessing Filestore from outside of
Skanska.
2. Upload files from Skanska network to someone else
To upload files you need to click on “Deposit the package” and then enter your e-mail address
and PIN (optional)
Example: Skanska user Jamie Jeffery wants to upload some files. He has entered his e-mail
(so he will receive the email with the download link and information about the package) and
he has entered his PIN as well.
The PIN will help to eliminate the risk that someone who is not the intended recipient could
read the e-mail and download your file.
Do not forget to send the PIN to the file recipient in a different way, for example via mobile
phone.
By pushing the “Continue to files selection” button a new page will be opened. You can
cross-check the information you previously input and any potential mistakes will be marked.
If there are no errors it is possible to select up to five files. Total package size is limited to
1024MB (1GB).
Once you are happy that you have the 5 files selected click on the upload button.
You can see the progress of the uploading on the Progress bar:
After uploading, the files will be scheduled for process and the final page will be displayed:
Your files are now stored as a package on the Filestore server. Each file is stored separately,
identified, It’s hash counted up and encrypted. Depending on the package size and the size of
the queue it may last from a few seconds to tens of minutes. When the process has finished,
you will receive an e-mail to the entered e-mail address. The email contains information
about the stored package and the download link for collecting the package from Filestore.
Example of the download link contained within the email:
http://filestore.skanska.cz/collect.jsp?0yEQYUZuDAwgsF73bGhpFLfbO8Ot4Fva
You can copy this download link and forward to the people who need to download the files.
Please note that Filestore can not be used as a permanent place to store files as packages will
be deleted automatically if no one downloads them.
3. Upload files from Internet
Uploading files from the Internet (outside of Skanska) is similar to uploading files from
within the Skanska network. However there are a few differences. The main difference is that
from the Internet you get “Deposit ticket”, this is to prevent access to uploading to Filestore
by anybody from outside of Skanska.
The deposit of the package is divided into two separate steps:
1. Creation of Deposit ticket
2. Deposition of the package by using Deposit ticket
3.1. Creation of Deposit ticket
Creation of Deposit ticket is only possible from within the Skanska network.
To create a download link for people outside of the Skanska network click on the "Create
deposit ticket for external subject" link on the home page.
You will get a simple form. There you enter your e-mail address.
Example: Skanska user Jamie Jeffery creates a ticket to get some files to someone outside of
the Skanska network. He has entered his e-mail. The entered e-mail will be associated with an
appropriate ticket and will automatically be used as the address to receive all emails relating
to this ticket.
By clinking the link “Create and send ticket” you get a final report with information about the
ticket:
You will receive an email to the entered email address. The email contains the Ticket
Number with a link for uploading files to someone outside of the Skanska network.
Example of link:
http://filestore.skanska.cz/store.jsp?45cdad3a8e068c1e
You can provide this link to people outside of the Skanska network who need to send you
files. The Ticket number (and it’s link) is possible to use repeatedly by different people to
send you some files. The ticket and all associated files and packages will be deleted
automatically, when nobody uses it for a few weeks.
3.2. Upload files by using ticket link
Uploading files from outside of the Skanska network is similar to uploading files from within
the Skanska network. The only difference is that you have to fill in the ticket number rather
than an email address:
The next steps are the same as in Chapter 2 (Page 3)
4. Collect package
To collect a package you need to click on the "Collect package" link from the home page or
click on the download link in the email
You have to enter the Ticket Number (if you use the download link from the e-mail, the
Ticket Number is already completed). Next you need to enter the PIN if one was set (the
creator of the package will be able to tell you what this is set to).
If you entered a valid ticket number and PIN, when you click “Collect package”, the content
of the package will display on screen.
In the example below there is package from Jamie Jeffery for someone outside of the Skanska
network:
It’s possible to download each file by clicking on the filename. You see the following
download notification:
It is recommended you use “save” file instead of “run” file.
5. Security and technical details
5.1. Encryption
All stored files are encrypted by symmetrical code CAST5. The Data encryption code is part
of the package ID and is unique for each package. The code is not stored on the Filestore
server. The PIN is also a part of Data encryption code. It is virtually impossible to obtain
the content of a package without the ID of the package and the PIN, including by the
system administrator.
5.2. Type of file
The type of files are displayed in a list by file type. They are displayed real the real file type.
This means that the system ignores suffix of files, but associate them according to real content
of file IE if you change the file suffix from .exe to .pdf, the file will be always displayed as a
.exe (executable file). Filestore does not scan content of archive (e.g. .zip file).
5.3. Checksum MD5
Checksum can be used to do a quick integrity check or identification of file by uploader or
downloader. A standard user would not use it.
5.4. SW platform and tools
Debian GNU/Linux
Jetty - web Server (Java container)
PostgreSQL - database server
Java and Perl – programming languages
Jiří Svoboda, author of filestore and original of this User Guide (in Czech language)
Emil Reiter, first English translation
Jamie Jeffery, UK assistance (English corrections, new screenshots)
created 24.4.2008, last release 23.6.2011.
Edited for the UK 17.01.2012