Table of Contents

Installing on Linux

Note

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.

Warning

If getting error message like:

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

You need to install the missing fonts before retrying the installation

Prerequisite

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

Hardware

For hardware requirements, see the Hardware Requirements

Installation

Graphical Installation using X

  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.

Command Line installation

  1. Open a terminal

  2. Type chmod +x phxid_server_linux_x64_version.sh sudo ./phxid_server_linux_x64_version.sh -c to start installation

  3. “This will install PhenixID service on your computer”. Press Enter to continue

  4. “License Agreement”, read the license agreement, scroll by pressing Enter and select “I accept the agreement”, by pressing 1 and Enter to continue

  5. “Where should PhenixID service be installed” Enter path to installation location or accept the default location (/opt/PhenixID/Server), then press Enter

  6. “Select License File”, Enter file path and name of your license file, then press Enter to continue.

  7. "System administrator", enter default system administrator. This user is the one used to access the configuration application. Then press Enter

  8. "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.

  9. "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.

  10. “HTTP port”, enter the port you like the administration UI to start on, e.g. 8443. Press Enter to continue

  11. "Virtual machine settings". If the installation is being done in an virtual environment, answer yes and press Enter. If not, just press Enter

  12. 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.