Post-Installation configuration API


By using the commands in the Configuration Wizard API, you can perform post-installation configuration of multiple system components in a bulk.

Parameters

Method

Parameters

Required/optional

Applies

Description

Supported components

so
name
pass

Optional

Only on a first boot

Security Officer account credentials — a user name and a password.

All

certificate
common
lifetime

Optional

Only on a first boot

SSL-server certificate — common or a lifetime.

All

To create an initial account

On the next step of the Configuration Wizard, you must set a username and password for the initial user of the system, as shown in the following figure, and click Submit.

Creating credentials for the initial user

step2.png

The initial account has Security-level access. This means that the user logging on with these credentials can access all functionality, including security features, which are invisible to non-Security-level users. Security-level users are usually responsible for handling cryptographic keys, confidential data, and other similar items, and can add other Security-level accounts to the system. The Administrator role is the only role defined for the BMC Real End User Experience Monitoring Aggregation Server for Extended Reporting component.

To specify SSL-server-certificate properties

Secure Sockets Layer (SSL) keys and certificates secure the following types of connections:

  • Between users of the web interfaces and the system itself
  • Between end-user experience components

The certificate is self-signed; it uniquely identifies the component instance.

  1. Enter the certificate's default common name (CN), which is the IP address of the management port of the component, as shown in the following figure. You can select a custom name (for example, the host name of the component instance — analyzer1.example.com).

    SSL server certificate properties

    step1.png

  2. (Optional) Specify how long you want the certificate to be valid (in other words, a number of days before it expires). By default, the certificate lifetime is unlimited.
  3. Click Submit.

Note

It is also possible to upload the SSL certificate later if required.

Sample requests

https://10.0.0.1/cgi-bin/tsvmconfig.cgi?certificate_common=192.19.147.61&certificate_lifetime=1825

Related topic

Configuration-APIs

 

 

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