Skip to main content

MacOS

Install FairCom on MacOS

  1. Download the .tar file (FairCom-Edge.osx.v<version>.<processor>.tar) and move it to the Documents folder using the Finder app.

  2. Open the Terminal app in the Documents folder.

    1. In the Finder window path bar, Control-click the Documents folder.

    2. Select Open in Terminal from the shortcut menu.

  3. Use the tar command or double-click the .tar file to expand it 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.

  4. Run the cd command to change the active directory to the Home folder within the Contents folder — for example, FairCom-Edge.OSX.<processor>.<version>/Contents/Home.

  5. Type ./faircom and Enter to 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

  • FairCom recommends using the systemd command.

  • See also, Script to start and stop the server.

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

  3. Alternatively, run the Activity Monitor application and search for faircom.