Reconfigure the CA Service Catalog Computer using the Setup Utility

Run the CA Service Catalog setup utility to set up your database, reconfigure CA EEM, and reconfigure the product components. The product components are Catalog Component, Catalog Content, and Service Accounting Component.
casm1401
HID_Reconfigure _the_CA_Service_Catalog_Computer_using_the_Setup_Utility
Run the CA Service Catalog setup utility to set up your database, reconfigure CA EEM, and reconfigure the product components. The product components are Catalog Component, Catalog Content, and Service Accounting Component.
Run the CA Service Catalog setup utility on all CA Service Catalog computers in the correct sequence, as explained in this topic.
Follow these steps:
  1. Run the setup utility on each CA Service Catalog computer, in the following sequence:
    1. The
      first
      (formerly
      primary
      ) Service View computer
    2. All
      additional
      (formerly
      secondary
      ) Service View computers
    3. All other CA Service Catalog computers, in any order
    To run the setup utility, perform
    all
    the following steps on each computer, one computer at a time. For example, the first Service View computer is Host1, the additional Service View computers are Hosts 2 and 3, and the remaining CA Service Catalog computers are Hosts 4-6. First, run the setup utility on Host1. Next, run the setup utility on Hosts 2 and 3, one computer at a time, in any order. Third, run the setup utility on Hosts 4-6, one computer at a time, in any order.
  2. Start the setup utility using one of the following methods:
    • Click the option to start the setup utility
      after
      you have run the installation or upgrade program on the last applicable computer. The last applicable computer is the final computer on which you run the installation or upgrade program for CA Service Catalog.
    • Start the setup utility from the Windows Start menu. For example, click Start, Programs, CA, Service Catalog, Setup Utility.
    If your browser blocks access to the setup utility web page for security reasons, add the CA Service Catalog computer to the trusted web sites for the browser. Use the following format for the CA Service Catalog computer: http://
    hostname
    port
    .
  3. Specify the following parameters and log in to the utility:
    • Password
      Specifies the password for logging in to the utility and running it using either of the methods in the previous step.
      Record the password for reference, because the utility requires you to specify the password each time you start it.
      If necessary, you can reset the password, as follows:
      Enter the following command:
      USM_HOME\scripts\configurator.bat -resetpwd
      The Catalog system resets the password and prompts you to perform the next action: Restart the utility and specify the new password.
    • Remote Configuration
      (Optional) If you have run the utility successfully on another computer (a remote computer), you can use the same configuration on this computer (the local computer). To do so, select this option and enter the URL of the remote computer. Use the following format: http://
      server
      :
      port
      /
      context
      . An example is http://localhost:8080/usm.
      The database setup page appears.
  4. Complete this step
    only
    if you selected the Remote Configuration option in the previous step. Otherwise, skip to the next step.
    Supply the password for the setup utility on the remote computer.
    The local setup utility copies configuration data from the remote computer and pre-populates the corresponding local fields with this data. The local utility copies the data for the database setup, CA EEM configuration, and the name of the top-level business unit. Therefore, you do not need to enter this data manually. However, you can optionally update the copied values, if necessary. This data appears on the remaining tabs of the local setup utility and is described in the remaining steps.
    You typically use the Remote Configuration option when you plan to install multiple instances of CA Service Catalog.
You have completed the steps for running the setup utility on all CA Service Catalog computers.
If you are installing CA Service Catalog for the first time on a computer, the setup utility pre-populates the fields that require input with default values. If you are re-installing or upgrading CA Service Catalog, the setup utility pre-populates these fields with the values from the current installation. The Remote Configuration option overwrites any default values or existing values with the values from the remote computer.
Reconfigure the Database
You can reconfigure database so that CA Service Catalog users and the Catalog system can function correctly.
Follow these steps:
  1. Log in to the setup utility and click Database on the left menu.
    The utility displays the page for connecting to the database and configuring it.
  2. Select the DBMS that you are using and provide the information to complete the fields.
  3. Complete the fields for the Database Connectivity section.
    This step verifies that you can connect to the database. If the connection fails, perform these actions:
    1. Verify that the parameter values are correct. For more information about these parameter values, see Parameters for SQL Server and Parameters for Oracle.
  4. Specify the name of the CA Service Catalog database, typically MDB, in the Database Settings section.
    This step installs or upgrades the MDB, if necessary. This step also configures the CA Service Catalog database in the MDB.
  5. Complete the remaining database fields.
  6. Specify the details for the application user that you created earlier.
  7. Save and confirm your updates.
  8. (Optional) Review the log files, as follows:
    • For log information for SQL Server, see the following sources:
      • See the install_mdb.log file in your MDB target installation directory. This directory is specified in %TEMP%\MDB1.5, where %TEMP% is a Windows environment variable. If the MDB installation fails, review the log files in this location.
      • After a successful installation of the MDB, the install_mdb.log file is copied to the %ProgramFiles%\CA\SC\Mdb\Windows\logs folder. This log file is renamed to install_mdb_
        mm-dd,hh_mm_ss
        .log (for example, install_mdb_12-03,15_29_05.log).
      • See the view.log file. Its default location is the C:\Program Files\CA\Service Catalog\logs folder.
    • For log information for Oracle, see the following sources:
      • See the install_connectionID.log file in your MDB target installation directory. For example, if the connection ID is myhost_orcl, the install_connectionID.log file name is install_myhost_orcl.log. The MDB target installation directory is specified in %TEMP%\MDB1.5, where %TEMP% is a Windows environment variable. If the MDB installation fails, review the log files in this location.
      • After a successful installation of the MDB, the install_connectionID.log file is copied to %ProgramFiles%\CA\SC\Mdb\Windows\logs. This log file is renamed to install_ connectionID_
        mm-dd,hh_mm_ss
        .log, for example, install_myhost_orcl_12-03,15_29_05.log.
      • See the view.log file. Its default location is the C:\Program Files\CA\Service Catalog\logs folder.
