Request and Load Process Runner License in Citrix Environment

Note: This section is valid only if you are using the legacy license model.

This section explains how to request and install Process Runner in the Citrix environment.

Various licensing solutions are available for the Citrix environment, depending on the requirements of the users. For requesting a license or queries related to the license, email to mag-innoweralicense@insightsoftware.com. The following are the different types of licenses available and instructions for installing them.

Seat License

Seat licenses are licenses for individual users locked to their Windows User ID. Typically, the following two scenarios exist when working with seat licenses in the Citrix environment.

• 1-5 users

Copy the license file to the My Document\Innowera\Lic XL folder of the user. If the Innowera\Lic XL folder is not found in the My Documents folder of the user, create the folder manually or execute Process Runner again.

• More than 5 users

Copy the license files of all the users to the Lic folder in the Process Runner application folder. Usually, the license folder is C:\Program Files\Innowera\Process Runner\Lic. If installed on a 64-bit version of Windows, the application folder is C:\Program Files(x86)\Innowera\Process Runner. Update the LICFOLDER parameter in the LicDiscovery.txt file. The LICFOLDER parameter tells Process Runner where to look for the license files.

Note: The license file name of each user starts with their respective Windows User ID. Do not make any changes to the license file name.

Named and Concurrent/Floating License

Depending on how Process Runner is installed in the Citrix environment, use one of the following methods to install Process Runner concurrent licenses. In the first method, all the users are either designer or run-only users. In the second method, some are designer users, while some are run-only users.

• Designer or run-only users

  Copy the license and ProR.Lic files to the Process Runner application folder.

• Some users are designers, and some users are run-only users

  Copy all the license files to the Lic folder in the Process Runner application folder. Usually, the license folder is C:\Program Files\Innowera\Process Runner\Lic. If installed on a 64-bit version of Windows, the application folder is C:\Program Files(x86)\Innowera\Process Runner. Update the following parameters in the LicDiscovery.txt file as required, depending on the license type you have.

Set the following parameters for named licenses:

• LICFOLDER: Indicates the location of license files.
• DESIGNER_NAMED_USERID: Lists the named designer users (Windows user ID without domain) separated by a comma.
• RUNONLY_NAMED_USERID: Lists the named run-only users (Windows user ID without domain) separated by a comma.
• DESIGNER_NAMED_LICENSE: Indicates the license file name for the designer named user copied in the folder as specified in the LICFOLDERparameter.
• RUNONLY_NAMED_LICENSE: Indicates the license file name for the run-only named user copied in the folder as specified in the LICFOLDER parameter.

Set the following parameters for concurrent or floating licenses:

• LICFOLDER: Indicates the location of license files.
• DESIGNER_FLOATING_USERID: Lists the floating or concurrent designer users (Windows user ID without domain) separated by a comma.
• RUNONLY_ FLOATING _USERID: Lists the floating or concurrent run-only users (Windows user ID without domain) separated by a comma.
• DESIGNER_ FLOATING _LICENSE: Indicates the license file name for the designer floating user copied in the folder specified in the LICFOLDER parameter.
• RUNONLY_ FLOATING _LICENSE: Indicates the license file name for the run-only floating user copied in the folder specified in the LICFOLDER parameter.

License Discovery File

LicDiscovery.txt helps manage the license deployments for multiple Process Runner users without individual users needing to manage the license on their own. Process Runner reads the LicDiscovery.txt file parameters and allocates an appropriate license to the user. The file is found in the application folder of Process Runner. Generally, it is C:\Program Files\Innowera\Process Runner. If installed on a 64-bit version of Windows, the application folder is C:\Program Files (x86)\Innowera\Process Runner.

The license discovery file is as shown in the following screenshot.

The license file consists of the following sections:

• License folder: Indicates the path of the folder where Process Runner looks for .license files at runtime. The path is specified using the keyword LICFOLDER. For example, LICFOLDER=[APPFOLDER]\LIC

  In this example, the discovery file looks for .license file in the LIC folder that is in the Application folder. Usually, the application folder for Process Runner is C:\Program Files\Innowera\Process Runner. If installed on a 64-bit version of Windows, the application folder is in C:\Program Files (x86)\Innowera\Process Runner.

  Note: [APPFOLDER]\LIC is the default path set for License folder.

• Default license file: Indicates the name of the default license file in DEFAULT_LICENSE. At run time, Process Runner looks for this license file in the license folder as specified in the LICFOLDER parameter. For example, DEFAULT_LICENSE=DefaultRunOnlyUser.License

  Note: This is an optional parameter. If you do not want to provide access of Process Runner to any anonymous user, you can skip this step.

• Addition of users based on type of use: Four different types of groups are available based on license types. The groups are as follows:
  • Designer named license group: Includes Windows User ID of users that uses designer license for Process Runner. Generally, the seat or named licenses are locked to Windows user IDs, system ID, domains, or any of these. Specify all the Windows user IDs in this group whose Windows IDs are included in the designer license file. For example, DESIGNER_NAMED_USERID= jsmith1, ptally.

    Enter the Windows user ID without a domain name and separated by a comma for multiple users. You must specify the designer license file name in the DESIGNER_NAMED_LICENSE section of the discovery.txt file.

  • Run-only named license group: Includes Windows User ID that uses ru- only license for Process Runner. Generally, the seat or named licenses are locked to Windows user IDs, system ID, domains, or any of these. Specify the entire Windows user ID in this group whose windows ID are included in the run-only license file. For example, RUNONLY_NAMED_USERID= parker, andyj.

    Enter the Windows User ID without a domain name and separated by a comma for multiple users. You must specify the run-only license file name in the RUNONLY_NAMED_LICENSE section of the discovery.txt file.

  • Designer floating license group: Includes Windows User ID that uses designer floating license for Process Runner. For example, DESIGNER_FLOATING _USERID= swill, Wilson.

    Enter the Windows user ID without a domain name and separated by a comma for multiple users. You must specify the designer floating license file name in the DESIGNER_FLOATING_LICENSE section of the discovery.txt file.

  • Run-only floating license group: Includes Windows User ID that uses run only floating license for Process Runner. For example, RUNONLY_FLOATING_USERID= anna, tjames.

    Enter the Windows user ID without a domain name and separated by a comma for multiple users. You must specify the designer run-only license file name in the RUNONLY_FLOATING_LICENSE section of the discovery.txt file.

• Mapping license file to groups: Depending on the different types of groups you have in your organization, you must map the license file to the groups.
  • Designer Named license file name: Indicates the license file name that must be specified in the DESIGNER_NAMED_LICENSE section of the discovery.txt file. This license file now gets mapped to users belonging to the designer named license group. For example, DESIGNER_NAMED_LICENSE=designernamed_accompany.license
  • Run-only Named license file name: Indicates the license file name that must be specified in the RUNONLY_NAMED_LICENSE section of the discovery.txt file. This license file now gets mapped to all users belonging to the run-only named license group. For example, RUNONLY_NAMED_LICENSE=runonly_accompany.license
  • Designer floating license file name: Indicates the license file name that must be specified in the DESIGNER_FLOATING_LICENSE section of the discovery.txt file. This license file now gets mapped to all users belonging to the floating designer group. For example, DESIGNER_FLOATING_LICENSE =designerfloating_accompany.license
  • Run-only floating license file name: Indicates the license file name that must be specified in the RUNONLY_FLOATING_LICENSE section of the discovery.txt file. This license file now gets mapped to users belonging to the run-only floating license group. For example, RUNONLY_FLOATING_LICENSE =runonlyfloating_accompany.license