Request and Load Process Runner Excel Add-in 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 load Process Runner Excel Add-in 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 Excel Add-in again. If you are installing Process Runner Excel Add-in with Process Runner, and the Process Runner license is already successfully activated on the system, the Process Runner Excel Add-in gets activated automatically.

• More than 5 users

Copy the license files (.license) of all the users to the Lic folder in the Process Runner Excel Add-in application folder. Usually, the license folder is C:\Program Files\Innowera\Process Runner Excel Add-in\Lic. If installed on a 64-bit version of Windows, the application folder is C:\Program Files(x86)\Innowera\Process Runner Excel Add-in. Update the LICFOLDER parameter in the LicDiscovery.txt file. The LICFOLDER parameter tells Process Runner Excel Add-in 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 Excel Add-in is installed in the Citrix environment, use one of the following methods to install Process Runner Excel Add-in 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 Excel Add-in 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 Excel Add-in application folder. Usually, the license folder is C:\Program Files\Innowera\Process Runner Excel Add-in\Lic. If installed on a 64-bit version of Windows, the application folder is C:\Program Files(x86)\Innowera\Process Runner Excel Add-in. 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 Excel Add-in users without individual users needing to manage the license on their own. Process Runner Excel Add-in 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 Excel Add-in. Generally, it is C:\Program Files\Innowera\Process Runner Excel Add-in. If installed on a 64-bit version of Windows, the application folder is C:\Program Files (x86)\Innowera\Process Runner Excel Add-in.

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 Excel Add-in 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 Excel Add-in is C:\Program Files\Innowera\Process Runner Excel Add-in. If installed on a 64-bit version of Windows, the application folder is in C:\Program Files (x86)\Innowera\Process Runner Excel Add-in.

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

This is an optional parameter. If you do not want to provide access of Process Runner Excel Add-in 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 Excel Add-in. 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 Excel Add-in. 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 Excel Add-in. 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 Excel Add-in. 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