Add Davra Licence

Instructions for Davra 7 releases after 7.0.172

NOTE: Originally generated licences are misspelled "license.lic" but this process then generates a "licence.json"

On a linux terminal cat your licence file through a base64 encoder:

$ cat license.lic | base64 -w 0 ; echo
TGljZW5zb3I9RGF2cmEgTmV0d29ya3MKTGljZW5zZWU9RGF2cmEKQ29tcGFueT1EYXZyYQpOdW0gRGV2aWNlcz0yMApOdW0gVGVzdHM9MgpFeHBpcmF0aW9uPTIwMTgtNC05CgpTaWduYXR1cmU9MzAyQzAyMTQ2OTkwNDlFMThCOTQzMjUyN0RGRTY1QjY0OTkwRTkwNzk1MkY1NzZFMDIxNDQyNkQyMkNBN0VDQ0FGOEQ2QTQ1MzJCMThFMzFDOTRGMzhGMTMzNDcK7
 

now create a file called licence.json, the json file will have two fields: tenantId and licence. For single tenant on-prem installs the tenantId is always 'ruban'. The output of the command above is to be put into the licence field.

{
    "tenantId": "ruban",
    "licence": "TGljZW5zb3I9RGF2cmEgTmV0d29ya3MKTGljZW5zZWU9RGF2cmEKQ29tcGFueT1EYXZyYQpOdW0gRGV2aWNlcz0yMApOdW0gVGVzdHM9MgpFeHBpcmF0aW9uPTIwMTgtNC05CgpTaWduYXR1cmU9MzAyQzAyMTQ2OTkwNDlFMThCOTQzMjUyN0RGRTY1QjY0OTkwRTkwNzk1MkY1NzZFMDIxNDQyNkQyMkNBN0VDQ0FGOEQ2QTQ1MzJCMThFMzFDOTRGMzhGMTMzNDcK7"
}

Now upload the licence:

    curl -u root:root -X POST --data-binary "@licence.json" -H "content-type: application/json" http://<server ip>:<server port>/api/v1/licence/

Note the credentials above root:root, this is the default root password for a Davra platform, see /wiki/spaces/IARCH/pages/602013724 for details on the root password here.

Note for multi-tenant installs the server ip would be replaced by the address of the tenant e.g. <tenantId>.davra.com and the port can be wither 80 or 443

Update Licence

Same as above except you are going to PUT and include the tenantId at the end of the URL

    curl -u root:root -X PUT --data-binary "@licence.json" -H "content-type: application/json" http://<server ip>:<server port>/api/v1/licence/<tenantId>

If updating an expired licence, you may need to wait a minute or two for changes to take effect.

A basic license.lic

Licensor=Davra Networks
Licensee=GA
Company=GA
Num Devices=120
Num Tests=1000
Expiration=2030-7-27

Signature=302D021412150DAD9C62C8FFE9954609B9D087EEDBA5F7AC0215008E9396C0A77B30AEA858593780784C472FEC7B81

Instructions for Davra 6 releases after 6.0.216

A web UI is in the works for to replace the following steps but for now this is how to apply a licence to RuBAN. 

1. SSH into your Davra server.
2. Include kubectl in your PATH: export PATH=$PATH:/home/davra/Davra/localhost
3. Copy the contents of you license.lic file to your clip board
4. Using kubectl list your pods: kubectl get pods
5. Open a shell to the ruban container within the ruban pod, it will be listed with ruban at the start with some hash codes after it in the name
   1. kubectl exec <name of ruban pod> -i -t -c ruban bash
   2. cat > /var/Davra/RuBAN/database/rubanData/license.lic
   3. paste the licence into the console and press enter
   4. ctrl+c
   5. pkill java

Instructions for RuBAN 6 releases up to 6.0.216

Put your license.lic file onto the RuBAN server and go to the directory it is in

Copy it to the RuBAN directory

cp license.lic /var/Davra/RuBAN/database/rubanData/

Restart RuBAN

docker restart ruban

*NOTE 
You may have to use sudo in your commands if you are not root user

Instructions for RuBAN 5.1

Put your license.lic file onto the RuBAN server and go to the directory it is in

Copy it to the RuBAN directory

cp license.lic /var/Davra/RuBAN/database/rubanData/

Now go to the RuBAN directory

cd /var/Davra/RuBAN/database/rubanData/

Change ownership of the license file to ruban

chown -R ruban:ruban license.lic

Restart RuBAN

service ruban restart

Instructions for RuBAN 5.0 and below

Put your license.lic file onto the RuBAN server and go to the directory it is in

Copy it to the RuBAN directory

cp license.lic /opt/Davra/RuBAN

Now go to the RuBAN directory

cd /opt/Davra/RuBAN

Change ownership of the license file to ruban

chown -R ruban:ruban license.lic

Restart RuBAN

service ruban restart

*NOTE 
You may have to use sudo in your commands if you are not root user