This guide will provide a quick walkthrough on launching your own FileCatalyst Server and licensing it on an Amazon EC2 instance.
Amazon Linux Amazon Linux - 64-bit Amazon Machine Image
FileCatalyst Server v3.8.3 Build 67
Launching FileCatalyst Server from the AWS Marketplace.
- Choose the Region that you would like to use from the drop-down list.
- Skip ahead one section and select the VPC Settings you would like to use.
- When initially deploying the FileCatalyst Server, we strongly recommend that you use the preconfigured Security Group called "Create new based on seller settings". You will be able to modify these settings on your EC2 dashboard later.
- To connect to the machine you will need a KeyPair. If there is an existing KeyPair you would like to use select it from the drop-down list.
- Review the rest of your settings and Machine connection information on the "Launch this software" page and click on Launch at the bottom.
Connecting to your FileCatalyst Server
- From your EC2 dashboard, you will be able to see the instances that you have currently active. When the instance has completed set up (Status checks 2/2), select it and click on the "Connect" button at the top. This will show you a pop up on how to connect to your instance using PuTTY.
Amazon has provided documentation to assist with your connection to the Ubuntu deployment here: https://docs.aws.amazon.com/console/ec2/instances/connect/docs
Getting a license key
- Connect to the FileCatalyst Server using PuTTY or a Terminal. Switch to the elevated root user using:
- Change your working directory so that you are in the FileCatalyst Server installation path by executing:
- Once you are in the folder, you will need to stop the FileCatalyst Server service if it is running.
service fcserver stop
Your expected output should be:
- The next step is to install a license key on the FileCatalyst Server. Run ./fc_server_console.sh and the FileCatalyst Server will attempt to start up. At this point, a request string will be shown:
Send the request string to your Sales Rep at FileCatalyst indicating what type of license you would like and how many concurrent connections you need. They will send you a key with the appropriate features enabled. Please copy and paste the Request String. Taking a screen capture of the request string may delay you getting a License key.
If you do not have the contact for a Sales Rep please send the Request String to [email protected]
Applying the license key
- Make sure your FileCatalyst Server is off before you proceed. You can run ps -ef | grep java in the terminal and make sure no instance is running. If you do see that there is an instance running please stop the application using service fcserver stop.
- Under /opt/utechsoft/server directory, edit fcconf.conf in a text editor. Paste your license key you received after the = sign:
## License key
FCServer.server.config.license=<Enter Key Here>
- Save the file.
Enable Remote Admin and set the Remote Admin Password
- Under /opt/utechsoft/server directory, edit fcconf.conf search for/modify the following:
a) Change the value for 'FCServer.server.config.remote.admin.enabled' to true
b) Change the value for 'FCServer.server.config.remote.admin.password' to
password of your choice (this password will be encrypted in file when
the server is restarted)
Launching the FileCatalyst Server
Enable Masquerade Address
The FileCatalyst Server itself now needs to know that it's working through a NAT device. To enable this:
- Open the Server Remote Admin Application.
- Select Advanced on the left-hand side.
- Check the box to Enable Masquerade Address.
- In the address field, enter the Public IP. This is not the IP of the machine running the FileCatalyst Server. If the network device acts as a gateway between your network and the public internet, you can find the public internet address quite easily by browsing from any machine to this site: http://whatismyip.com
Alternatively, you can obtain your Public IP (IPv4) from your EC2 instance management console. Do not use your DNS.
- Hit Apply.
Quick Start Guide: How to add External File System Storage on the FileCatalyst Server