Knowledgebase: Cloud Solutions
Install and Configure FileCatalyst Server BYOL on Amazon Marketplace
Posted by , Last modified by Aly Essa on 26 August 2020 02:05 PM

Overview

This guide will provide a quick walkthrough on launching your own FileCatalyst Server and licensing it on an Amazon EC2 instance.

Environment

Amazon Linux Amazon Linux - 64-bit Amazon Machine Image
FileCatalyst Server v3.8

Deployment Guide

Launching FileCatalyst Server from the AWS Marketplace.

  • Select the version of the FileCatalyst Server you would like to use. We recommend using the option with the latest Release Date:

  • 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:

    sudo su

  • Change your working directory so that you are in the FileCatalyst Server installation path by executing:

    cd /opt/utechsoft/server

  • 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:



  • Set execute permissions on the launch scripts in the installation folder. Make sure your current working directory is still /opt/utechsoft/server/. Run the following command to set the permissions:

    chmod u+x *.sh

  • 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 techpartners@filecatalyst.com

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.

  • 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.

Recommended: Change the Remote Admin Password

  • To change the Remote Administration password run the following command from /opt/utechsoft/server:

    java -jar FileCatalystServer.jar -passwdadmin

    The output should look like:


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.



Note:

Quick Start Guide: How to add External File System Storage on the FileCatalyst Server


Attachments