Installing Uniface on Unix and Linux

The Uniface installation program and related files are provided in a .tar file. After extracting the file you can run the Uniface installer.

Ensure that you:

  • Download the .tar file containing the Uniface installation program and extract it using the command tar xvf. For DLM licensing, it includes the Distributed License Manager (DLM).
  • If using DLM licenses, install the Distributed License Manager (DLM).
  • If using RMS network licenses, install the Sentinel Rights Management System (RMS) License Manager.
  • If installing Uniface on Linux with Sentinel cloud-leased Licenses, ensure you have root privileges. Otherwise, a warning is displayed and you will have to manually configure licensing.

For platform requirements, .tar file names, and extraction instructions, refer to the readme.txt file.

The Uniface installer displays a number of screens to guide you through the rest of the installation process for Uniface. In any screen, you can press F3 to exit the installation process. On most of the other screens, you can press F12 to return to the previous screen.

  1. Run the installer install.sh for your platform:

    /uniface/Platform/install.sh, where Platform is a three-letter mnemonic for your platform (for example, hp9, rs6, or sl7).

  2. Specify the directory where you want to install Uniface.
  3. Select the components to be installed.
  4. Select the character set or code page appropriate for your language.
  5. Enter the TCP/IP port number to which the Uniface Router (urouter) should listen.

    The default value is 13001, which causes the urouter to start listening at port 13001.

  6. Specify the first TCP/IP port number to which the Tomcat Web Server should listen.

    You only need to specify the first port number, although four consecutive port numbers will be assigned. The installer checks whether the default port numbers are already in use and suggests the next available port numbers. You can enter alternative values or press Enterto accept the defaults.

  7. Specify the type of license you will be using. Choose one of:
    • I have an Entitlement ID (Cloud Standalone Licensing)–this option is only available on Linux
    • I have the address of an RMS Server (Network License)
    • I have a local license file (On-premises Standalone Licensing)
    • I will configure manually later, or use DLM

    Depending on your choice, you are then prompted to enter the location of the license file or the license server address(es), or a Sentinel Entitlement ID.

    If you are not running with root privileges, the installer automatically selects the option to skip Sentinel configuration so that you can do it manually after installation completes.

  8. A confirmation screen reports the components that will be installed. Press Enter to continue.

    The installer creates and copies the required directories and files, and creates default assignment files. As it runs, the installer displays progress messages on the screen and also writes progress and any error messages to the file install.err.

    You should see the word Done after each of the installer’s progress steps, indicating that it has been successfully completed. If there was a problem at any stage, look in the install.err file for details.

  9. The installer then automatically configures the license environment. If I will configure manually later, or use DLM was selected, a warning is displayed saying you need to prepare and configure licensing manually.

    For more information about configuring your license settings, see $LICENSE_OPTIONS for Sentinel licenses, or $LICENSE_OPTIONS (DLM).

Related Topics