You have reconfigured the database.
Parameters for SQL Server
Before you install CA Service Catalog, you specify values for several parameters to establish the connection to an SQL Server database. The following parameters may require explanation:
For a migration model upgrade, when you are prompted for information about the Catalog database, use the
existing
Catalog database specifications.
For the Database Connection
  • Host Name
    Defines the computer name of the Microsoft SQL Server (SQL Server) server.
  • Port
    Defines the TCP Port number of the database server.
    If you are using an instance name, verify the following requirements:
    • The instance name has a port number set.
    • Your implementation is
      not
      using dynamic ports.
  • User Name and Password fields
    Define the user name and password of the SQL Server database administrator (DBA). The setup utility uses these credentials to set up the CA Service Catalog database.
    You can use the login credentials System administrator (sa). This user requires dbo as its default schema.
  • Instance Name
    Defines the SQL Server instance name for the MDB. For example, myinstance. You can specify either a primary instance or a named instance.
For the Database Configuration
  • Database Name
    Specifies the name of the CA Service Catalog database: MDB.
    The name of the Catalog database must be MDB. This requirement is especially important if you integrate CA Service Catalog with another CA product, such as CA Service Desk Manager, CA APM, or CA Process Automation.
Application User Settings
  • User Name and Password fields
    Define the user name and password that CA Service Catalog uses for accessing this database.
    This user name and password are created in the database.
    This user is the first application user. For increased flexibility, you can optionally create a second application user.
Parameters for Oracle
Before you install CA Service Catalog, you specify values for several parameters to establish the connection to an Oracle database. The following parameters may require explanation:
For a migration model upgrade, when you are prompted for information about the Catalog database, use the
existing
Catalog database specifications.
These parameters apply to Oracle running on both Windows and Linux.
For the Database Connection
  • Host Name
    Defines the computer name of the Oracle server.
  • Port
    Defines the TCP Port number of the database.
  • User Name and Password fields
    Define the user name and password of the Oracle database administrator (DBA).
  • Service Name
    Defines the service name. Every Oracle database or service has a service name. The service name of an Oracle database is typically its global database name. Enter the service name of the database or other service that you want to access.
    A non-RAC deployment typically includes one service, one instance, and one database, each with the same name. However, in a RAC deployment, multiple instances can provide multiple services, all connecting to a single database.
  • Connection SID
    Defines the connection ID (such as orcl) for connecting to the Oracle server, as follows:
    • For a local database, this value is typically the SID.
    • For a remote database, this value is typically the Net Service Name.
For the Database Configuration
  • Database Name
    Specifies the name of the CA Service Catalog database: MDB.
    The name of the Catalog database must be MDB. This requirement is especially important if you integrate CA Service Catalog with another CA product, such as CA Service Desk Manager, CA APM, or CA Process Automation. CA Service Catalog embeds CA MDB r1.5.
  • Tablespace Path
    Defines the complete path name of the tablespace for Oracle.
  • Data Tablespace Name
    (Optional) Defines the tablespace name for the data.
  • Index Tablespace Name
    (Optional) Defines the tablespace name for the indexes.
    The installer verifies whether the data and index tablespaces exist in the MDB. These tablespaces exist when either of the following conditions are met:
    • The MDB is being upgraded.
    • The CA Service Catalog database is being installed in an existing MDB, typically from an already installed CA product or group of products.
    If the data and index tablespaces exist, the installer displays their names. The installer also prompts you to specify whether to continue using the existing names or overwrite them with new names.
Application User Settings
  • User Name and Password fields
    Define the user name and password that CA Service Catalog uses for accessing this database.
    This user name and password are created in the database.
Reconfigure CA EEM
You can reconfigure CA EEM for use with CA Service Catalog using the setup utility.
  Use the Setup Utility if you have only CA Service Catalog in your environment. Use the Service Management Administration, Common Configuration option to reconfigure CA EEM if you have integrated CA Service Catalog with at least one other
CA Service Management
product.
CA EEM has been reconfigured for use with CA Service Catalog.
Reconfigure the CA Service Catalog Components
You can reconfigure the CA Service Catalog product components that you want on this computer.
If you are installing CA Service Catalog on this computer for the first time, you can use the utility to reconfigure the product components. However, if you are upgrading or installing CA Service Catalog on this computer a second time, this value is read-only and you cannot reconfigure the product components.
Follow these steps:
  1. Log in to the setup utility and click Components in the the left menu.
  2. Enter the name of the service provider business unit. It is the “root” business unit above all other business units. As a best practice, specify your company domain name or a short version of your company name for the business unit ID.
  3. Select each component that you want to use on this computer:
    • Catalog Component
      Lets you create service options and service option groups, which you use to create services that users can request from the catalog.
      This option includes the Catalog Content, which supplies the predefined services in the catalog. Examples include services for requesting hardware, software, and other IT essentials from your business unit. You can use these services as-is, or you can copy and customize them.
      This option installs a Windows service named CA Service Catalog.
    • Service Accounting Component
      Lets you provide billing and chargeback for the services that users request from the catalog. You can also use Service Accounting Component to allocate costs, prepare budgets, and plan IT services.
      This option installs a Windows service named CA Service Accounting.
  4. Click Save.
  5. Follow the prompts and complete the setup.
You can optionally review the installation log file, view.log. Its default location is the USM_HOME\logs folder. This log file is visible after you have completed all tasks of the installation or upgrade program and have closed the program. For information about uninstallation and aborted or canceled installations (when applicable), see the CA_Service_Catalog_Uninstallation.log file in the Windows Temp folder.
CA Service Catalog components have been reconfigured.