Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: New --status option for the license server

...

  • If you are not familiar with the installation of RPM packages, please refer to the regular user's guide or your Linux system documentation.
  • You do not need to stop running emulator instance before upgrading the license server.
  • Please refer to the general Charon -SSP user's guide for information on how to upgrade the Charon -SSP emulator software.

To upgrade the license server package, perform the following steps (SFTP is used as a sample file transfer method):

  1. Use sftp to connect to the cloud license server instance.
    # sftp -i ~/.ssh/<mykey>  <user>@<cloud<user>@<linux-instance-ip>
    where
    1. <mykey> is the private key of the key-pair you associated with your cloud instance
      (not needed for on-premises VMware installations that allow logins with username/password)
    2. <user> is the user associated with your
    cloud
    1. license server instance (e.g., opc on OCI,
    or
    1. centos for a CentOS instance on AWS, or the custom user of your VMware virtual machine;
      for an instance installed from a prepackaged Charon-SSP VE marketplace image, use the SFTP user charon)
    <cloud-instance
    1. <linux-ip> the ip address of your
    cloud instance
    1. license server system

  2. Copy the software package to the cloud instance license server system using the following sftp command:
    > put <local-path-to-license-server-package>

  3. Use ssh to log in on the cloud instancelicense server system.
    # ssh -i ~/.ssh/<mykey> <user>@<cloud-instance <user>@<linux-ip>
    1. <mykey> is the private key of the key-pair you associated with your cloud instance
      (not needed for on-premises VMware installations that allow logins with username/password)
    2. <user> is the user for interactive login associated with your
    cloud
    1. license server instance (e.g., opc on OCI,
    or
    1. centos for a CentOS instance on AWS, or the custom user of your VMware virtual machine;
      for an instance installed from a prepackaged Charon-SSP VE marketplace image, use sshuser)
    <cloud-instance
    1. <linux-ip> the ip address of your
    cloud instance
    1. license server system

  4. As a privileged user (root) go to the directory where you stored the installation package and update the package. If you used the VE image and copied the file using SFTP to user charon, the file will be in the hierarchy under /charon/storage.
    1. Become the root user:          # sudo -i
    2. Go to the package location:   # cd <path-to-package-directory>
    3. Install the package:             
      1. Linux 7.x: # yum update license-server*.rpm
      2. Linux 8.x: # dnf update license-server*.rpm

Normally, the license server will restart and continue to work normally. To check the status, perform the following steps:

  • Look at  at the content of the license server log in : /opt/license-server/log/license_.log.
  • Use the ps command to check that the server is running:
    # ps -ef |grep license-server
  • Starting with version 1.1.18, a new parameter to the license server is available to display the license server status:
    # cd /opt/license-server
    # ./license_server -s

About an hour after the installation check the emulator log files of any active instances to verify that no unexpected problem has been caused by the new version.

...