FastX Silent and Automated Installs


Only for FastX Server version 3.3.17 and eariler.

The install.sh program is designed to help the installation by being user-interactive. Administrators wishing to automate their installs should run one or all of the install commands in their scripts.  Below is a listing of the operations needed for installing FastX using an automated install. 

Administrators can also call use the -q command to silently install with the default options:  /usr/lib/fastx/3/install.sh -q

Create a Fastx User

The install.sh script creates a user called fastx that will be used to run the fastx3 service file.  When rolling a custom install, make sure to have a fastx user account who owns the FX_VAR_DIR.  The FastX web server will switch to the uid of the owner of the FX_VAR_DIR directory. 

Add Licensing

Administrators typically use a centralized license server in a distributed system. Your installation should point to the central server.

  1. Create the directory /var/fastx/license
  2. Make sure the directory (from step 1) is world-readable (e.g. mode 755).
  3. Put the name of your license server into a variable: $LICENSE_SERVER
  4. Run this command: echo “HOST $LICENSE_SERVER 00000000 5053” > /var/fastx/license/$LICENSE_SERVER.lic
  5. Make sure that file is world-readable (e.g. chmod 644 /var/fastx/license/$LICENSE_SERVER.lic)
  6. If you have multiple (e.g. failover) license servers, repeat steps 3-5 for each license server on your network.

Install the Web Server

Run /usr/lib/fastx/3/install/web -q to install the web server.

Add the Initial Admin Group

Run /usr/lib/fastx/3/tools/reset-admin group1 group2 group3 … to set your initial admin groups.

Create Global Applications

Run /usr/lib/fastx/3/install/suggestions -q to create the initial set of bookmarks.  This is an optional command. In a cluster, the bookmarks are synced with the cluster members.  Run this command if you are making a standalone server.

Add Screenshot Support

The script /usr/lib/fastx/3/install/screenshot attempts to install the packages to support FastX screenshots (thumbnails). This may not be necessary if the packages are already installed or if you are on a closed network.

Create Clustering

Adding a server to a cluster is not done by the install script.   See our Clustering Guide for more information.

Customizing Configuration

Configuration can be customized via automated install by configuring and installing files. See Configuration Management for details