Prepare OPLA for the first use
The OPLA is located in the the OPLA directory of the CSDK package. It is a central licensing solution so it can run on any computer in the network. Any number of CSDK workers can connect to it on the same network.
OPLA communicates through the following interfaces:
-
Web interface: Browser based UI for managing licenses and configuring OPLA
-
Command line interface: Local command-line interface for managing licenses and configuring OPLA
-
Status API: HTTP based interface to monitor licensing status programmatically. It can be accessed on the following URL:
http://{MY_SERVER}:5000/Api/Licenses/ListLicenses?StatusServiceKey=<My license key>
-
CSDK inteface: a TCP socket where CSDK communicates with OPLA for licensing, entitlement, and usage reporting.
-
Activation Server: The global portal where licenses can be obtained and activated.
- Copy the whole OPLA directory to any location on the selected central licensing computer.
-
Open and configure the appsetting.json file.
This file represents OPLA side of the connection. It contains the following information:
Table 1. Parameters of the appsettings.json file Parameter Description Default value Port The TCP port for the CSDK interface. Verify that this port is not occupied by other applications.18019 WebPort The TCP port for the web interface. Verify that this port is not occupied by other applications.5000 ApplicationDataFolder The location where OPLA stores its information on the system. {ProgramDataFolder}\OmniPage\LicensingAgent ReportFolder The location where OPLA saves report files Regularly backup this folder. It can be required for support cases.{ApplicationDataFolder}\Reports LogFolder The location where OPLA creates log files {ApplicationDataFolder}\Log LogLevel Level of logging. The supported values are ERROR, WARN, and INFO.
The INFO log level can significantly affect performance.WARN StatusServiceKey This key needs to be set to enable Status API. N/A SSLWebPort The TCP port for HTTPS Web interface.
If this parameter is set, remote connection to the web interface is allowed only through HTTPS connection.
Verify that this port is not occupied by other applications.N/A SSLPfx The location of the SSL certifiacte PFX file for HTTPS connections. N/A SSLPassword The password of the given SSL certificate PFX file. N/A -
Register the OPLA as a Windows service with the following command:
opla service -register
-
Start OPLA with the following command:
Opla.exe Service -start
-
If you want to use the web interface of the OPLA, create a user.
The OPLA WEB interface is available by default at http://localhost:5000.
The first user can be created on the web interface at the first time or from command line with the following command:
Opla.exe User -create -username="<admin@mycompany.com>" -password=<mypassword>
You can use OPLA to perform the following actions:
-
Activate license:
Licenses must be activated and downloaded from the activation server. If the computer, where OPLA runs, has access to the Activation Server, the OPLA connects to the activation server automatically. If the computer, where OPLA runs, does not have access to the Activation Server, the OPLA generates an ActivatePackage.lcxp file, which has to be activated on the Activation Server website.
-
Through web interface:
Activate license in OPLA, using the web interface, online mode
Activate license in OPLA, using the web interface, offline mode
-
Through command line interface
Activate license in OPLA, using the command line interface, online mode
Activate license in OPLA, using the command line interface, offline mode
-
-
Move license:
-
Through web interface:
-
Through command line interface
Move license in OPLA, using the command line interface, online mode
Move license in OPLA, using the command line interface, offline mode
-