Getting started with Claris Server

Before you begin

Installing Claris Server requires:

  • an Ubuntu 20.04 LTS operating system

  • an active internet connection for data sharing

Note  To install Claris Server, you can use Ubuntu Server or Ubuntu Desktop.

Download the Claris Server installer

Note  To install Claris Server on Ubuntu Server, use a separate computer with a desktop graphical user interface (GUI) to find the link for the installer (steps 1-3). To install Claris Server on Ubuntu Desktop, you can directly download the installer by clicking the Download button and saving the installer to your chosen directory.

  1. As a team manager, sign in to Claris Studio.

    If you're not a team manager, ask a team manager to do the next two steps and give you the installer URL.

  2. Click the user menu at the top right, then choose Downloads.

  3. Take note of the installer URL provided in the text below the Download button.

  4. Create a new directory to download the installer. Enter the command:

    mkdir <directory_name>

    Note  <directory_name> is your chosen directory name.

  5. Change to the installer directory. Enter the command:

    cd <directory_name>

    Note  <directory_name> is your chosen directory name.

  6. Download the Claris Server installer using the copied URL from the Claris Studio Downloads dialog. Enter the command:

    wget <installer_url>

    Note  <installer_url> is the URL noted in step 3.

Remove FileMaker Server if it's installed

  1. Disconnect all clients and close all databases using FileMaker Server Admin Console, or using the following fmsadmin commands:

    fmsadmin disconnect client

    fmsadmin close

  2. Make copies of databases stored in /opt/FileMaker/FileMaker Server/Data/Databases.

  3. Run the following command to stop the FileMaker Server service:

    sudo service fmshelper stop

  4. Run the following command to completely remove FileMaker Server from your machine:

    sudo apt purge filemaker-server

  5. Run the following command to remove packages that were automatically installed for FileMaker Server dependencies:

    sudo apt autoremove

  6. Restart your machine.

Upgrade Claris Server if an older version is installed

  1. Disconnect all clients and close all databases using Claris Server Admin Console, or using the following fmsadmin commands:

    fmsadmin disconnect client

    fmsadmin close

  2. Run the following command to stop the Claris Server service:

    sudo service claris stop

  3. Follow the instructions in the next section to install Claris Server.

    Your existing Claris Server data and settings are saved and will be used for the updated version of Claris Server.

Install Claris Server

  1. Open the Terminal application and navigate to the folder for the downloaded zip file. For example:

    cd ~/Downloads/<directory_name>

    Note  <directory_name> is your chosen directory name.

  2. Unzip the downloaded zip file:

    unzip cs-<VN>.<BN>-amd64-Ubuntu20.zip

    Note  <VN> is the version number and <BN> is the build number.

  3. Identify the name of the installer for Claris Server for Linux:

    ls claris*.deb

  4. Install Claris Server:

    sudo apt install ./claris-server-<VN>.<BN>-amd64.deb

    Note  <VN> is the version number and <BN> is the build number.

  5. Follow the prompts in the Terminal application to configure the Claris Server installation.

  6. After installation is complete, do one of the following:

    • For installations using Ubuntu Server: Use the following URL to sign in to Admin Console:

      https://<host>/admin-console

      Note  <host> is the IP address or host name of the machine running Claris Server.

    • For installations using Ubuntu Desktop: Close Terminal, then right-click the claris.desktop shortcut icon on your desktop and select Allow Launching. Double-click the claris.desktop shortcut icon to open Claris Server Admin Console in a web browser, then sign in to Admin Console.

Next steps