Configuring zAdviser Enterprise On-Prem as a single node in On-prem Linux Ubuntu


This topic describes how to configure zAdviser Enterprise On-Prem as a single node in on-premises Linux Ubuntu.

Task 1: Applying a license for zAdviser Enterprise On-Prem

zAdviser Enterprise On-Prem follows the BMC V3 licensing model. You must obtain and apply the license password using the same process as other BMC legacy products. zAdviser Enterprise On-Prem is licensed based on a Per-Enterprise metric, meaning only one LPAR needs to have the license file applied, regardless of how many LPARs (e.g., 1 or 25) are transmitting data to zAdviser On-Prem.

Step 1: Obtain and manage the license password

Refer to the following official documentation for instructions on applying and managing passwords using the batch interface: 
Applying and managing passwords with the batch interface

Step 2: Verify and apply the license in zAdviser 

To ensure zAdviser On-Prem is properly licensed, complete the following steps: 

  1. Navigate to the License section within the Administration page of the zAdviser On-Prem interface.
  2. Fill in the following fields:
    FieldDescription
    LPAR HostThe hostname of the LPAR where the JCL will execute. 
    LPAR PortThe port number used for JCL submission, typically the FTP port (default: 21).
    Username

    The user ID under which the JCL will run. This user must have login access to the specified LPAR. 

    PasswordThe password for the specified user ID. 
    Load LibraryThe load library that contains the program BLFSEC3B. Refer to Step 1 for locating this library.
    Password DatasetThe dataset (from Step 1) where the license password was added.

Task 2: To obtain an Elastic certificate file for the configuration

  1. Use the SCP tool to navigate to installationFolder/certs/ca/ on your installation server.
  2. Copy the crt file to the VM machine. This certificate is used to configure the zAdviser.
    image-2024-12-17_15-31-36-1.png

Task 3: To perform the configuration

  1. Navigate to BMC AMI zAdviser Enterprise configuration page (https://<serverIP>:443/).
  2. For the connection type, select Local:
    image-2025-1-3_12-58-7-1.png
  3. Enter the following details:

    Field

    Description

    Elasticsearch URL

    https://elastic 

    Elasticsearch Port

    9200

    Username

    elastic

    Password

    Password set in the Ansible playbook

    Certificate file 

    ca.crt file saved in the previous step

    Kibana URL

    http://kibana

    Kibana Port

    5601

  4. To verify the connection with Elasticsearch and Kibana, click Test Connection.
    image-2024-12-17_15-44-39.png
     
  5. To configure the

    zAdviser Enterprise On-Prem

    , click Apply.
  6. To access zAdviser Enterprise, navigate to http://<serverIP>:5601 and log in with the credentials provided in the configuration. The user name is elastic, and password is the new password set up in the earlier steps.

Task 4: To configure LPARs

On the configuration page, navigate to LPAR Definitions section and enter all relevant information about the LPARs used by your organization.

You can update the LPAR settings at any time.

image-2024-12-31_14-47-1.png

Task 5: To configure SMTP server for generative AI reporting

  1. In the zAdviser Enterprise administration pane, expand Generative AI reporting.
  2. Select Email.
    image-2025-1-13_15-3-40.png
  3. Enter the following details:

    Field

    Description

    Host

    SMTP server address

    Port

    Appropriate port for your setup

    Start with TLS

    Select based on your servers security settings

    Username

    SMTP user name

    Password

    SMTP password

    From address

    Email address used to send emails

    Recipient(s)

    One or more recipient email addresses (comma-separated for multiple addresses)

  4. To save the configuration, click Apply.
Warning

Important

Make sure that you receive a test email confirming the successful setup of the SMTP server.

Task 6: To configure LLM for generative AI reporting

  1. In the zAdviser Enterprise administration pane, expand Generative AI reporting.
  2. Select Large language model (LLM).
    /secure/attachment/500979/500979_image-2025-04-01-14-09-02-593.png1743530166148-562.png/secure/attachment/500979/500979_image-2025-04-01-14-09-02-593.png
  3. Select a Platform: BYOLLM (Bring Your Own LLM) or AMI Platform
  4. Provide the required configuration details based on the selected deployment platform.

    BYOLLM configuration

    Field

    Description

    URL

    The endpoint for the LLM.

    Model

    LLM name

    Token

    An authentication token required to access the LLM.

    Headers

    Specify any additional custom headers to be included.

    AMI Platform configuration

    Field

    Description

    Integration Path

    Specify the AMI Platform Integration Path.

    Integration Key

    Enter the AMI Platform Integration Key.

    Integration ID

    Provide the AMI Platform Integration ID.

  5. To save the configuration, click Apply.
Warning

Important

To help you make the most of our platform capabilities, we have outlined the following key information:

  • The configuration supports the OpenAI API Specification for REST API.

  • You are welcome to integrate your own LLM, but we cannot guarantee response accuracy due to the nature of LLMs. For best results, we recommend using Anthropic Claude-3.5-Sonnet.
  • Our GenAI feature requires sufficient data to generate an analysis. If there is not enough data, you will be notified via email.

Task 7: To enable zAdviser Enterprise On-Prem support

Information

You can skip this step if HTTPS support is already enabled for zAdviser Enterprise On-Prem.

  1. Apply PTF CXSK99A (included in the October 2024 maintenance for ECC).
  2. If you are using BMC AMI DevX Code Pipeline, apply the following PTF for a smooth and successful startup:

    Version

    PTF

    22.01

    IWH265A

    18.02

    IWG531A

  3. Make the following changes to your BMC AMI PARMLIB:

    Purpose

    Action

    Enable the on-premises mode

    ZADVISER = ON_PREM

    Set the on-premises IP address

    ZADVISER_ONPREM IP = ipAddress

    Replace ipAddress with your zAdviser Enterprise On-Prem instance (for example, 127.0.0.1). 

    Configure the port number

    ZADVISER_ONPREM_PORT = portNumber

    Replace portNumber with the port number for sending zAdviser data to zAdviser Enterprise On-Prem.

    Warning

    Important

    The system automatically uses the port value specified in the PARMLIB, allowing for a flexible and dynamic port configuration.

 

 

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

BMC AMI zAdviser Enterprise On-Prem 26.02.00