FastX Nonroot installation

Note: Many system administrators have root access, but wish to install the FastX server in an alternate location (for example a shared directory). The rpm package can be relocated by following these instructions

Server Side Installation

Installing the RPM

Users who do not have root access can still install FastX using the following commands to extract the file from rpm. First, download the RPM file to your home directory, then run these commands to extract it:

cd $HOME
mkdir FastX
cd FastX
rpm2cpio ~/StarNetFastX2-version.build.rhel5.x86_64.rpm | cpio -id
mv usr/* .
rmdir usr

 

After the installation has completed run the following command

$HOME/FastX/lib/fastx2/install/postinstall

The basic installation of FastX is now complete.  The next step is to license FastX

Licensing

Activating a License

To install a license (necessary to launch a session), run:

$HOME/FastX/lib/fastx2/install/activate

Running the License Server

After the license is installed, run the license server

$HOME/FastX/lib/fastx2/rlm/rlm

Suggestions

FastX can scan your system and preconfigure basic suggestions (GNOME, KDE, xterm etc) to simplify the connection process.  If you want FastX to check for default suggestions ru

$HOME/FastX/lib/fastx2/install/suggestions

Web Server

NodeJS must be installed as a prerequisite to running a web instance of FastX.

Setting up the Web Server

The web server allows web based access to your sessions as well as GUI administration and configuration of FastX.  To set up the web server run

$HOME/FastX/lib/fastx2/install/web

Running the Web Server

To run the web service with default settings, run:

nohup node $HOME/FastX/lib/fastx2/www/server/bin/fastx_server.js &

Client Side Connections

Connecting Via the Web

The web server must be installed and running before connecting

  1. Open a Browser
  2. Connect to http://your.server.name.com:3000

 

Connecting Via the Desktop Client using SSH

  1. Launch the FastX Desktop Client
  2. Click on the plus “+” icon
  3. Select the SSH option
  4. Fill out the Name, Host and User information
  5. Set the Sci field to the path to the fastx_sci program $HOME/FastX/bin/fastx2_sci
  6. Save
  7. Connect