Internal documentation only
This page has been marked as draft.
[INTERNAL] Geneos - How to generate a CorvilNet or Ultra Messaging Licence
The CorvilNet integration is documented at https://docs.itrsgroup.com/docs/geneos/current/data-collection/corvilnet.html
The Ultra Messaging integration is documented at https://docs.itrsgroup.com/docs/geneos/current/data-collection/ultra-messaging.html
Generating a licence requires the use of lic_gen and a template. The generated licence can then be checked using lic_chk. The process is performed via command line.
Step 1 Copied
Download the following files from the attachment section of this article
lic_genlic_chkgeneos-cnpi.lic.tplt(CorvilNet)geneos-umpi.lic.tplt(Ultra Messaging)
Step 2 Copied
Move all the files and change into the directory:
mkdir -p /opt/itrs/packages/corvilnet
mv lic_gen lic_chk geneos-cnpi.lic.tplt geneos-umpi.lic.tplt /opt/itrs/packages/corvilnet
cd /opt/itrs/packages/corvilnet
Make the files executable:
chmod a+x lic_gen
chmod a+x lic_chk
Step 3:
The template files are structured as follows:
CorvilNet Template
Organisation: Organisation Name
Licensee: Licensee Name
Product: CNPI
Expiry: YYYY-MM-DD
Ultra Messaging Template
Organisation: Organisation Name
Licensee: Licensee Name
Product: UMPI
Expiry: YYYY-MM-DD
The Product details do not need to be changed as long as you edit the correct template.
Edit the appropriate template file and add the details for parameters Organisation, Licenseeand Expirydate. For example:
CorvilNet Example
vi geneos-cnpi.lic.tplt
i
Organisation: ITRS
Licensee: Shona Lowden
Product: CNPI
Expiry: 2020-10-31
Esc
:wq!
Step 4:
Generate the licence using lic_gen, providing the template and the output file name. For example:
CorvilNet Example
./lic_gen geneos-cnpi.lic.tplt geneos-cnpi.lic
In this example for a CorvilNet licence, the file geneos-cnpi.lic is what you would provide to the client. For Ultra Messaging, you would provide geneos-umpi.lic.
Check the validity and formatting of the generated licence using lic_chk, providing the Productname and licence file. For example:
CorvilNet Example
./lic_chk CNPI geneos-cnpi.lic
You will see output similar to the following:
CorvilNet Example
[slowden@localhost corvilnet]$ ./lic_chk CNPI geneos-cnpi.lic
2019-10-31 10:27:50.625 [lic_chk] INFO: checking product CNPI can be licensed by geneos-cnpi.lic
2019-10-31 10:27:50.625 [lic_chk] INFO: licensee: Shona Lowden
2019-10-31 10:27:50.625 [lic_chk] INFO: licensed organisation: ITRS
019-10-31 10:27:50.625 [lic_chk] INFO: expires Sat Oct 31 23:59:59 2020
2019-10-31 10:27:50.625 [lic_chk] INFO: licence file OK for product CNPI
[slowden@localhost corvilnet]$
Step 5:
Provide the licence (geneos-cnpi.lic or geneos-umpi.lic) to the client.
Update the Corvil and Ultra Messaging Licences spreadsheet on Sharepoint for tracking purposes.