Skip to main content

Linux

Install FairCom on Linux systems

Important

The evaluation version of the product times out after three hours and shuts down the server. Therefore, the server needs to be restarted every three hours.

  1. Download the .tar file and move it to a directory where your current user account has full permissions.

    Note

    It is common to move the .tar file to the user folder — for example, if the .tar file is named FairCom-Edge.linux.x64.64bit.v4.5.1.170.230227.tar.gz the mv FairCom-Edge.linux.x64.64bit.v4.5.1.170.230227.tar.gz ~/user command will move it to the user directory.

  2. Use the tar command to expand the .tar file to create a new subdirectory that contains the FairCom server — for example, if the .tar file is named FairCom-Edge.linux.x64.64bit.v4.5.1.170.230227.tar.gz the tar -xvzf FairCom-Edge.linux.x64.64bit.v4.5.1.170.230227.tar.gz command will expand it.

    Note

    The subdirectory has a long name that includes the product name, target operating system, and the server version — for example, FairCom-Edge.linux.64bit.v4.5.1.145.

  3. Run the cd command followed by the name of the subdirectory to change the active directory to the newly installed subdirectory — for example, if the subdirectory is named FairCom-Edge.linux.64bit.v4.5.1.145 the cd FairCom-Edge.linux.64bit.v4.5.1.145 command will change the active directory to the subdirectory.

  4. Some Linux variants, including Ubuntu and CentOS, require the installation of a compression library for the FairCom server to launch correctly. Use the following commands to install the needed libraries:

    • Ubuntu

      sudo apt install zlib1g-dev

    • CentOS

      sudo yum install zlib-devel

  5. Type ./faircom and Enter to temporarily start the server and run it in the current terminal session.

    Note

    You can stop the server by closing the terminal session.

  6. Type ./startserver and Enter to start the server in the background and keep it running even when you close the terminal session.

  7. To stop the server:

    1. Open a new terminal session.

    2. Use the cd command to change the active directory to the server subdirectory.

    3. Type ./stopserver and Enter.

Run the server in production

Run multiple instances

You can run multiple instances of FairCom on the same computer by configuring them to use different ports.

Note

Attempting to run a second instance of FairCom with the same ports as a running instance will cause the second instance to exit with errors.

Check for running instances of FairCom

  1. Run the command: ps -ef | grep faircom.

  2. Observe the response.

    • Two lines of code indicate there is a FairCom server running.

    • One line of code indicates there is no FairCom server running.