A.5.2.1 Non-VEDSR Mediation and Application Guest Upgrade

This procedure updates the Mediation and Application guests in a non-VEDSR system.
  1. Log in to the PMAC server as the admusr user.
    ssh <PMAC IP address>
    login as: admusr
    password: <enter password>
  2. If an fdc.cfg file exists in /var/TKLC/smac/guest-dropin, rename the file to fdc.cfg-old.
    The contents of the file are referenced in step 4.
  3. Copy the fdc.cfg file to the pmac guest-dropin directory using the following command:
    sudo cp /usr/TKLC/smac/html/TPD/mediation-*/fdc.cfg/var/TKLC/smac/guest-dropin
  4. Edit the fdc.cfg file for the Mediation and Application guest installation.
    To breakdown the fdc.cfg file parameters, see Appendix Y. Update the software versions, hostnames, bond interfaces, network addresses, and network vlan information for the Mediation and Application guests being installed. The old fdc.cfg file saved in step 2 can be used as a reference for obtaining the hostnames, bond interfaces, network addresses, and network vlan information. Do not copy the software versions from the old fdc.cfg file.
  5. Run the FDC creation script using the config file created in step 4.
    $ cd /var/TKLC/smac/guest-dropin
    $ /usr/TKLC/smac/html/TPD/mediation- x.x.x.x.x_x.x.x - x86_64/fdc.sh fdc.cfg
    1. Rename the fdc.cfg file as required.

      Note:

      Note that two files are generated by the fdc shell script. One is for the installation procedure and the other file is used for the upgrade procedure. The upgrade FDC is named upgrade.
  6. To reset the guest creation timeout, enter the following command to reset the guest creation timeout value.
    $ sudo sqlite3 /usr/TKLC/plat/etc/TKLCfdconfig/db/fdcRepo.fdcdb 'update params set value=3000
    where name="DEFAULT_CREATE_GUEST_TIMEOUT"';
    1. Increase timeout values (workaround to be applied in PMAC before starting the installation):
      sudo pmacadm setParam --
      paramName=defaultTpdProvdTimeout --paramValue=120
      sudo pmacadm setParam --
      paramName=guestDiskDeployTimeout --paramValue=50
  7. Log in to PMAC using a web browser, navigate to: <pmac ip address>.
    1. Log in as guiadmin user.
  8. To remove existing Application server, navigate to Main Menu and then VM Management.
    1. Select the Application guest.
    2. Click Delete.
  9. To remove existing Mediation server, navigate to Main Menu and then VM Management.
    1. Select the Mediation guest.
    2. Click Delete.
  10. To establish SSH session and login, use an SSH client to connect to the PMAC:
    ssh <PMAC IP address>
    login as: admusr
    password: <enter password>
  11. To reinstall the Mediation and Application servers, execute the following command using the upgrade file:
    sudo fdconfig config --file=hostname-upgrade_xx-xxxx.xml
    From release 8.0, the installation is archive-based installation. The basic installation procedure is the same. All the changes happened to the fdc xml script file, so ensure that you generate the fdc xml script file using the fdc.sh and fdc.cfg. See step 5.
  12. To monitor installation, from the PMAC GUI, monitor the IDIH installation on the Task Monitoring page until the installation is complete.
  13. Reconfigure the system
    If upgrading from release 8.0 and later, all application server and mediation server configurations are lost. Follow the customer specific site configuration steps to re-configure the system.
  14. To reset SOAP password, in case upgrading to release IDIH 8.2.1, reset the SOAP password to allow self-authentication of DSR with IDIH to send traces. For more information, see Reset the SOAP Password.