Installing on Linux

This document gives an overview of how to install the PhenixID server product on Linux. Additional information is found on PhenixID web site or through PhenixID support.

If getting error message like:

Exception in thread "main" java.lang.Error: Probable fatal error:No fonts found.

It is required to add the missing fonts before retrying the installation.

Audience

This document is written for system administrators. For more information regarding administration, configuration, backup/restore e.g., please read the PhenixID Administration Guide.

Prerequisite

Installation media is provided through PhenixID support together with required license.

Hardware

A single instance of the PhenixID server will require a minimum of 5 GB of drive space and 2 GB of RAM. This setup will be sufficient for installations up to 10 000 users. 4GB of RAM is recommended for installations with
 10 000-100 000 users. Please contact PhenixID support for larger installations.

PhenixID Server is not CPU intensive; one CPU should work for most scenarios.

Installation

Install PhenixID on LINUX using X

For install on Linux using Command Line Interface (CLI), see next section

  1. Open a terminal
  2. Type chmod +x phxid_server_linux_x64_version.sh
  3. sudo ./phxid_server_linux_x64_version.sh to start installation
  4. On the screen “Welcome to the PhenixID service Setup Wizard”, click Next
  5. On the screen “License Agreement”, read the license agreement and select “I accept the agreement”, then click Next
  6. On the screen “Select Destination Directory”, click Browse… to select installation location or accept the default destination directory (/opt/PhenixID/Server), then click Next
  7. On the screen “Select License File”, click Browse… to locate and select your license file, then click Next
  8. On the screen “System administrator”, enter default system administrator and password, then click Next. This user is the one used to access the configuration application. Please note that no other characters than A-Z, a-z and 0-9 are recommended.
  9. On the screen "Enter an encryption key", set an encryption key used for encrypting persistent data such as token keys, then click Next. IMPORTANT NOTICE - If this is a single node or the first node in a cluster the encryption key can be anything. But if this node is to be joined into an already existing cluster the key MUST be the same on all nodes. Please note that no other characters than A-Z, a-z and 0-9 are recommended.
  10. On the screen “HTTP port”, enter the port you like the administration UI to start on, e.g. 8443, then click Next.
  11. Next screen is "Virtual machine settings". If the installation is being done in an virtual environment, please check the box "I am installing on a virtual machine", then click Next.
  12. On the screen “Completing the PhenixID service Setup Wizard”, click Finish to end the Setup.

 Install PhenixID on LINUX using COMMAND LINE INTERFACE (CLI)

For install on Linux using X, see previous section

  1. Open a terminal
  2. Type chmod +x phxid_server_linux_x64_version.sh
  3. sudo ./phxid_server_linux_x64_version.sh -c to start installation
  4. “This will install PhenixID service on your computer”. Press Enter to continue
  5. “License Agreement”, read the license agreement, scroll by pressing Enter and select “I accept the agreement”, by pressing 1 and Enter to continue
  6. “Where should PhenixID service be installed” Enter path to installation location or accept the default location (/opt/PhenixID/Server), then press Enter
  7. “Select License File”, Enter file path and name of your license file, then press Enter to continue.
  8. "System administrator", enter default system administrator. This user is the one used to access the configuration application. Then press Enter
  9. "Password", enter a password for the system administrator set in previous step, then press Enter. Please note that no other characters than A-Z, a-z and 0-9 are recommended.
  10. "Enter an encryption key", set an encryption key used for encrypting persistent data such as token keys. IMPORTANT NOTICE - If this is a single node or the first node in a cluster the encryption key can be anything. But if this node is to be joined into an already existing cluster the key MUST be the same on all nodes. Then press Enter. Please note that no other characters than A-Z, a-z and 0-9 are recommended.
  11. “HTTP port”, enter the port you like the administration UI to start on, e.g. 8443. Press Enter to continue
  12. "Virtual machine settings". If the installation is being done in an virtual environment, answer yes and press Enter. If not, just press Enter
  13. Installation is complete

Cluster installation

How clustering works and is configured is described in detail in a separate document which can be found here.

Post Installation

Please continue with the post-installation tasks that are described in a separate document which can be found here.