Update the Host Name and Port Number Using the ant Command

If applicable, you use the operating system (not the ant update-usm-host command) to change the host name. Afterwards, you use the ant command to propagate that host name change throughout the catalog system. Use the ant command to both update the port number directly and propagate that change throughout the catalog system.
casm1401
If applicable, you use the operating system (not the ant update-usm-host command) to change the host name. Afterwards, you use the ant command to propagate that host name change throughout the catalog system. Use the ant command to both update the port number directly
and
propagate that change throughout the catalog system.
You perform these steps
only
on the computer whose host name or port number has changed. You do not perform these steps on
other
computers.
Follow these steps:
  1. Stop the CA Service Catalog services on the computer being updated.
    Stop these services on
    all
    CA Service Catalog computers in your environment
    before
    proceeding to the next step. Use the Windows Control Panel to stop the services.
  2. Perform the following actions:
    1. Open the CA Service Catalog command prompt from the CA Service Catalog portion of the Windows Start menu.
    2. Enter the following command at the CA Service Catalog command prompt:
      ant update-usm-host
      For a list of ant commands and their descriptions, enter ant -p.
      The utility displays the current settings for the host name and port number.
    3. Update each setting that you want to change, and record all updated settings for reference.
    The command utility performs the following actions:
    • Updates the host name and port number settings in your DBMS (Oracle or SQL Server) and in configuration files
    • Records the actions that it performs in the maintenance.log file.
      This log file and the backed-up configuration files are stored in the USM_HOME\conf-backup\
      date-time
      folder. The name of the \
      date-time
      subfolder is based on when the ant update-usm-host command was run. Thus, this subfolder name is different on each computer in the environment. The utility writes the name of the subfolder to the screen as soon as the backup is completed.
  3. Perform the following actions:
    1. View the maintenance.log file in the USM_HOME\conf-backup\
      date-time
      folder for a record of the actions performed.
    2. Record the name of this folder for future reference.
  4. Verify that you have finished updating the host name and port number on the current computer. Update the host name and port number on the next computer, if necessary.
  5. Verify that you have updated the required settings on
    all
    CA Service Catalog computers.
  6. Log in to CA Service Catalog.
  7. Verify that CA Service Catalog is running correctly, as follows:
    1. Log in to CA Service Catalog.
    2. Perform administrative tasks. Create services. Create and process requests.
The new or updated host name and application names are updated in the Windows registry.