Amazon S3 Setup

NOTES:

• Workamajig only needs one sign-on account to connect.
• Thumbnails are not supported when using box.com.if
• The "Archive" function does not work with Amazon S3. This should not be an issue as it would simply create a new folder in the main Bucket folder and name it Archive and place project folders within. So basically moving a folder from the C: drive to the C: drive to archive. It would be better if you backup the "active" folder that is used for project folder storage.

Amazon Setup

1. Go to the AWS Management Console
   
2. Select Services>>choose Storage: S3
   
   
3. Create a Bucket
   
   
4. Click on this link to find the appropriate region setting: Select Region
   The region selected MUST support Signature Verification: Version 2. Some on the list support Version 4 Only, do NOT select these regions!
5. Select the appropriate Region in the Create Bucket screen
6. Enter a Bucket Name

NOTE: The Bucket Name must be unique across all Amazon S3 services.  The Bucket Name should be a combination of your Company Name and Workamajig with a dash in-between.  For example, agencyx-workamajig as the Bucket name. 

7. Click "Create"
8. Once your Bucket is completed click on the bucket to open>> click Permissions tab> Click CORS Configuration
   
   
9. Copy the following and paste to replace the existing CORS Configuration:
   <?xml version="1.0" encoding="UTF-8"?>
   <CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
       <CORSRule>
           <AllowedOrigin>*</AllowedOrigin>
           <AllowedMethod>GET</AllowedMethod>
           <AllowedMethod>POST</AllowedMethod>
           <MaxAgeSeconds>3000</MaxAgeSeconds>
           <AllowedHeader>*</AllowedHeader>
       </CORSRule>
   </CORSConfiguration>
10. Click Save: this will save the COR Configuration setting. Confirm that the CORS configuration in Amazon matches the above
11. Click on Overview tab>>click upload: select any file from your workstation to upload
12. Click on the file to see details>> under Link: copy the "Server URL" section of the link for use in Workamajig
    
    
    You will now create the login credentials needed to setup the connection with Workamajig.
13. Click on your Login Name in upper right corner>>My Security Credentials
    
14. Click Access keys (access key ID and secret access key) >> Create New Access Key
    
15. Click "Continue to Security Credentials"
    
16. Click "Show Access Key" or "Download Key File"
    NOTE: If you do not download the key file, leave this screen open so you can copy/paste the Access Key ID and Secret Access Key into Workamajig
    
    
    
17. Once your access keys have been created, sign in to your Workamajig account to continue with the setup process.

Workamajig Setup

GO TO WEBDAV SETUP

1. Open up the WebDAV setup page by going to the Workamajig Menu -> Admin/Manager -> System Setup -> Account Information -> Connections.
   
   
2. Click WebDAV
   
3. Click WebDAV Servers>> + 
4. From the Type drop down, choose Amazon.
   
5. Paste the Server URL you copied from the S3 setup.  Be aware that some of the regions require region-specific URLs.  For example, if you are in the Ireland region (eu-west-1) you need to set up the URL as s3-eu-west-1.amazonaws.com.
6. In the Root Path section: enter the Bucket Name you created in S3 setup
7. Client Folder: select the appropriate Client folder: Default= Client ID
8. Project Folder: select the appropriate Project folder: Default= Project Number
   NOTE: Step 7 & 8 define how Workamajig will create folders in the Amazon bucket: The hierarchy of folders on Amazon is S3>BucketName>active>ClientID>ProjectNumber>project folders/files
9. SAVE> Close the Server Details screen by clicking the X in the top right corner
10. Click on the Server Name to reopen the screen
11. Click on Enter Amazon Authentication Keys
    
    
12. Toggle to the Amazon S3 Access key screen> Copy and paste the Access Key ID and Secret Access Key
    
    
13. SAVE

Verify The Setup

1. Logout/in to Workamajig
2. Open the WebDAV Setup screen to verify there are no issues.
3. Open any project in Workamajig. Upload a file. Confirm that the file is invisible in your Amazon Bucket. 

You can now log out of Amazon S3 and Workamajig, you have completed the setup. If you have any issues, please contact Workamajig via Support@Workamajig.com

How Do I Get My Current Files On Workamajig Transferred

There are 3 methods we can use to transfer your files from our Workamajig server to you:

1. S3 Sync Tool: (Preferred) Provide us with the Bucket Name and keys to connect to S3 browser to your system. For further information, please see  https://s3browser.com
2. Dropbox: We will provide you with a Dropbox link to retrieve your files. You will then upload the folder into your S3 Bucket/Workamajig folder. The folder structure from Workamajig will be retained, so you need to only drop the Active, Attachments and Reviews folders into the main Workamajig folder. NOTE: the total size of your company zipped folder may make this method unavailable to use.
3. Google Drive: Provide us with access to a Google drive login and we will transfer the files to this drive location. You will then upload the folder into the S3 Bucket/Workamajig folder. The folder structure from Workamajig will be retained, so you need to only drop the Active, Attachments and Reviews folders into the main Workamajig folder. NOTE: the total size of your company zipped folder may make this method unavailable to use.
    

NOTE: During the transfer process there can be no uploads or modifications to any files in any location in Workamajig. However, you can still view the files. Once the transfer of the files is confirmed we will delete them on our servers (we have a 30-day backup that we can restore if necessary).
 

Further Assistance

• Getting Started with AWS (Amazon Guide)
• If you have any issues during or after doing the above, please contact support@workamajig.com for assistance.