Up to Docs
Contents

Installing a new License

Once you have determined the size of your network topology; specifically the number of active Internal IPs – you will have to procure a Trisul License file. This document talks about how you can go about installing the file.

Issuing a new LicenseTop

After we determine the type of license you will require, we need one additional piece of information from you. The machineid which uniquely identifies the server or VM on which you are running Trisul.

Type the following command as send us its output when requesting a license.

Run the following command as root

trisul --machineid

This will give you a string which we need to issue the license. The string looks like this :

[root@localhost ~]# trisul --machineid
4087ACCD-4B0B-DE11-833A-00248CB93BDE
[root@localhost ~]#
If you move Trisul to a new machine or VM, send us the new machineid and we will reissue the License.

Installing the License.xyz.txt fileTop

Once we get the machineid, a new License file is issued to you. The file is typically named License.{emailid}.txt

To install this file :

  1. Stop the Trisul server
  2. Replace or add the new license file in /usr/local/etc/trisul
    1. Replace → Change the name of the new file to License.txt OR
    2. Install → Edit the LicenseFile parameter in trisulConfig.xml to point to the new file
  3. Start the Trisul server

Check if the License installed correctly

View the License file in effect

Go to Admin → Licensing

Make sure you see your new license details here. It contains your email id.

Check Logs

Go to Admin → View Logs

Enter “License” in the Filter box and select Main Server Log. This will show you all log messages with the text license in them.

If everything went well, you should see successful license messages like this :

 
Fri Sep 30 01:24:47 2011.485739 DEBUG LICENSE: Trisul licensed to User: <redacted>
Fri Sep 30 01:24:47 2011.485875 INFO  LICENSE: Trisul license  Mode: PRODUCTON;UNLIMITED-DAYWINDOW;UNLIMITED-PCAP;RSNTW;INTERNAL_NODES=UNLIMITED
Fri Sep 30 01:24:47 2011.486033 INFO  LICENSE: Trisul license to machine id <redacted>
Fri Sep 30 01:24:47 2011.486190 INFO  LICENSE: Max INTERNAL_NODES = -1