IceBreak FileShare Quick Guide File sharing with workflow management on IBM i
2 IceBreak FileShare Content IceBreak FileShare... 3 Features... 4 Requirements... 6 Limitations... 6 Test sites... 6 Install IceBreak FileShare... 7 How to Install from Application Store.... 7 How to setup IceBreak FileShare.... 13 File sharing in Windows XP... 18 File sharing in Windows 7... 23 File sharing on Mac OS X... 27 Issues with OS X WebDAV and IceBreak FileShare... 30 File sharing on mobile devices... 31 Setting up a connection in the app, ifiles... 31 Setting up a connection in the app, Documents... 39 Creating and installing SSL certificate.... 47 Summary... 63 Copyright 2013 System & Method A/S All rights reserved. No parts of this work may be reproduced in any form or by any means graphic, electronic or mechanical, including photocopying, recording, taping, or information storage and retrieval systems without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document.printed:
3 IceBreak FileShare IceBreak FileShare IceBreak FileShare opens the file system (IFS) on IBM i (AS/400, iseries), so users regardless of platform (Windows, Mac, Linux) can share folders, files and documents. IceBreak FileShare is similar to the well known products Dropbox, SkyDrive and Google Drive but has the advantage of storing folders, documents and files safely on IBM i and integrating with any ERP solution. All types of information Now it is possible to collect, store and share new information types in the form of photographs, videos, audio recordings and geo locations. These type of information has previously not been shared and only been available on one's personal smartphone. IceBreak FileShare handles all types of files from documents to presentations, spreadsheets, images, audio and video files and in all formats. Secure also outside the company File sharing is protected with password and SSL encryption which secure a safe external access from particular smartphones and tablets. Countless apps covers every need The file sharing is supported by countless apps for iphone, ipad, Android, Windows Phone and BlackBerry so there is ample opportunity to find one or more apps that fits a desired workflow. Most apps also supports the ability to copy folders, documents and files to the device itself, so they can be processed offline on flights or outside mobile data coverage. Dynamic workflow IceBreak FileShare monitors the shared folders and can be programmed to initiate a given workflow on IBM i when a file is created, modified, moved or deleted. Folder structure can be built dynamically e.g. presenting every product in the database as a folder. Hereafter documents and images can be automatically linked to a given product number just be moving them to one of the fictive folders. The file share can be configured to save previous versions of documents in a folder called "Archive" and move deleted documents a "Trash" folder. Real file sharing This is a real file share and not just a simple synchronization between server and client. This ensures that you always are working with the latest version. The document is locked until editing is complete to avoid conflicts.
4 IceBreak FileShare Features Knowledge sharing Documents are presented in levels divided into folders, as in the familiar Windows Explorer and follow the general rules on the computer. Folder structure does not necessarily follow the physical folder structure on IBM i. It can be done dynamically, so that it reflects a structure in the administrative ERP solution that seems most natural in a given workflow and makes it easier to find a specific document. The same document can in principle be found via several different folder structures which make the search more intuitive and faster. Built in workflow IceBreak FileShare monitors the shared folders and can be programmed to initiate a given workflow on IBM i, when a file is created, modified, moved or deleted. The workflow can use the naming of the dynamic folder structure for creating search keys and database lookups. The built in workflow makes it easy to: update products with images update customers with issued documents update deliveries with scanned freight bills by simply dragging them into the respective folder structures. The workflow can be integrated to any business solution and is highly compatible with our other workflow products. Information Collection IceBreak FileShare opens new opportunities to streamline work processes through mobile data collection. An insurance assessor can photograph a damage to a property and attach a geo location A traveling salesman can register a claim and document with photos A service engineer can film a mechanical deviation A lawyer can audio record and document a meeting All of the above is securely archived under current case on the IBM i server in one operation from the smartphone. The collected material is immediately made available on the IBM i, so the office staff can continue the process.
5 IceBreak FileShare On mobile devices File sharing is protected with password and SSL encryption which secure a safe access from external laptops, smartphones and tablets. The file sharing is supported by countless apps in ios (iphone and ipad), Android (Galaxy, Nexus, Xperia, HTC and LG), Windows Phone (Lumia) and BlackBerry. You can freely choose any app that suits a current task. After installing you simply create a connection to IceBreak FileShare by providing URL, user profile and password then the file share will open like an ordinary file structure in the app. The following features can often be found in the apps: View file, document, picture, recording, movie Download, Upload, Print and Share over Bluetooth or Wi Fi Attach to e mail, save attachment from e mail or e mail a link Open in (another app) Move, Copy, Rename, Delete, Change Properties Take pictures Make recording or movie Paste from clipboard Create Folder Create and change Text document Create and change Office documents in Word, Excel and PowerPoint The selected app must support WebDAV, which is a known extension to the HTTP protocol, that allows you to transfer and process documents. WebDAV is an abbreviation for "Web based Distributed Authoring and Versioning". On our website you will find a list of apps that we have tested under Apple's ios and Google's Android operating systems click here: http://system method.com/appstore/fileshare. On desktop computers File sharing can also be opened on any desktop computer under the operating systems Windows, Mac and Linux. The connection is the same as on the mobile device and works with the secure SSL connection both inside and outside the corporate network. In principle, it is not possible to see the difference between the file sharing and the traditional network drive. Users can use drag and drop and all the installed programs to process files with. This provides a tight integration to the administrative ERP solution on IBM i and a consistent workflow for all users whether they are on a smartphone, a tablet, a laptop or a desktop computer.
6 IceBreak FileShare On the IBM i server Folders, files and documents are stored on the central IFS and can be included in the daily backup. Additionally, they are protected by the operating system against unauthorized access and virus attacks. File sharing can be configured to be based on different root folders and thereby delimit access to the IFS and other user groups folders. To gain access to file sharing, users must either have a user profile on IBM i or be created as a user in IceBreak FileShare. Requirements IceBreak FileShare requires IBM i (OS400) V5R4 or higher and Java 1.6. To run IceBreak FileShare under SSL you need to acquire and install a SSL certificate. Please read chapter in this guide. Limitations IceBreak FileShare over SSL doesn t work in Windows 7 with a self signed certificate on the web server. A certificate from a trusted root certificate authority is needed for normal use cases, or otherwise any attempt to map an IceBreak FileShare folder to a network drive will fail with an undescribed error messages such as: An unexpected network error occurred. Test sites You are welcome to try IceBreak FileShare by creating a WebDAV connection to one of our test servers: http://fileshare2.icebreak.org https://fileshare.icebreak.org Please use demo in both User and Password. You can create a WebDAV connection from: Windows XP Windows 7 Mac OS X A mobile device using an app The following chapters describe how to setup the connection in the different environments. The files on our servers are restored daily. Please note that some apps do not support https. Click here: http://systemmethod.com/appstore/fileshare to see a list of apps that we can recommend.
7 IceBreak FileShare Install IceBreak FileShare The current version of IceBreak FileShare is depending on IceBreak CE Server to run. IccBreak CE Server is FREE but you will need to install it first in order to get IceBreak FileShare to run. Installation procedure: 1. Install IceBreak from http://www.system method.com/download/icebreakce. Follow the instructions on the screen. A successful installation will open the IceBreak Administration menu and give you access to the IceBreak Application Store. 2. Then continue the installation of IceBreak FileShare How to Install from Application Store. 1. Open the IceBreak Administration Menu and Select Application Store.
8 IceBreak FileShare 2. Locate IceBreak FileShare and press Download Save the.ifw file on your desktop.
9 IceBreak FileShare 3. Click Install application on Server 4. Locate the IceBreak FileShare file on your desktop by clicking Browse
10 IceBreak FileShare 5. Click Open. The IceBreak FileShare framework will now be uploaded to your browser.
11 IceBreak FileShare 6. If desired change the port number, and Click Install Application.
12 IceBreak FileShare 7. Then press Open Application. 8. Press Open Application to open IceBreak FileShare in a Browser.
13 IceBreak FileShare How to setup IceBreak FileShare. Log in using your IBM i credentials. And save the URL in you Favorites. 1. The name of the application. It will appear on the log in page.
14 IceBreak FileShare 2. The root path (start path) for the documents and files on the IFS 3. This is the port number for the IceBreak FileShare instans. This is NOT the port number for the IceBreak FileShare Administration interface (THIS server is located as you earlier configured on port number: 8111) 4. Here you put the url to the program that makes the user authentication and other security validations. 5. Mark the checkbox if you will use secure communication with your server (SSL secure socket layer). If you chose to do this, make sure that your server port (see 12) is set to 443.
15 IceBreak FileShare 6. If SSL is checked. 7. Here you type in the system name or IP address of your IBM i 8. Now type in the name and library name of the data queue that will handle IceBreak FileShare request. 9. To let your IBM I handle the security, mark this checkbox. Then the IBM I operation system will handle the request according to the object security. If NOT checked, all requests are handled according to the default IceBreak user: BLUEBOXUSR object authorization.
16 IceBreak FileShare 10. Here you put in the program name and library name for monitoring the data queue. This is here you will handle any user exit routines, work flow and other specific actions. 11. Mark this checkbox if you want IceBreak Portfolio to handle all non IBM i users. This means that you can have a lot of external users that are not created on you IBM i but are chained together with one or more IBM i users or groups. 12. If you want to use versioning on your changed or deleted files, you must mark this checkbox.
17 IceBreak FileShare 13. If checked, the changed files and documents will be saved in a folder called: Archive in the current directory. If deleted are checked, they will be saved in a folder called Trash in the current directory. 14. Click Save and your new settings will be applied, and the IceBreak FileShare server will restart with the new settings.
18 IceBreak FileShare File sharing in Windows XP This chapter describes how you can create a connection in Windows XP. 1. From the Windows Start menu, click My Network Places. 2. From the My Network Places dialog, click Add network place.
19 IceBreak FileShare 3. On the next screen, select Choose another network location option then click Next.
20 IceBreak FileShare 4. In the Internet or network address field, enter your IceBreak FileShare address: https://your_site_url (where your_site_url is the URL of your IceBreak FileShare e.g. fileshare.icebreak.org.), then click Next. 5. Enter your user name demo and password demo
21 IceBreak FileShare 6. Give your network place a name and click Next. 7. Click Finish.
22 IceBreak FileShare You can now drag and drop files or folders to and from your IceBreak FileShare directory. You can access these files in the future under My Network Places listing in Windows Explorer.
23 IceBreak FileShare File sharing in Windows 7 This chapter describes how you can create a connection in Windows 7. 1. From the Windows Start menu, click Computer
24 IceBreak FileShare 2. Within the Computer window that appears, click Map network drive. 3. Within the Map Network Drive dialog, enter your IceBreak FileShare address: https://your_site_url (where your_site_url is the URL of your IceBreak FileShare site e.g. fileshare.icebreak.org).
25 IceBreak FileShare 4. Click the two check boxes at the bottom. 5. Click Finish. 6. Enter your user name demo and password demo and click the Remember my credentials checkbox.
26 IceBreak FileShare 7. You can now drag and drop files or folders to and from your IceBreak FileShare directory. You can access this drive in the future under the Computer listing in Windows Explorer.
IceBreak FileShare This chapter describes how you can create a connection on Mac OS X. 1. To connect to the server on Mac OS X, use Finder Go >Connect to Server command. Type the address of the IceBreak FileShare server in the Server Address field: 2. You can add the IceBreak FileShare directory path to your Favorite Servers list by clicking on the + button to the right of the address for future reference.
IceBreak FileShare 3. Click on Connect to initiate the server connection. 4. Under IceBreak FileShare System Authentication, type in your user ID and password. 5. Click "Connect"
IceBreak FileShare 6. Once you are authenticated, the server connection will mount a network drive on your desktop with your Internet ID as the name of the drive. 7. You can now drag and drop files or folders to and from your IceBreak FileShare directory.
30 IceBreak FileShare Issues with OS X WebDAV and IceBreak FileShare Closing File... When transferring larger files from your computer to IceBreak FileShare via a WebDAV connection, files will appear to transfer very quickly but then the transfer dialog box will show (Closing file ) Please wait for an extended amount of time. The file will eventually transfer, but you will not know how long it might take. This appears to be a flaw in OS X s implementation of WebDAV and there is no known way to fix it. It is possible to use other client software such as Goliath to transfer files..ds_store Files Macs use.ds_store files to store information for the finder. When using the finder you won't see these files but after using IceBreak FileShare with Mac WebDAV you will see these in every folder that you visited. Theses instructions (from http://docs.info.apple.com/article.html?artnum=301711) will prevent the finder from creating these files on remote servers. Note: This will affect the user's interactions with SMB/CIFS, AFP, NFS, and WebDAV servers.. Open the Terminal.. Type: defaults write com.apple.desktopservices DSDontWriteNetworkStores true. Press Return. Restart the computer.
IceBreak FileShare This chapter describes how you can create a connection on a mobile device like an iphone or an ipad. Click here to see a list of apps that we can recommend on Apple ios and Android. Setting up a connection in the app, ifiles The following can be used as an example for other apps. 1. Go to App Store 2. Search App Store for ifiles, buy and install it.
IceBreak FileShare 3. When installed, press OPEN
IceBreak FileShare 4. Press Dashboard.
IceBreak FileShare 5. Press + to add your IceBreak FileShare server connection.
IceBreak FileShare 6. Choose your service by pressing WebDAV
IceBreak FileShare 7. Setup your IceBreak FileShare connection. In this case we use SSL to connect. Press Save when you re done.
IceBreak FileShare 8. The setup is now completed. Press IceBreak FileShare to start working with your documents and files.
IceBreak FileShare 9. Start working with your documents and files. For further information and guides to ifiles go to: http://www.imagam.com/ This App is also available for iphone. You can get it in App store here: https://itunes.apple.com/us/app/ifiles/id336683524?mt=8
IceBreak FileShare Setting up a connection in the app, Documents In this example we are using Readdle Documents. Readdle has great variants of products to interact with IceBreak FileShare. We can highly recommend using these applications. 1. Go to App Store 2. Search App Store for Readdle and install it. The application is free.
IceBreak FileShare 3. When installed, press OPEN
IceBreak FileShare 4. Press Network
IceBreak FileShare 5. Press + Add storage
IceBreak FileShare 6. Choose Other WebDAV Server
IceBreak FileShare 7. Setup your IceBreak FileShare connection. In this case we use SSL to connect. Press Save when you re done.
IceBreak FileShare 8. The setup is now completed. Press IceBreak Fileshare to start working with your documents and files.
IceBreak FileShare 9. Start working with your documents and files. For further information and guides to ReaddleDocs go to: http://readdle.com/ This App is also available for iphone. You can get it in App store here: https://itunes.apple.com/dk/app/readdledocs documentsattachments/id285053111?l=da&mt=8
47 IceBreak FileShare Creating and installing SSL certificate. The following describes the creation of the certificate via startssl a certificate issuer which is free (for simple certificates) and standard approved in IE. 1. Create yourself on http://www.startssl.com/ so you get installed a certificate that automatically logs you into. 2. Register root domain(s) under "Control Panel" > "Validation Wizard" and have it confirmed by mail. (example of root domain: icebreak.org)
48 IceBreak FileShare 3. In the toolbox now select "Certificates Wizard" and create a "Web Server SSL / TLS Certificates" 4. Push skip to Generate Private key
49 IceBreak FileShare 5. You end up at a page where you must enter a CSR:
50 IceBreak FileShare 6. You create the CSR in the program Portecle Start the program and choose to create a new JKS keystore: 7. Select Generate key Pair :
51 IceBreak FileShare 8. Select RSA 2048 : 9. Fill in the "Common name" Organization Name "," State name "and" Country ". Common name must be the domain you are issuing the certificate to ". It might look like: 10. Accept the default Alias :
52 IceBreak FileShare 11. Enter a password and remember it : 12. You should now get a success message: 13. Right click on <Key pair aliasname> in the list and select Generate Certification Request :
53 IceBreak FileShare 14. Save the request where you can find it again: 15. You should get a success message:
54 IceBreak FileShare 16. Now open the file (in notepad) and past the CSR request into the startssl page and press "Continue" :
55 IceBreak FileShare 17. You should get a confirmation to which you push Continue : 18. Select the root domain and push Continue :
56 IceBreak FileShare 19. Enter your subdomain and push Continue : 20. When you get a confirmation you push Continue :
57 IceBreak FileShare 21. You now have to wait for an mail : 22. Before you process the email you must import the CA and the Intermidiate certificate. Select Toolbox and select StartCom CA Certificates :
58 IceBreak FileShare 23. Download the certificate s StartCom Root CA (PEM encoded) and Class 1 Intermediate Server CA and save the files on your disk with default names :
59 IceBreak FileShare 24. In Portecle you now import the 2 certificates with unchanged information s: 25. Portecle should look like this :
60 IceBreak FileShare 26. When you get the mail from 21) select toolbox > Retrive Certificate, find the certificate and select Continue : 27. Copy the Certifikate to a new notepad file and save it:
61 IceBreak FileShare 28. In Portecle right click on <key pair aliasname > and select Import CA reply : 29. Select the certificate file saved in 27):
62 IceBreak FileShare 30. You should get a confirmation of this: 31. Save the keystoret as a JKS fil (use same password as before): 32. The JKS file is moved to the iseries under the fileshare server (/www/iceshare). The placing of the file and the password for the certificate is put into the setup.
63 IceBreak FileShare Summary Supported Devices and operating systems Description Non SSL SSL Tablets X X Smart Phones X X Mac X X PC X X Windows XP X X Windows 7 X X IOS X X Android X X Drive Mapping Description Non SSL SSL Windows XP X X Windows 7 X X Mac X X Tablets X X Smart Phones X X File share / Mapped drive Integration with Microsoft Office Description Non SSL SSL Windows XP X (partial) X Windows 7 X (partial) X IOS X X Tablets X X Smart Phones X X Partial Depends on your PC's setup and service pack level and MS Office Version Browser Supported Integration with Microsoft Office Description Direct editing Download IE 7+8+9+10 X (SSL ONLY) X Firefox X Chrome X Safari X
64 IceBreak FileShare