Installing the Capacity Database Web Services


Use the following procedure to install BMC AMI Capacity Database Web Services version 1.7.00.

Best Practice
For better performance, we recommend that you install the Capacity Database Web Services on the same server as the relational database management system (RDBMS), such as Microsoft SQL Server or Oracle. For more information about installing Capacity Database Web Services, see Installing BMC AMI Capacity Database Web Services.

To install Capacity Database Web Services

  1. Perform one of the following actions:
    • If you have downloaded the product from the Electronic Product Distribution (EPD) facility, navigate to the folder in which the installation files were saved.
    • If you have received a physical product shipment, insert the Capacity Database Web Services installation CD into a CD drive.
  2. In the Capacity Database Web Services folder, double-click the setup.exe file.

    Important

    • The installation program checks for the system requirements described in System-requirements-for-Capacity-Database-Web-Services. If any requirement is not satisfied, the installation program notifies you and stops. Before restarting the installation program, you must satisfy the missing requirements.
    • The installation program also checks for previous versions of the Capacity Database Web Services that may need to be uninstalled. The installation program notifies you about the products that you need to uninstall and stops. Before restarting the installation program, you must uninstall those products. 
  3. On the Welcome page, click Next.
  4. Read the license agreement and click Yes.
  5. Review the Readme file and click Next.
  6. On the Choose Destination Location page, perform one of the following options:

    • To accept the default location, click Next.
    • To choose a different location, click Browse.
      The destination location identifies the folder in which to install Capacity Database Web Services product files. The default 64-bit OS destination folder is C:\Program Files (x86)\BMC Software\CDB

    Important

    The selected destination location becomes the IIS virtual directory that provides access to Capacity Database Web Services current version.

    The IIS Application Pool and Windows Service Identity page is displayed as follows:
    CDB1.png

  7. On the IIS Application Pool and Windows Service Identity page, perform the following actions: 
    1. Select an account under which the Capacity Database Web Services should run. 
      You can select either Local System Account or Specific User Account. The specific user account must have Log On As A Service rights.
    2. Enter the Domain\Username and password for the account.
    3. Click Test User Account to verify the credentials.
    4. Click IIS Advanced Options.
      The IIS Advanced Options page displays the IIS configurations that exist on the machine.
      CDB2.png

    5. From the list, select the IIS Web Site, Port Number, and the protocol, then click OK.

      Important

      If this is the first time you are installing Capacity Database Web Services, the IIS Advanced Options page shows the default configuration. However, if you are reinstalling the product, it shows the current configuration. If more than one option is detected for either the IIS Web Site or Port Number, you can select them from the list.

      If you are still using the HTTP protocol, the following warning is displayed:

      HTTPS_2.png

    6. On the IIS Application Pool and Windows Service Identity page, specify the fields and click Next.
      The Start Copying Files page is displayed.
  8. Review your entries on the Start Copying Files page and click Next to begin the installation.
    The Setup Status page displays a progress bar that indicates the progression of the installation process.
  9. During the installation, the Capacity Database Web Services detects the Microsoft Windows firewall. 
    When prompted, configure the firewall based on the following options:
    • If you want the installation program to add all necessary entries to the firewall, click YES.
    • If you want to enter the firewall settings manually, click NO.

      Use the following table to complete the configuration:

      Firewall setting

      Value

      Rule Type

      Port

      Direction

      Inbound/Outbound

      Program

      CDBWorkflowService.EXE

      Protocol and ports

      TCP All local ports

      Action

      Allow connection

      Profile

      DomainPrivate

      Name

      CDBWorkflowService

  10. Click Finish.
    If prompted, restart your computer.

To configure Binding Information for BMC CDB Services

Perform this procedure if the CDB Services Binding Information page is displayed while you are installing Capacity Database Web Services.

Important

The CDB Services Binding Information page is displayed only when you select the HTTPS protocol on the IIS Advanced Options page and the install cannot resolve the server name with the common name on the SSL certificate.

The install tests the server name obtained via Dns.GetHostName. If the test fails, the install uses the array of domain suffixes in the SearchList registry entry:  

 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\Tcpip\Parameters\SearchList

The install appends a domain suffix to the server name and runs the test. If a test is successful, the install continues. If none of the tests are successful, the CDB Services Binding Information page is displayed.

  1. In the CDB Server field, enter the SSL certificate’s common name in the form of a fully qualified domain name. 
    CDB3.png

  2. Click Test CDB Connection to verify the connection, then click OK.

Important

If prompted, you must restart your computer before accessing Capacity Database Web Services.




 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*