Installing the License Service

TIBCO OpenSpirit License Service install kits are available for download from the same location used to download the TIBCO OpenSpirit Runtime install kits. The installers are provided as self-extracting executable files. The Linux installer is a self-extracting shell script that has a .bin file name extension. The Windows installer executable has a .exe file name extension. The installer extracts files into your system's temp directory and then runs the install application from the extracted files.

Installation requires a graphical display. A DISPLAY environment variable must be set to a valid X Windows display in order to run the OpenSpirit installer on Linux. Windows installation requires a Windows desktop display. The install steps are identical on Windows and Linux.

Note: Any account can be used to install the service on Linux. The account used to install on Windows must have permissions to register and start a Windows service. The license service is configured to run as a Windows service under the Local System account.

The following installation panel images were taken during a Windows installation. The installation steps and installer panels are identical on Linux other than an additional message display panel that appears near the end of the installation on Linux.

Introduction

The introduction panel is the first panel displayed by the installer. It provides instructions on use of the Cancel, Previous, and Next buttons at the bottom of the install panels.

Click the Next button to proceed to the next step in the installation process.

Choose Install Folder

The install folder selection panel is used to select the file folder that the OpenSpirit software is installed in. Click the Choose Button to open a folder selection window to navigate to the folder you would like to install the license service software into if you do not want to install into the default location. You can also type the folder location directly into the text entry field or you can paste a folder path in using the system copy/paste clipboard.

Tip: The folder selection Windows displayed by clicking the Choose... button have a different appearance depending on the operating system platform the installer is running on. Note, a folder creation button is provided in the upper right corner of the folder selection window if you would like to create a folder to install under.

Click the Next button to proceed to the next step in the installation process after selecting the installation folder.

Choose a License File

Select the license file that contains your OpenSpirit license features. See the Obtaining a License File section above for information about obtaining the license file.

Tip: Choosing a license file is not mandatory when installing on Linux. A license file must be chosen when installing on Windows because the license service configured as a Windows service, which is started at the completion of the installation procedure. The license server fails to start if it does not have a license file.

Make sure that the SERVER line in the license file contains the correct host name and the port you want to use for the license service. The license file can have any file name and can be located anywhere. The installer creates a copy of the file and places it in the required directory as file name license.dat.

Click the Next button to proceed to the next step in the installation process.

Preinstallation Summary

The preinstallation summary panel shows where the license service software is installed. It also shows the amount of disk space that is required to complete the installation. The required disk space is an estimate made by the installer.

Review the information shown in the summary to make sure it matches your expectations. Click the Previous button if you would like to go back and change any of the information entered in prior panels.

Click the Next button to proceed with the installation process after verifying your choices.

Installing

The installing panel is displayed while the files and folders are being created by the installer. A progress bar is shown at the bottom of the panel. This phase of the installation may take a few minutes depending on your system's file system performance.

The installer will advance to the next panel automatically when the file installation phase completes.

Information

The information panel appears when installing on Linux. This panel does not appear when installing on Windows. This panel informs you about a script that can be used to start the license service.

Click the Next button to proceed to the last step in the installation process.

Install Complete

The install complete panel appears when the files have all been installed. The complete panel reminds you the folder that the software has been installed in.

Click the Done button to exit the installer. The installation is complete, so the option to cancel or to return to the previous panel are not enabled.

The license service must be started using the provided run script if the service was installed on Linux. The license service is started for you when installing on Windows.