Restoring Usage Metering

Last Updated : Nov 02, 2022 |
Prolog information
Metadata
Keywords:
Install a new copy of the Usage Metering server first, and then restore the system by using the Usage Metering backup file.
If your IT infrastructure uses a proxy server, you have configured the proxy details in the bash_profile file, and you are using root credentials, then run the commands in this procedure without using sudo. If you run the commands by using sudo, Usage Metering Collector installation tries to connect to the cloud services without using the proxy server.
Before you begin
Before restoring the system, check that the latest CentOS or RHEL server is configured with the same hostname as that of the earlier server.
Install the software backup file on a new server that has the same host name.
This procedure restores all certificates.
Caution:
The browser does not connect if the host name of the new Usage Metering server is not identical to the host name of the earlier Usage Metering server.
  1. Open an SSH session to the CentOS or RHEL server on which you want to install and restore Usage Metering.
    ADDITIONAL INFORMATION:
    You can use an application such as PuTTY.
  2. Perform the Usage Metering Collector pre-installation configuration.
    ADDITIONAL INFORMATION:
    For more information, see the Planning and pre-installation configuration section.
  3. Install the man-in-the-middle attack proxy root CA certificate file on the server.
    ADDITIONAL INFORMATION:
    You can use one of the following options:
    • By using the WinSCP software to place the certificate file in the location that you want on the server.
    • By using the following procedure:
      1. Open the web proxy root CA certificate file.
      2. Copy and paste the certificate content into your SSH session.
      3. To install the certificate file, run the following commands in your SSH session:
        sudo yum -y install ca-certificates
        sudo cp proxy-root-ca.pem /etc/pki/ca-trust/source/anchors/
        sudo update-ca-trust
      4. Rename the certificate file according to the .pem format.
        The .pem certificate format must have the following:
        • Plain text
        • Must start with the text, "-----BEGIN CERTIFICATE-----"
        • Must end with the text, "-----END CERTIFICATE----".
  4. To add the Usage Metering Yum repository to your Yum configuration, do one of the following:
    • If you are installing Usage Metering Collector on CentOS 7.x or RHEL 7.x, run the following command in your SSH session:
      sudo curl -o /etc/yum.repos.d/avaya-um.repo \
      https://yum.avaya.com/um-repo/avaya-um.repo
      You can type or copy the entire command on one line.
      Ensure that there is a space before the backslash (\) and no space after the backslash (\) on the first line.
    • If you are installing Usage Metering Collector on RHEL 8.x, run the following command in your SSH session:
      sudo curl -o /etc/yum.repos.d/avaya-um-rhel8.repo https://yum.avaya.com/um-repo-rhel8/avaya-um-rhel8.repo
  5. Run the following command to install Usage Metering Collector and all required dependencies:
    ADDITIONAL INFORMATION:
    sudo yum -y install avaya-usage-metering
  6. Run the following command to specify the stage name of the Usage Metering deployment:
    ADDITIONAL INFORMATION:
    echo "stage=<stage name>" | sudo tee -a /opt/Avaya/usage-metering/um.properties
    The stage name must match the stage name of the Usage Metering system you are restoring.
  7. Run the following command to restart Usage Metering:
    ADDITIONAL INFORMATION:
    um-restart
  8. If your IT infrastructure uses a proxy server, configure the proxy details in the Usage Metering Collector.
    ADDITIONAL INFORMATION:
    For more information, see Configuring non-transparent proxy in the Usage Metering Collector.
  9. In a web browser, type the IP address of the CentOS or RHEL server on which you installed the Usage Metering Collector.
  10. Click through the Self-Signed SSL certificate warning.
    ADDITIONAL INFORMATION:
    You can click Continue to this website (not recommended).
  11. After you read the terms and conditions, select the I accept the terms and conditions in the license agreement check box and click ACCEPT.
  12. On the Create Initial User page, click Restore from backup.
  13. In the Database Restore dialog box, enter the following credentials:
    1. In the AWS Access Key field, type your valid Access key.
    2. In the AWS Secret Key field, type your valid Secret key.
    3. In the Collector ID field, click the ID of the Usage Metering Collector that you want to restore.
    4. Click RESTORE.
      ADDITIONAL INFORMATION:
      After the system validates your credentials, Usage Metering restarts.
      You must refresh the page to log in to Usage Metering.
    5. Click REFRESH.