Installing the Prime Network Gateway and Units Using the Installation Wizard
This chapter describes how to install the gateway and units using the GUI installation wizard, which is an alternative (and preferred) installation method to the CLI installation.
The following topics are covered in this section:
The installation wizard does not include installation of Operations Reports and the Prime Network Integration Layer.
Prerequisites for Using the Installation Wizard
Before you begin, verify that the following prerequisites are met:
- An X client application, such as Xming, is installed on the local machine on which you plan to launch the wizard.
- A Telnet/SSH client, such as PuTTY, is installed on the local machine on which you plan to launch the wizard, and X11 forwarding is enabled.
- All preinstallation tasks for the gateway and unit are completed. See Preparing for the Installation .
- The database files (linuxx64_12201_database.zip) are available in Cisco Prime Network 5.2 Disk 4.
- Prime Network 5.2 fresh installation will support only Oracle 12.2.0.1.
Launching the Installation Wizard
To launch the installation wizard:
Step 1 Launch the X client application (for example, Xming).
Step 2 As the root user, launch a terminal on the server where you want to install the Prime Network gateway.
Step 3 Insert Disk 1: New Install in the DVD drive. (See Installation DVDs).
Step 4 Mount the inserted DVD using the mount command, and move to the mount directory.
Step 5 In the mount directory, locate the install.bin file and run it:
This launches the installation wizard.
Step 6 Read the introduction and click Next. In the Installation Type window, you can choose the relevant installation:
Installing the Gateway with Embedded Database Using the Installation Wizard
The following procedure describes how to install a Prime Network gateway and an embedded database using the GUI installation wizard.
Step 1 Launch the installation wizard using the install.bin file on Disk 1: New Install. See Launching the Installation Wizard.
Step 2 Read the introduction and click Next.
Step 3 In the Installation Type window, select Express - Install Prime Network with Embedded Oracle Database and click Next.
Step 4 In the next four windows, provide the required user and installation folder information, as follows:
|
|
|
Operating System User Name Window
|
New Operating System user |
A username for the Prime Network operating system. This username will be used when connecting to the gateway using SSH and for other administrative purposes. |
This username is used as the basis for the installation directory and the database schema names. We recommend you to use pn52. In the documentation, use pnuser to represent the operating system user variable. |
Password |
A password for the Prime Network operating system user. |
— |
Prime Network User Window
|
Password |
A password for the Prime Network root user. |
The root username and password are used to log into the Prime Network GUI applications. Enter a password that complies with the password requirements listed in the text box at the top of the screen. |
Operating System “root” Password Window
|
Password |
A password for the operating system root user. |
|
Installation Folder Window
|
Please choose a folder |
Select an installation folder or use the default folder. |
The default installation directory is /export/home/OS-User. We recommend you to use the default directory. In the documentation, use $PRIME_NETWORK_HOME to represent the installation directory. |
Step 5 Click Next.
Step 6 Check the Prerequisites Summary window for items that are not marked [OK] and rectify them as needed (for example, add more disk space). Click Next.
Step 7 In the Gateway Installation Embedded Oracle Database window, enter the gateway IP address to be used for communication with the units, if it is different from the IP address that was automatically identified by the system.
Step 8 Select Suite-Integrated (if you are using Prime Network with Prime Central), or Standalone.
Note For suite-integrated systems, Prime Network Integration Layer must be installed. See Chapter 9, “Installing the Prime Network Integration Layer”.
Step 9 Provide the following information in the Embedded Database windows.
|
|
|
Embedded Database Window (1)
|
Database username |
Username for the Oracle database user, if you do not want to use the default username. |
Default is oracle. |
Database Server IP Address |
IP address of the database server (IPv4 or IPv6). The database server could be the gateway or a remote server. |
Default is the IP address of the gateway. |
Choose a database profile |
Select the database profile that represents your setup. |
See Creating an External Oracle Database for guidelines (the information also applies to embedded databases). Prime Network calculates memory and storage requirements based on this entry. |
Would you like to enable database auto-backup? |
[yes | no] |
If you enter No, you can enable automatic backups later using the emdbctl command. See the Cisco Prime Network 5.2 Administrator Guide. |
Embedded Database Window (2)
|
Database Zip Files Path |
Path to the directory in which the database zip files are located. |
Default is /. These files must be copied from Disk 4 of the Prime Network 5.2 installation DVDs. |
Database Home Directory |
Path to the database home directory. |
Default is /export/home/oracle. Must have a minimum of 9GB of disk space for oracle binaries Should not reside under the installation directory ($ PRIME_NETWORK_HOME). |
Database Data Files Path |
Path to the directory containing the datafiles ( oracle-datafiles-dir) |
Default is /export/home/oracle/oradata/anadb. |
Redo Logs File Path |
Path to the directory containing the redo files. |
Should not reside on the same disk as oracle-datafiles-dir. Use ext3 partition mounted with the default mount options. |
Archive Logs Files Path |
Path to the directory containing the archive log files. |
Should not reside on the same disk as oracle-datafiles-dir. |
Backup Data Files Path |
Path to the directory containing the backup data files. |
Should not reside on the same disk as oracle-datafiles-dir. |
Step 10 If you selected Suite-Integrated, you will be required to enter information enabling communication with Prime Central, including the Prime Central database server IP address, database port, database SID, database username and password. Click Next.
Step 11 In the Operations Reports Database (Infobright) windows, enter the information that will enable connection to the server on which the Infobright database is located and the folders for the Infobright data, then click Next.
|
|
|
Operations Reports Database (Infobright) Window
|
Infobright Database Server IP Address |
|
|
Root user password for SSH connection |
|
|
Infobright database server port |
|
|
Archive history size |
|
|
Backup history size |
|
|
Would you like to enable backup files creation? |
|
|
Operations Reports Database (Infobright) Folders Window
|
Path to folder for Infobright database data |
|
|
Path to folder for Infobright database cache data |
|
|
Path to folder for Infobright database backup data |
|
|
Path to folder for Infobright DLP staging area |
|
|
Note Operations Reports are only available to customers with Operations Reports license prior to May 2018. For re-installation of Operations Reports contact a Cisco customer support representative.
Step 12 In the Installation Setup Summary window, review and verify the information.
Step 13 Click Install. The installation procedure will take between 20-50 minutes to complete.
Step 14 When the installation is complete, you will receive a message indicating this. If the installation fails, you will receive a message with details about the failure.
The following logs are available after the installation:
- Installation logs—/var/adm/cisco/prime-network/logs/.
- Embedded database configuration logs—$ PRIME_NETWORK_HOME /local/scripts/embedded_oracle.
- Prime Network configuration logs—$PRIME_NETWORK_HOME/Main/logs.
Note Before launching Prime Network in the Windows 2008 server from Prime central, ensure that the host file is updated with correct host IP address to resolve the hostname.If hostname is not configured properly, then the Prime Network installation fails.
Installing the Gateway with External Database Using the Installation Wizard
The following procedure describes how to use the GUI installation wizard to install a Prime Network gateway that is connected to an external database.
Step 1 Launch the installation wizard using the install.bin file on Disk 1: New Install. See Launching the Installation Wizard.
Step 2 Read the introduction and click Next.
Step 3 In the Installation Type window, select Custom: Install Prime Network with External Oracle Database and click Next.
Step 4 Provide the required user and installation folder information.
|
|
|
Operating System Username Window
|
New Operating System User |
A username for the Prime Network operating system. This username will be used when connecting to the gateway using SSH and for other administrative purposes. |
This username is used as the basis for the installation directory and the database schema names. We recommend you use pn52. In the documentation, we use pnuser to represent the operating system user variable. |
Password |
A password for the Prime Network operating system user. |
— |
Prime Network User Window
|
Password |
A password for the Prime Network root user. |
The root username and password are used to log into the Prime Network GUI applications. Enter a password that complies with the password requirements listed in the text box at the top of the screen. |
Operating System “root” Password Window
|
Password |
A password for the operating system root user. |
|
Installation Folder Window
|
Please choose a folder |
pn-installation-dir |
The default installation directory is /export/home/ OS-User. We recommend you use the default directory. This default home directory is referred to as $PRIME_NETWORK_HOME. |
Step 5 Click Next.
Step 6 Check the Prerequisites Summary window to see if any items do not say [OK] and rectify them as needed (for example, add more disk space). Once verified, click Next.
Step 7 In the Gateway Installation window, enter the gateway IP address to be used for communication with the units, if it is different from the IP address that was automatically identified by the system.
Step 8 Select Suite-Integrated (if you are using Prime Network with Prime Central), or Standalone.
Note For suite-integrated systems, Prime Network Integration Layer must be installed. See Chapter9, “Installing the Prime Network Integration Layer”
Step 9 Provide the following information in the External Database window.
|
|
|
Database Server IP Address |
IP address of the database server. |
— |
Database Port |
oracle-listener-port |
Default port is 1521. |
SID |
oracle-SID |
— |
Database Administrator User Name |
oracle-admin-user |
Database user who can perform administrative tasks. |
Database Administrator Password |
oracle-admin-password |
— |
Database Data Files Path |
oracle-datafiles-dir |
— |
Does your database require an encrypted connection? |
[yes | no] |
If you answer yes, you will be prompted for encryption method and algorithm after clicking Next. |
Do you want Prime Network to create the users? |
[yes | no] |
If you answer yes, Prime Network will create the database users with default usernames. |
Step 10 If you specified that your database needs encryption, you are prompted for an encryption method and algorithm:
- Encryption Method—Accepted, Requested, or Required (default is Required).
- Encryption Algorithm—Choose from the drop-down list.
Step 11 If you specified that you did not want Prime Network to create the database users, the External Database User Configuration window opens.
External Database User Configuration Field
|
|
|
Database schema “main” Username |
name, e.g., PN52 |
|
Database schema “dwe” Username |
name _dwe |
e.g., PN5.2_dwe |
Database Administrator Username |
name _admin |
Name for admin database schema |
Database Reports main username |
name _rep |
Name for reports database schema |
Database schemes passwords |
password |
Password used for all schemas except the Event Archive |
Database EP schema username |
name _ep |
Name for Event Archive database schema |
Database EP Reports username |
name _ep_rep |
Name for older reports database schema |
Database EP Schema Password |
ep-password |
Password for Event Archive schema |
Step 12 If you selected Suite-Integrated, you will be required to enter information enabling communication with Prime Central, including the Prime Central database server IP address, database port, database SID, database username and password.
Step 13 In the Operations Reports Database (Infobright) windows, enter the information that will enable connection to the server on which the Infobright database is located and the folders for the Infobright data, then click Next.
|
|
|
Operations Reports Database (Infobright) Window
|
Infobright Database Server IP Address |
|
|
Root user password for SSH connection |
|
|
Infobright database server port |
|
|
Archive history size |
|
|
Backup history size |
|
|
Would you like to enable backup files creation? |
|
|
Estimate your database profile |
Select the database profile that represents your setup. |
See Creating an External Oracle Database for guidelines. |
Operations Reports Database (Infobright) Folders Window
|
Path to folder for Infobright database data |
|
|
Path to folder for Infobright database cache data |
|
|
Path to folder for Infobright database backup data |
|
|
Path to folder for Infobright DLP staging area |
|
|
Note Operations Reports are only available to customers with Operations Reports license prior to May 2018. For re-installation of Operations Reports contact a Cisco customer support representative.
Step 14 In the Installation Setup Summary window, review and verify the information.
Step 15 Click Install. The installation procedure will take between 20-50 minutes to complete.
Step 16 When the installation is complete, you will receive a message indicating this. If the installation fails, you will receive a message with details about the failure.
The following logs are available:
- Installation logs—/var/adm/cisco/prime-network/logs/.
- Configuration logs—$PRIME_NETWORK_HOME/Main/logs.
Installing a Unit Using the Installation Wizard
The following procedure describes how to install an additional unit using the GUI installation wizard.
Note Ensure that the OS version of unit and gateway is same while adding the unit to the gateway.
Note Before starting the unit installation, ensure that the gateway to which the unit will be connected is up and running.
Step 1 Launch the installation wizard using the install.bin file on Disk 1: New Install. See Launching the Installation Wizard.
Step 2 Read the introduction and click Next.
Step 3 In the Installation Type window, select Add Unit and click Next.
Step 4 Provide the required user and installation folder information.
|
|
|
|
Operating System User Name |
The same operating system username as is configured for the gateway. |
— |
Password |
OS-User-password |
— |
Prime Network Administrator User Window
|
Prime Network Administrator User Name |
admin-username |
User name of the administrator user for access to the various Prime Network applications. |
Password |
admin-password |
This is the password for the Prime Network admin user, which is used to log into the Prime Network applications. |
Installation Folder Window
|
Please choose a folder |
The path to the installation directory. |
This should be the same installation folder as was specified for the gateway. |
Step 5 Check the Prerequisites Summary window to see if any items do not say [OK] and rectify them as needed (for example, add more disk space). Once verified, click Next.
Step 6 In the Unit Installation window, enter the following:
|
|
|
Gateway IP Address |
The gateway IP address to be used for communication with the units. |
Make sure the gateway is up and running before proceeding. |
Prime Network User OS Password on Gateway |
OS-User-password |
— |
Unit IP Address |
unit-ip-address |
— |
Mode |
[Active Unit | Standby Unit] |
Active units are started after they are added; standby units start when a failover occurs. |
Unit Protection |
[Enable | Disable] |
Enable or disable unit high availability protection. |
Unit Name |
unit-name |
— |
Unit Protection Group |
unit-protection-group |
The protection group to which the unit belongs. |
Main Schema Database IP Address (optional) |
FaultDatabase-ip-address |
Providing this information protects against incompatible gateway and database interface types. |
Step 7 In the Pre-installation Summary window, verify the information.
Step 8 Click Install to start the Unit installation.
Step 9 When the installation is complete, click Done.
The following logs are available:
- Installation logs—/var/adm/cisco/prime-network/logs/.
- Configuration logs—$PRIME_NETWORK_HOME/Main/logs.