Cisco Prime Central for Hosted Collaboration Solution 9.1.1 Installation Guide
Chapter 4: Installing Prime Central for HCS 9.1.1
Downloads: This chapterpdf (PDF - 287.0KB) The complete bookPDF (PDF - 2.43MB) | Feedback

Installing Prime Central for HCS 9.1.1

Table Of Contents

Installing Prime Central for HCS 9.1.1

With Remotely Staged Files

Configuring the SSH Agent

With Locally Staged Files on Target Installation Machine


Installing Prime Central for HCS 9.1.1


This chapter explains how to install Prime Central for HCS 9.1.1. Prime Central for HCS installation is CLI-based. Prime Central establishes a connection with an external database called the Shared Data Repository (SDR). Data from SDR is used for event enrichment, root cause analysis, and service impact analysis. The virtual machine (VM) on which SDR is installed is HCM-Fulfillment.

For the installation procedure to be successful, it is crucial that you run the following five installers in the sequence mentioned below:

1. Prime Central

2. Event Collector

3. Correlation Engine

4. Service Visualizer

5. Infrastructure Monitoring

If you had previously installed Prime Central for HCS 1.0.1 or Prime Central for HCS 1.1 in your environment, you can either perform a fresh installation or perform an upgrade.


Caution You must not install different installers in the same machine. The sequence of installation is crucial for the installation to be successful. While you can install the components Correlation Engine, Service Visualizer, and Infrastructure Monitoring in parallel, we highly recommend that you follow the sequence specified in this document.

You can install the components in any one of the following two ways. You can use alternative methods for each component. For help on populating the fields, you can run the help command while installing or upgrading your Prime Central for HCS software. For example, you can run the command as mentioned here—./prime_push.py --help.


Note After you complete the installation of each component, the virtual machine reboots if the original SELinux setting is disabled. This is to turn on the SELinux feature.


With Remotely Staged Files—To install Prime Central for HCS, you have to run five installers on the staging server, in the order specified in this document. You can install the files from one machine by establishing an SSH connection with a remote virtual machine. The component will be installed in the remote machine.

With Locally Staged Files on Target Installation Machine—To install Prime Central for HCS, you have to run five installers in five different machines, in the order specified in this document. This method installs the component in the local machine directly.

With Remotely Staged Files

Using this method, you have to establish an SSH connection with the remote machine from the machine you are going to trigger the installation. To circumvent the scenario of having to give the password everytime you do an installation, follow the procedure outlined below. This procedure is optional.

Configuring the SSH Agent

By configuring the SSH Agent, you will not be asked for a password every time you push the installation. However, with the use of --ssh-push-key, you will be asked for the target machine's root password the first time you log onto it from a user account on a particular machine.

If you want to not be asked for your SSH key pass phrase every time you run a script, you can use standard Linux SSH functionality and use ssh-agent to store your pre-authorized keys.


Step 1 The first step is to generate keys. If you do not have a key, log in as root user and generate the key(s). This is done only once for a target machine to which the configuration is pushed.

test ~/.ssh/id_dsa || ssh-keygen -t dsa
test ~/.ssh/id_rsa || ssh-keygen -t rsa
 
   

Note To have a pass phrase on your SSH key is optional. A pass phrase is considered more secure.


Step 2 Start SSH agent. This is applicable only the first time or after a reboot of a machine you are pushing from.

Step 3 Run the following command to see if the SSH agent is running:

eval `ssh-agent`
 
   

Step 4 Add the key to the SSH Agent that is running:

ssh-add ~/.ssh/id_rsa
ssh-add ~/.ssh/id_dsa 
 
   

You can begin the installation procedure of the various components. The following three rules apply:

Log in as root user

At instances where you have to type the password, specify the root password.

Prime Central Installer

Here are some recommendations for installing Prime Central installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords.

Provide the --admin-password and --prime-admin-password arguments.

Do not use the --prime-ip-address argument as the script can determine the IP address.

Maintain the same VM root password across all the VMs.

