Preparing to Configure a License Server

Continuous IntegrationLicense Management GuideConcurrent BuildsAutomated Builds

Before configuring a license server, the administrator must prepare it for that procedure.

This chapter describes how to:

  1. Deploy a concurrent build license to your myQNX account
  2. Install the concurrent build license server package
  3. Determine your server's host ID and hostname, then email them to QNX

1. Deploy a concurrent build license to your myQNX account

If you have administrator rights to a concurrent build license, follow the steps below. Otherwise, ask your license administrator to deploy a concurrent build license to your myQNX account.

  1. Go to the QNX website (www.qnx.com) and log in to your myQNX account.
  2. Click the Manage Registered Products link (https://www.qnx.com/account/dashboard/) to access the myQNX License Manager.
  3. Deploy at least one concurrent build license development seat to your myQNX account.

    For details on deploying licenses, refer to the myQNX License Manager and QNX Software Center User's Guide.

2. Install the concurrent build license server package

To install the concurrent build license server package:

  1. As an administrative user, install the QNX Software Center on your license server or on a separate staging machine.

    You can download the installer for the QNX Software Center from the QNX website: https://www.qnx.com/download/group.html?programid=29178.

  2. From the Welcome screen of the QNX Software Center, select Add Installation.
  3. Expand the Floating License Server (Windows, Linux) group, then select Floating License Server (Windows, Linux).

    Note:
    To read the package release notes before proceeding with the installation, right-click the package, then select Properties > Release Notes.
  4. Click Next.
  5. Accept the default installation folder, name, and description, or modify them according to your requirements.
    Note:
    The default port number is 27000. You can optionally provide a different port number or change it later in the license file. Refer to the Configuring a License Server That Uses a Firewall (Windows) or VPN Access chapter of this guide.
  6. Ignore the settings for the update policy, debug symbols, experimental packages, and target architectures—they don't apply to the concurrent build license server package.
  7. Click Next.
  8. Make sure that the Floating License Server (Windows, Linux) item is checked, then click Next.
  9. Review the list of packages that the QNX Software Center will install, then click Finish to start the installation process.

    Upon completion of the installation process, the license server package becomes the current installation in the QNX Software Center and appears in the Installed tab.

  10. If you installed the package on a separate staging machine, copy the directory that contains the installed package components to your license server.

    By default, the directory is your_home_directory/flexserver/.

Note:
If you look in the flexserver/docs/ directory, you'll find the FlexNet Publisher License Administration Guide. This guide provides more information on the FlexNet commands (e.g. lmgrd, lmutil) described in this document, as well as information on troubleshooting and error codes.

3. Determine your license server's host ID and hostname, then email them to QNX

  1. Open a shell or command-prompt window.
  2. Go to the QNX_install_dir/flexserver/host/OS/x86_64/usr/bin directory, where OS is the OS used by your license server (either win64 or linux).
  3. Run the following command:
    lmutil lmhostid
  4. Run the following command on the same server:
    hostname -f
  5. Email the host ID, fully qualified domain name (FQDN), and hostname data to licensekeys@qnx.com to obtain a custom server-side license key file. You can also contact your sales representative at QNX.

    In your email, indicate which development seat licenses correspond to the server-side license key file that you're requesting. If all your licenses are to be reflected in this server-side license key file, just give us one of the serial numbers and indicate that all the licenses received in the same shipment should be matched to this license key.

    Your email needs to mention the following:
    • the type of license you are requesting (new, replacement, or upgrade)
    • the number of licenses and the number of servers, as well as intended allocation (for example, two servers and 100 licenses, with 40 licenses to put on server A and 60 on server B)
    • whether you intend to set up three-server redundancy
    Note:
    Keys obtained for a single-server setup cannot be transferred to a triad configuration.

    A QNX representative will reply to your email with a license key file that you need to install on your license server.

  6. After receiving the server-side license key file, continue with the configuration instructions for your license server's host OS.
Page updated: