Maintenance › Update the CA EEM Host Name and Application Names

Update the CA EEM Host Name and Application Names

To comply with security, governance, or other requirements, you can change the name of the host computer running CA EEM. You can also change the names of the applications whose access control you manage through CA EEM. These applications can be one or more CA products, such as CA Service Desk Manager, CA CMDB, CA Service Catalog, and so forth. To change these names, you run the update-eem-host command utility on every computer in your environment that has a CA Service Catalog component installed. This utility updates these names globally. Doing so helps ensure that CA Service Catalog, CA EEM, and their integrated products continue to run efficiently throughout your environment

Note: In this topic, the term application names refers to the CA EEM policies for managing access control for users and other resources to these products. Thus, in CA EEM, the application name Service Delivery refers to the policies governing user access control in CA Service Catalog. CA EEM also includes a Global application name that you can optionally apply in part or in whole to one or more products. For details about integrating CA Service Catalog and CA EEM, see the Integration Guide.

To update the CA EEM host name and application names

1. Open the CA Service Catalog command prompt by clicking Start, Programs, CA, Service Catalog, Service Catalog Command Prompt.
2. Verify that both the old and new CA EEM host computers are running if you are changing computers. Otherwise, skip to the next step.
3. Run the following command at the CA Service Catalog command prompt before changing the computer name, If you are changing only the computer name. Otherwise, skip to the next step.

   ant backup-eem-app
   

   This action generates a file named eem-backup.xml in the %USM_HOME% directory.

4. Perform this step If you want to change the name of the CA EEM computer. Otherwise, skip to the next step. For example, if you are moving CA EEM from one computer to another, skip to the next step.
   1. Change the computer name.
   2. Reboot the computer.
   3. Update the CA EEM configuration with the new computer name, according to the instructions in the CA EEM documentation.
5. Use the Windows Control Panel to stop these services: CA Service View, CA Service Accounting, CA Service Fulfillment, and Message Queue 4.1 Broker.

   Important! Stop these services on all CA Service Catalog computers in your environment before proceeding to the next step! Stop the services on all computers. Next, perform the steps that follow, on each CA Service Catalog computer, one at a time, until you have updated the CA EEM host name and application names on all of them.

   Note: If you are using vertical clustering, you do not need to update the CA EEM host name and application names on every vertical cluster individually. Instead, update these names only once on the computer where the verticals clusters are configured.

6. Perform this step if you have an existing backup file. Otherwise, skip to the next step.
   1. Copy the backup file to the %USM_HOME% directory and rename it to eem-backup.xml.
   2. Enter the following command at the CA Service Catalog command prompt:

      ant update-eem-host -Duse.existing.eem.backup=true
      

   Note: For a list of ant commands and their descriptions, enter ant -p.

7. Enter the following command if you do not have an existing backup file. Otherwise, skip to the next step.

   ant update-eem-host
   

   1. Follow the prompts to update the CA EEM host name and application names.

      If the name that you specify is new, the command utility creates the name in the CA EEM database.

      The new or updated names are echoed.

   2. Confirm that you entered the new name exactly as you intended, including the case. Correct the name if necessary.

      Important! The new names can be case-sensitive, depending on whether your DBMS is configured as case-sensitive. If necessary, see your DBMS administrator or DBMS documentation for details.

   3. If necessary, to correct any errors, cancel and rerun the ant update-eem-host command.
   4. Record the new names in a safe location for reference.

   The command utility does the following:

   • Backs up the existing versions of the pm.xml, wl.xml, EIAM.properties, and other configuration files
   • Updates the host name and application names in these configuration files
   • Updates the host name and application names in your DBMS (Oracle or SQL Server)
   • Records the actions 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 the date and time at which the ant update-eem-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.

8. Do the following:
   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.

   Note: Before you proceed to the next step, verify that you have updated the host name and application names on all CA Service Catalog computers.

9. On every CA Service Catalog computer, restart the CA Service Catalog services that you shut down previously. Verify that CA Service Catalog is running correctly, as follows:
   1. Log in to CA Service Catalog.
   2. Create services, create and process requests, and perform administrative tasks.

   The new or updated host name and application names are updated in the Windows registry.

Note: As a best practice, back up the Windows registry after you update the host name and application names. For details, see your Windows documentation.