The following steps explain the procedure to install Prime Central component:


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./prime_push.py --prime-hostname <prime-hostname> --ec-hostname <event-collector-host-or-ip> --hcm-f-hostname <hcm-f-hostname-or-ip> --hcm-f-admin-password <hcm-f-admin-password> --im-hostname <Infrastructure-Monitoring_hostname> --sv-hostname <service-visualizer-hostname-DO-NOT-USE-IP> --password <prime-vm-root-password> --ntp-servers <server1>,<server2>...
[ --admin-password <admin-password> --prime-admin-password <prime-admin-password> ]
[ --ssh-host <
ssh-host-or-ip> --ssh-port <ssh-port> ] [ --ssh-push-key ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

Prime hostname—In the above command, provide only the hostname against <prime-hostname> argument. Hostname must contain only lowercase characters. Do not enter the IP address. The length of the hostname must not exceed 18 characters.

Admin Password—In the above command, against the argument--admin-password, provide a password for all users that require a password on this VM. The admin password must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

Prime Admin Password—Against the argument --prime-admin-password, provide a complicated password for users in the Prime Central VM. The prime admin passwords must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation.The password must follow the guidelines mentioned below:

Minimum 8 characters and maximum 12 characters

A character must not be repeated 3 times consecutively.

Must contain at least one uppercase letter (A-Z).

Must contain at least one lowercase letter (a-z)

Must contain at least one number (0-9)

Must contain at least one special character -@~

The special characters exclamation mark (!), apostrophe ('), quotation mark ("), slash (/), dollar sign ($), question mark (?), accent grave (`), or underscore (_) must not be used.

Must not contain cisco or any other combination of the word.


Note The argument within square brackets is optional. You can either specify an SSH host or IP address against <ssh-host-or-ip>. The arguments ssh-host and ssh-port are required only if SSH access to the VM uses a different IP/hostname and a different port (that is not the default 22). For example, you would use the argument if the staging server is not behind NAT.


To see an example of the usage of the script, see Prime Central Installer—Example.


Event Collector Installer

Event Collector install requires that Prime Central be installed and running. Prime Central must also be reachable at the address given in the prime-hostname argument for the Prime Central installer. Wait for the VM to restart before you begin installing Event Collector installer. Cisco recommends that you do not use unencrypted passwords for security reasons while supplying the nco-pa-password.

Here are some recommendations for installing Event Collector installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords. You will be prompted for the Prime VM root password unless SSH is setup to not prompt for a password from Event Collector VM to Prime VM for root user.

Provide the --admin-password and --prime-admin-password arguments.

Maintain the same VM root password across all the VMs.

For security reasons, encrypt the OS root password in the --nco-pa-password argument. If you cannot encrypt the OS root password with nco_pa_crypt from a previous install, then the recommended approach is to not use the --nco-pa-password argument. In such a case (of not using the --nco-pa-password argument), the installer prompts you for the unencrypted password. After you type the password, installer immediately encrypts the password.


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./ec_push.py --ec-hostname <event-collector-host-or-ip> --prime-hostname <prime-hostname-or-IP> --ntp-servers <server1>,<server2>...
[ --admin-password <admin-password> --prime-admin-password <prime-admin-password> ]
[--nco-pa-password <ec-os-root-password-from-nco_pa_crypt>]

[ --ssh-host <ssh-host-or-ip> --ssh-port <ssh-port> ] [ --ssh-push-key ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

Admin Password—In the above command, against the argument--admin-password, provide a password for all users that require a password on this VM. The admin password must be the same in all the five VMs. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

Prime Admin Password—Against the argument --prime-admin-password, provide a complicated password for users in the Prime Central VM. The prime admin passwords must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation.The password must follow the guidelines mentioned below:

Minimum 8 characters and maximum 12 characters

A character must not be repeated 3 times consecutively.

Must contain at least one uppercase letter (A-Z).

Must contain at least one lowercase letter (a-z)

Must contain at least one number (0-9)

Must contain at least one special character -@~

The special characters exclamation mark (!), apostrophe ('), quotation mark ("), slash (/), dollar sign ($), question mark (?), accent grave (`), or underscore (_) must not be used.

Must not contain cisco or any other combination of the word.


Note The argument within square brackets is optional. You can either specify an SSH host or IP address against <ssh-host-or-ip>.



To see an example of the usage of the script, see Event Collector Installer—Example.

Correlation Engine Installer

Correlation Engine install requires Event Collector be installed and running. Begin installing the Correlation Engine installer only after the Event Collector VM restarts after the reboot.

Here are some recommendations for installing Correlation Engine installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords.

Provide the --admin-password argument.

Maintain the same VM root password across all the VMs.

Use the same HCM-F hostname and HCM-F admin password as specified for the Prime Central installer.

The following steps explain the procedure to install Correlation Engine component:


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./ce_push.py --ce-hostname <correlation-engine-host-with-domain-name-DO-NOT-USE-IP> --ec-hostname <event-collector-host-name-with-domain-name-or-ip>

--hcm-f-hostname <hcm-f-hostname> --hcm-f-admin-password <hcm-f-admin-password> --ntp-servers <server1>,<server2>...

[ --admin-password <admin-password> ]
[ --ssh-host <ssh-host-or-ip> --ssh-port <ssh-port> ] [ --ssh-push-key ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

In the argument <correlation-engine-host-with-domain-name>, specify only the hostname with domain name, also known as fully qualified domain name (FQDN). Do not enter the IP address.

In the argument <event-collector-host-name-with-domain-name-or-ip>, you can specify either the IP or hostname. If you specify the hostname, it must be used with FQDN.

In the above command, against the argument --admin-password, provide a complicated password for users in the Prime Central VM. The password must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters.

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.


Note The argument within square brackets is optional. You can either specify an SSH host or IP address against <ssh-port-or-ip>.



To see an example of the usage of the script, see Correlation Engine Installer—Example.

Service Visualizer Installer

Service Visualizer install requires Prime Central and Event Collector be installed and running. You must begin installing Service Visualizer component only after Prime Central and Event Collector restarts after the reboot. Prime Central must also be reachable at the address given in the prime-hostname argument for the Prime Central installer. Here are some recommendations for installing Service Visualizer installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords.

Provide the --admin-password and --prime-admin-password arguments.

Maintain the same VM root password across all the VMs.

Use the same HCM-F hostname and HCM-F admin password as specified for the Prime Central installer.

The following steps explain the procedure to install Service Visualizer component:


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./sv_push.py --sv-hostname <service-visualizer-hostnameDo-NOT-USE-IP> --ec-hostname <event-collector-host-or-ip> --prime-hostname <prime-hostname>

--hcm-f-hostname <hcm-f-hostname> --hcm-f-admin-password <hcm-f-admin-password> --ntp-servers <server1>,<server2>...

[ --admin-password <admin-password> --prime-admin-password <prime-admin-password> ]
[ --ssh-host <ssh-host-or-ip> --ssh-port <ssh-port> ] [ --ssh-push-key ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

Prime hostname—In the above command, provide only the hostname against <prime-hostname> argument. Hostname must contain only lowercase characters. Do not enter the IP address. The value that you enter against the --prime-hostname argument must be the same hostname that you entered during installation of Prime Central.

You will be prompted for the Prime VM root password if you did not set up SSH to not prompt for a password from Service Visualizer VM to Prime VM for root user.

Admin Password—In the above command, against the argument--admin-password, provide a password for all users that require a password on this VM. The admin password must be the same in all the five VMs; if the passwords are different, you run of the risk of having to perform a reinstallation. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

Prime Admin Password—Against the argument --prime-admin-password, provide a complicated password for all users in the Prime Central VM. The prime admin passwords must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation.The password must follow the guidelines mentioned below:

Minimum 8 characters and maximum 12 characters

A character must not be repeated 3 times consecutively.

Must contain at least one uppercase letter (A-Z).

Must contain at least one lowercase letter (a-z)

Must contain at least one number (0-9)

Must contain at least one special character @~-

The special characters exclamation mark (!), apostrophe ('), quotation mark ("), slash (/), dollar sign ($), question mark (?), accent grave (`), or underscore (_) must not be used.

Must not contain cisco or any other combination of the word.


Note The argument within square brackets is optional. You can either specify an SSH host or IP address against <ssh-port-or-ip>.



To see an example of the usage of the script, see Service Visualizer Installer—Example.

Infrastructure Monitoring Installer

Follow the procedure below to install Infrastructure Monitoring component. Here are some recommendations for installing Infrastructure Monitoring installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords.

Maintain the same VM root password across all the VMs.


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./im_push.py --im-hostname <infrastructure-monitoring-host-or-ip> --ec-hostname <event-collector-host-or-ip> --prime-hostname <prime-central-host-or-ip> --ntp-servers <server1>,<server2>... --hcm-f-hostname <HCM-F-hostname-OR-IP> --hcm-f-admin-username <HCM-F Admin CLI Username> --hcm-f-admin-password <HCM-F Admin CLI Password> [ --admin-password <admin-password> ]

[ --ssh-host <ssh-host-or-ip> --ssh-port <ssh-port>] [ --ssh-push-key ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

In the above command, against the argument --admin-password, provide a complicated password for users in the Prime Central VM. The password must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters.

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.


Note The argument within square brackets is optional. You can either specify an SSH host or IP address against <ssh-port-or-ip>.


To see an example of the usage of the script, see Infrastructure Monitoring Installer—Example.

With Locally Staged Files on Target Installation Machine

This section explains the steps involved in installing Prime Central for HCS 9.1.1 on a local machine.

Prime Central Installer

Here are some recommendations for installing Prime Central installer:

Provide the --admin-password and --prime-admin-password arguments.

Do not use the --prime-ip-address argument as the script can determine the IP address.

Maintain the same VM root password across all the VMs.

The following steps explain the procedure to install Prime Central component:


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./prime_install.py --prime-hostname <prime-hostname-DO-NOT-USE-IP> --ec-hostname <event-collector-host-or-ip> --hcm-f-hostname <hcm-f-hostname> --hcm-f-admin-password <hcm-f-admin-password> --im-hostname <infrastructure-monitoring_hostname> --sv-hostname <service-visualizer-host-or-ip> --password <prime-vm-password> --ntp-servers <server1>,<server2>...

[ --prime-ip-address]
[ --admin-password <admin-password> --prime-admin-password <prime-admin-password> ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

Prime hostname—In the above command, provide only the hostname against <prime-hostname> argument. Hostname must contain only lowercase characters. Do not enter the IP address.

Admin Password—In the above command, against the argument--admin-password, provide a password for all users that require a password on this VM. The admin password must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

Prime Admin Password—Against the argument --prime-admin-password, provide a complicated password for users in the Prime Central VM. The prime admin passwords must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation.The password must follow the guidelines mentioned below:

Minimum 8 characters and maximum 12 characters

A character must not be repeated 3 times consecutively.

Must contain at least one uppercase letter (A-Z).

Must contain at least one lowercase letter (a-z)

Must contain at least one number (0-9)

Must contain at least one special character @~-

The special characters exclamation mark (!), apostrophe ('), quotation mark ("), slash (/), dollar sign ($), question mark (?), accent grave (`), or underscore (_) must not be used.

Must not contain cisco or any other combination of the word.

.To see an example of the usage of the script, see Prime Central Installer—Example.

Event Collector Installer

Event Collector install requires that Prime Central be installed and running. Prime Central must also be reachable at the address given in the prime-hostname argument for the Prime Central installer. Wait for the VM to restart before you begin installing Event Collector installer. Cisco recommends that you do not use unencrypted passwords for security reasons while supplying the nco-pa-password.

Here are some recommendations for installing Event Collector installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords. You will be prompted for the Prime VM root password unless SSH is setup to not prompt for a password from Event Collector VM to Prime VM for root user.

Provide the --admin-password and --prime-admin-password arguments.

Maintain the same VM root password across all the VMs.

For security reasons, encrypt the OS root password in the nco-pa-password. argument. If you cannot encrypt the OS root password with nco_pa_crypt from a previous install, then the recommended approach is to not use the --nco-pa-password argument. In such a case (of not using the --nco-pa-password argument), the installer prompts you for the unencrypted password. After you type the password, installer immediately encrypts the password.


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Run ./ec_install.py --ec-hostname <event-collector-host-or-ip> --prime-hostname <prime-hostname> --ntp-servers <server1>,<server2>...
[ --admin-password <admin-password> --prime-admin-password <prime-admin-password> ]

[--nco-pa-password <ec-os-root-password-from-nco_pa_crypt> ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

Admin Password—In the above command, against the argument--admin-password, provide a password for all users that require a password on this VM. The admin password must be the same in all the five VMs. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

Prime Admin Password—Against the argument --prime-admin-password, provide a complicated password for users in the Prime Central VM. The prime admin passwords must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation.The password must follow the guidelines mentioned below:

Minimum 8 characters and maximum 12 characters

A character must not be repeated 3 times consecutively.

Must contain at least one uppercase letter (A-Z).

Must contain at least one lowercase letter (a-z)

Must contain at least one number (0-9)

Must contain at least one special character @~-

The special characters exclamation mark (!), apostrophe ('), quotation mark ("), slash (/), dollar sign ($), question mark (?), accent grave (`), or underscore (_) must not be used.

Must not contain cisco or any other combination of the word.


Note The argument within square brackets is optional.



Note If you install Event Collector afresh, the encrypted password from nco_pa_crypt will not be available. If you pass the password as an argument, it will not be encrypted; however, you enter the password when prompted, it will be encrypted.


To see an example of the usage of the script, see Event Collector Installer—Example.

Correlation Engine Installer

Correlation Engine install requires Event Collector is installed and running. Begin installing the Correlation Engine installer only after the Event Collector VM restarts after the reboot.

Here are some recommendations for installing Correlation Engine installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords.

Provide the --admin-password argument.

Maintain the same VM root password across all the VMs.

Use the same HCM-F hostname and HCM-F admin password as specified for the Prime Central installer.

The following steps explain the procedure to install Correlation Engine component:


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./ce_install.py --ce-hostname <correlation-engine-host-with-domain-name-DO-NOT-USE-ip> --ec-hostname <event-collector-host-name-with-domain-name-or-ip>

--hcm-f-hostname <hcm-f-hostname> --hcm-f-admin-password <hcm-f-admin-password> --ntp-servers <server1>,<server2>...
[ --admin-password <admin-password> ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

In the argument <event-collector-host-name-with-domain-name-or-ip>, you can specify either the IP or hostname. If you specify the hostname, it must be used with FQDN.

In the above command, against the argument --admin-password, provide a complicated password for users in the Prime Central VM. The password must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters.

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

To see an example of the usage of the script, see Correlation Engine Installer—Example

Service Visualizer Installer

Service Visualizer install requires Prime Central and Event Collector be installed and running. You must begin installing Service Visualizer component only after Prime Central and Event Collector restarts after the reboot. Prime Central must also be reachable at the address given in the prime-hostname argument for the Prime Central installer. Here are some recommendations for installing Service Visualizer installer:

Use the --ssh-push-key argument to limit the number of times you are prompted for passwords.

Provide the --admin-password and --prime-admin-password arguments.

Maintain the same VM root password across all the VMs.

Use the same HCM-F hostname and HCM-F admin password as specified for the Prime Central installer.

The following steps explain the procedure to install Service Visualizer component:


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Run ./sv_install.py --sv-hostname <service-visualizer-hostname> --ec-hostname <event-collector-host-or-ip> --prime-hostname <prime-hostname>

--hcm-f-hostname <hcm-f-hostname> --hcm-f-admin-password <hcm-f-admin-password> --ntp-servers <server1>,<server2>...
[ --admin-password <admin-password> --prime-admin-password <prime-admin-password> ]


Make note of the following guidelines while supplying variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of the hostname must not exceed 18 characters.

Prime hostname—In the above command, provide only the hostname against <prime-hostname> argument. Hostname must contain only lowercase characters. Do not enter the IP address. The value that you enter against the --prime-hostname argument must be the same hostname that you entered during installation of Prime Central.

Admin Password—In the above command, against the argument--admin-password, provide a password for all users that require a password on this VM. The admin password must be the same in all the five VMs. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

Prime Admin Password—Against the argument --prime-admin-password, provide a complicated password for users in the Prime Central VM. The prime admin passwords must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation.The password must follow the guidelines mentioned below:

Minimum 8 characters and maximum 12 characters

A character must not be repeated 3 times consecutively.

Must contain at least one uppercase letter (A-Z).

Must contain at least one lowercase letter (a-z)

Must contain at least one number (0-9)

Must contain at least one special character @~-

The special characters exclamation mark (!), apostrophe ('), quotation mark ("), slash (/), dollar sign ($), question mark (?), accent grave (`), or underscore (_) must not be used.

Must not contain cisco or any other combination of the word.

To see an example of the usage of the script, see Service Visualizer Installer—Example.

Infrastructure Monitoring Installer

Follow the procedure below to install Infrastructure Monitoring component. Here are some recommendations for installing Infrastructure Monitoring:

Provide the --admin-password argument.

Maintain the same VM root password across all the VMs.


Step 1 Log in as root user.

Step 2 Run cd hcm_installer/scripts/hcm_install_scripts

Step 3 Run ./im_install.py --im-hostname <infrastructure-monitoring-host-or-ip> --ec-hostname <event-collector-host-or-ip> --prime-hostname <prime-central-host-or-ip>

--ntp-servers <server1>,<server2>... --hcm-f-hostname <HCM-F-hostname-OR-IP> --hcm-f-admin-username <HCM-F Admin CLI Username> --hcm-f-admin-password <HCM-F Admin CLI Password> [ --admin-password <admin-password> ]


Make note of the following guidelines while supplying values for variables:

The hostnames of the components must not contain the special character _ (underscore).

The length of Infrastructure Monitoring hostname must not exceed 18 characters.

In the above command, against the argument --admin-password, provide a complicated password for users in the Prime Central VM. The password must be the same in all the five VMs. If different passwords are used, you run the risk of having to reinstall the components. If you do not specify the passwords in the command line argument, you will be prompted to supply one at the time of installation. The password must follow the guidelines mentioned below:

Minimum 5 characters and maximum 14 characters.

The special characters asterisk (*), hyphen (-) and percentage (%) must not be used.

To see an example of the usage of the script, see Infrastructure Monitoring Installer—Example.