How to Install the Store and Forward Server

  • Document ID:KM03765034
  • Creation Date:26-Nov-2020
  • Modified Date:26-Nov-2020
    • Micro Focus Products:
      universal cmdb 2019.11

Summary

Procedure to Install the Store and Forward Server in Universal CMDB 2019.11

Question

This task describes how to install the Store and Forward server.

Perform this task for each computer that you want to use as a Store and Forward server.

Answer

  1. Prerequisites

    • Scanners are deployed in Manual Deployment mode.

    • Scanners are configured to save scan files offsite. For more information, see Scanner Options Page.

  2. Copy the installation package

    Note Ensure that you copy installation files that are appropriate to the platform of the computer that you want to install the Store and Forward server.

    Windows:

    From the UCMDB server, copy the MSI installation file from the following location to the computer that you want to install the Store and Forward server:

    UCMDB\UCMDBServer\tools\InventoryDiscovery\StoreAndForward

    Linux:

    From the UCMDB installation DVD, copy the ud-store-and-forward-linux-x86-10.30.000.xxx.tar installation file to the computer where you want to install the Store and Forward server.

  3. Install the Store and Forward server

    Windows:

    1. Double-click the MSI file. The main page of the installation wizard displays.
    2. Navigate through the wizard. For more information about the wizard, see Store and Forward Installation Wizard.

    Linux:

    1. Run the following command to decompress the archive file: tar -xzf <FileName>.tar.gz

    2. Run the following command to switch to root user if not logged in as root already: su root

    3. Run the following commands with root privileges to configure parameter values: ./configure

      Note The installation directory must be the current directory when you run this command.

    4. Enter the following information when prompted:

      1. The TCP port that you want to use for the Store and Forward server service. The default is 5005.
      2. The username that you want to use to authenticate to the web server that is hosting the Store and Forward status page. The default is hpud.
      3. The password that you want to use together with the username to authenticate to the web server that is hosting the Store and Forward status page. This field is mandatory.
      4. The communication protocol that you want to use between Store and Forward servers. Enter 1 for HTTP (plain) or 2 for HTTPS (secure).

    5. Start the service by running the following command with root privileges: /etc/init.d/hpudsaf start

  4. Copy certificate files from upstream servers

    Note This step is only applicable if the HTTPS (secure) communication protocol is used.

    1. Copy the server.crt files of each upstream server to the computer that you are installing the Store and Forward server. An upstream server is a server that you are forwarding scan files to. This file is stored in the <DataDir>\Cert directory. For Windows, <DataDir> is configured in Install the Store and Forward server. For Linux, <DataDir> is the data folder in the directory where you installed the Store and Forward server in Install the Store and Forward server.
    2. Rename each upstream server certificate file so that all files have unique names. For example, server1.crt, server2.crt.
    3. Concatenate all the certificate files from upstream servers into one file. Separate each upstream server file with plus (+) signs. To do this, run the following command with root privileges: copy /b <server1.crt> + <server2.crt> + <server3.crt> trustedcerts.crt. A file named trustedcerts.crt is created.
    4. Copy the trustedcerts.crt file to the <DataDir>\Cert directory of the computer that you are installing the Store and Forward server.

    Note If the host name of any upstream server changes, perform this step again.

  5. Configure the system behavior

    Update the config.ini file to control the behavior of the Store and Forward server.

    • The config.ini file is contained in the following location:

      • Windows: The conf folder that is contained in the directory where you installed the Store and Forward server.
      • Linux: The conf folder that is contained in the directory where you installed the Store and Forward server.

    To see parameters that are available to update, see Store and Forward Resources.

    Note If you make changes to the configuration file, restart the Store and Forward server. For more information, see Results.

  6. Results

    • The Store and Forward server service and the Apache web server service start automatically when the computer is started. For more information on names of services, see Store and Forward Resources.

    • To verify the system is operating as expected, go to the following web page on each Store and Forward server to view operating statistics: http://<StoreAndForwardServer>:<port>/server_status.xml

    • Note If the HTTPS communication protocol is used, type HTTPS instead of HTTP.

  7. Additional operations

    To throttle the upload bandwidth, perform the following:

    1. Locate the http.conf file in the installation folder where you installed the program files.
    2. Locate the following line: safbwInputLimit 0
    3. Change 0 to any non-zero integer to specify the maximum bandwidth (in kilobytes)