Administer > Introduction > Logging In to UCMDB > How to Launch UCMDB UI as a Desktop Application from UCMDB Local Client

Launch UCMDB UI as a Desktop Application from UCMDB Local Client

The UCMDB Local Client tool enables you to launch the administrative GUI (UCMDB UI) of a target UCMDB server as a desktop application from the UCMDB local client tool, without the need for the Oracle JVM installed on that desktop. It also allows you to manage login configurations for multiple UCMDB servers easily from a central place.

This section contains the following:

 

UCMDB Local Client Support Matrix

This release of the UCMDB Local Client tool supports the following:

  • Supported UCMDB versions

    The UCMDB Local Client tool supports UCMDB version 10.20 and later.

  • Supported platform

    Windows platform for this release.

  • Supported Authentication Mode

    This release supports LDAP authentication mode.

     

Launch UCMDB Server Admin UI as a desktop application from UCMDB Local Client

  1. Download the UCMDB Local Client tool.

    You can download the UCMDB Local Client tool from one of the following locations:

    • Micro Focus Self-Solve Knowledge Search (SSO) site
    • Download the tool from UCMDB Server version 2018.05 or later when the server is up and running.

      • On the UCMDB server machine, go to the <UCMDB_Server>\tools directory and copy the UCMDB_Local_Client.zip file to a location of your choice.
      • Click Download UCMDB Local Client (Windows) on the UCMDB splash screen (Access UCMDB Server version 2018.05 or later using the following URL: https://<server name or IP address>.<domain name>:8443).
  2. Launch the UCMDB Local Client tool.

    1. Extract the UCMDB_Local_Client.zip package to a location of your choice, for example, the desktop.
    2. Double-click UCMDB Local Client.cmd.

      The UCMDB Local Client window opens.

  3. Add or edit login configuration for the target UCMDB servers that you want to access.

    1. Click Add or Edit .

      The Add/Edit Configuration dialog opens.

    2. Provide or edit values for the fields as described in the table below.

      UI Element Description Valid Values
      Host/IP Server name or IP address of the target UCMDB server that you want to access. Example: <host name or IP address>
      Label Specify a label for the UCMDB server. If you leave it blank, the field will be populated with the host value.  
      HTTPS Select the checkbox to use HTTPS communication. Default: Selected
      Port Specify the port number of the target UCMDB server that you want to access. Default: 8443
      Min Memory

      Define the minimum memory, in megabytes (MB), to be allocated on the local machine for launching the target UCMDB server admin UI.

      Default: 512
      Max Memory Define the maximum memory, in megabytes (MB), to be allocated on the local machine for launching the target UCMDB server admin UI. Default: 1024
      Language

      Select the language that you want the target UCMDB server UI to be displayed in. Supported languages include:

      • English
      • Japanese
      • Korean
      • Chinese
      • French
      • German
      • Spanish
      • Italian
      • Russion
      • Portuguese

      Default: English
      Context

      Specify the root context for the target UCMDB server. Leave the field as is if you want to use the default root context value /.

      Note If you configured the infrastructure setting Root context value in the Infrastructure Settings Manager module, make sure you copy the value to the Context field, so that this Context setting and the infrastructure setting Root context use the same value. For instructions about how to configure the root context, see How to Change the Root Context for UCMDB Components.

      Default: /
    3. Click OK.
  4. Launch UCMDB server Admin UI from the UCMDB Local Client window.

    1. In the UCMDB Local Client window, click the Label value for the UCMDB server that you want to access.

      The Log In dialog opens.

      Note If any warning message related to the certificate issue pops up, import the UCMDB server certificate by following instructions in Export the OOTB UCMDB server certificate and import it to the UCMDB Local Client tool.

    2. In the Log In dialog, enter your login parameters.
    3. Click Login.

      The UCMDB server Admin UI opens in a new window.

      To log out the UCMDB session, simply click .

 

Export the OOTB UCMDB server certificate and import it to the UCMDB Local Client tool

To export the out-of-the-box UCMDB server certificate and import it to the UCMDB Local Client tool, do the following:

Note This is needed only when you do not have a certificate provided by a Certificate Authority.

  1. Export the UCMDB server certificate (for example, ucmdb.cer) and save it to your machine.

    Taking Windows and Chrome as an example,

    1. In the client web browser, enter https://<UCMDB machine name or IP address>:8443/.

    2. Click the lock icon in the address bar.

    3. Click the Details link right under the site address.

      The Details pane opens to the Overview tab page in the right side

    4. Click View Certificate.
    5. In the Certificate dialog box, go to the Details tab, find the certificate which contains CN = HP Universal CMDB, and click Copy to File.

      The Certificate Export Wizard opens.

    6. Click Next.
    7. On the Export File Format page, select DER encoded binary X.509 (.CER). and click Next.
    8. On the File to Export page, enter a file name (for example, ucmdb) and click Next.
    9. Click Finish.
  2. Copy the exported ucmdb.cer file to the <UCMDB_Local_Client_dir> directory.
  3. Import the certificate by executing the following command:

    <UCMDB_Local_Client_dir>\jre\bin\keytool.exe -importcert -alias ucmdb -file  <UCMDB_Local_Client_dir>\ucmdb.cer -keystore <UCMDB_Local_Client_dir>\jre\lib\cacerts
  4. You may need to enter the default password changeit, and enter yes when prompted "Trust this certificate?".

  5. (Optional) Restart the UCMDB Server.

 

Reuse the UCMDB server configuration information on a different machine

The UCMDB server configuration information you added in UCMDB Local Client are stored in the config.json file. To import or reuse the UCMDB server configuration information on a different machine, you can just copy and paste the config.json.

To do so,

  1. Download and extract the UCMDB_Local_Client.zip package to the target machine.
  2. On the source machine, go to the %APPDATA%\Micro Focus\CMS\UCMDB Local Client folder and copy the config.json file.

    Note This is the default location for storing the config.json file.

    To change the default location, see Modify the location for storing the config.json file below.

  3. Go to the target machine, paste the config.json file to the %APPDATA%\Micro Focus\CMS\UCMDB Local Client folder to replace the existing one.

 

Modify the location for storing the config.json file

By default, the config.json file is stored in the %APPDATA%\Micro Focus\CMS\UCMDB Local Client folder. If necessary, you can configure a different location to store the config.json file. To do so,

  1. In the UCMDB Local Client folder, open the UCMDB Local Client.cmd file using a text editor.

  2. Locate the CMS_CLIENT_CONFIG parameter, which specifies the default location for storing the config.json file as follows:

    CMS_CLIENT_CONFIG=%APPDATA%\Micro Focus\CMS\UCMDB Local Client
  3. Modify the CMS_CLIENT_CONFIG parameter value, so that it points to a location of your choice.
  4. Save the file.