| Home Prev |  EasyAccess 4.3 Getting Started Guide
|
Next |
|---|
This section describes the installation of the EasyAccess server software on a Linux based computer.
Installation steps are given for the following:
Using the X Window interface.
Using the CLI.
Installation on LINUX using the X Window Interface
Open a console.
Enter:
> chmod +x easy_server_linux_x64_<version>.sh
To start installation, enter:
> sudo ./easy_server_linux_x64_<version>.shThe wizard welcome screen will display. Click Next.
Accept the license agreement.
Select the installation location or accept the default destination.
Select the license file. Downloading a license is described in Section 2.3, Licenses.
Enter the administrator username and password. These credentials will be used for accessing the EasyAccess configuration manager WebUI. Note that no other characters than A-Z, a-z and 0-9 are recommended.
Enter an encryption key seed used for encrypting persistent data such as token keys. Note that if this is a single node or the first node in a cluster then the encryption key can be anything. However, if this node is to be joined into an already existing cluster, the key MUST be the same on all nodes. Note that no other characters than A-Z, a-z and 0-9 are recommended.
Enter the HTTP port that access to the configuration manager WebUI will use. For example, 8443. If the installation is being done in a virtual environment, check the box I am installing on a virtual machine.
Click Finish to end the Setup.
Installation on LINUX using the CLI
Open a console.
Enter:
> chmod +x easy_server_linux_x64_<version>.sh
To start installation, enter:
> sudo ./easy_server_linux_x64_<version>.sh** -c
Press the Enter key to continue.
Accept the license agreement.
Select the installation location.
Select the license file.
Enter the default system administrator username for access to the configuration application.
Enter a password for the system administrator that was set in the previous step. Note that no other characters than A-Z, a-z and 0-9 are recommended.
Enter an encryption key seed used for encrypting persistent data such as token keys. Note that if this is a single node or the first node in a cluster then the encryption key can be anything. However, if this node is to be joined into an already existing cluster, the key MUST be the same on all nodes. Note that no other characters than A-Z, a-z and 0-9 are recommended.
Enter the HTTP port the management WebUI will use. For example, 8443.
If the installation is being done in a virtual environment, answer yes and press Enter. If not, just press Enter.
Indicate if this installation is part of a cluster.
Indicate if this installation is on an appliance.
Installation is complete.
Starting the EasyAccess Server on Linux
The server is started using the bash script called start-PhenixID.sh which is located in the EasyAccess/Server/bin/ folder. The console command would therefore be:> sudo [install-path]/EasyAccess/Server/bin/start-PhenixID.shThere must be a valid license file in the license folder for the server to start successfully. Note that the server will take a short amount of time to initialize and start up completely. The startup phase can be monitored using the following Linux console command:
> netstat -nlap|grep :8443When the server is operational, the command output will show a Java process listening on the specified port. The server.log file should also contain a log that indicates successful startup.
The "No fonts found" Error Message
When running EasyAccess under Linux, a potential problem that could arise when the EasyAccess server starts is that the relevant dejavu fonts required by EasyAccess are not installed. This problem results in the following error appearing:java.lang.Error: Probable fatal error:No fonts found.
The issue can be resolved by installing the required fonts and doing this is described for different Linux distributions in a Clavister Knowledge Base article at the following link:
