Steps to update report server licenses

Owned by Mrunalini Potnis
Jul 29, 2019
2 min read

The QMetry Reports include an external license. To update this license follow the steps below depending on your reports installation type - docker / non-docker.

Steps for reports installation with docker

  1. QMetry Support will provide the below files :

    • Reports Application License: lgx120102.lic
    • Visual Analysis Reports Zip: LicenseUpgrade.zip
  2. Copy the license file "lgx120102.lic" and "LicenseUpgrade.zip" received to /opt directory on your server. These files need to be copied to the reports dockers.
  3. Run command : docker ps to see the report docker containers.
  4. Copy files to docker using below commands : 
    1. cd /opt 
    2. docker cp lgx120102.lic qmetryreport85_report_1:/opt
    3. unzip LicenseUpgrade.zip
    4. cd LicenseUpgrade
    5. docker cp lgx030502.lic qmetryreport85_discovery_1:/opt
    6. docker cp license_upgrade.sh qmetryreport85_discovery_1:/opt

Step 1 : Updating report application license in tomcat

  • Stop tomcat services
    • docker exec -it qmetryreport85_report_1 bash                               
    • cd /opt/tomcat/bin
    • sh shutdown.sh
  • Copy the license file into tomcat using below commands
    • cd /opt
    • cp  lgx120102.lic /opt/tomcat/webapps/ROOT
  • Start tomcat services
    • cd /opt/tomcat/bin
    • sh startup.sh
    • exit

Step 2 : Updating the visual analysis reports license

  • docker exec -it qmetryreport85_discovery_1 bash
  • cd /opt
  • sh license_upgrade.sh
  • exit

Step 3: Verify if the license is updated correctly

  • Login to the datahub using your report server URL: https or http://<ReportIP OR DNS>:3000/datahub
    • Use below credentials : username : admin , password : logi@123 
  • Access the URL and verify the expiration date : https or http://<ReportIP OR DNS>:3000/api/platform/system.licenses

Steps for reports installation without docker

QMetry Support will provide the below files :

  • Reports Application License: lgx120102.lic
  • Visual Analysis License: lgx030502.lic

Copy the license files "lgx120102.lic" and "lgx030502.lic" received to /opt directory on your server.

Step 1 : Updating report application license in tomcat

  • Stop reports tomcat services
    • sudo su
    • cd /opt/tomcat/bin
    • sh shutdown.sh
  • Copy the license files
    • cp /opt/lgx120102.lic /opt/tomcat/webapps/ROOT/
  • Start reports tomcat services
    • cd /opt/tomcat/bin
    • sh startup.sh

Step 2 : Updating the visual analysis reports license

  • Stop visual analysis reports services
    •  cd /opt/LogiPlatformServices/platform/bin
    • ./logiDiscovery.sh stop
  • Delete and update license credentials using below commands
    • ./licenseTool.sh deletelicense --license-id=lgx030502 --user=admin --password= logi@123
      • Note : Make sure only the license file name is specified, without its extension. For example, to delete the SSM v12.5 license, you specify license-id=lgx030502
    • ./licenseTool.sh createlicense --inputfile=/opt/lgx030502.lic --user=admin --password= logi@123
  • Start visual analysis reports services
    • cd /opt/LogiPlatformServices/platform/bin
    • ./logiDiscovery.sh start
    • exit

Step 3: Verify if the license is updated correctly

  • Login to the datahub using your report server URL : https or http://<ReportIP OR DNS>:3000/datahub
    • Use below credentials : username : admin , password : logi@123 
  • Access the URL and verify the expiration date : https or http://<ReportIP OR DNS>:3000/api/platform/system.licenses