Installing a Cisco Prime Network Unit

Transcription

1 CHAPTER 9 This chapter covers the typical installation of a Cisco Prime Network unit. This chapter includes: Before You Begin, page 9-1 Installing the Unit, page 9-2 Verifying the Unit Processes, page 9-5 Verifying the Unit Installation, page 9-7 Configuring the Unit, page 9-8 What s Next?, page 9-8 Before You Begin Before starting the unit installation, verify that: The unit meets all requirements specified in Cisco Prime Network Unit Installation Requirements, page 1-6. The time set on the clocks of all units in the setup is the same. The maximum difference allowed between the different clocks is 4 minutes. You will install the correct Cisco Prime Network version and build. Enter the./install.pl -version command, which returns the following output: Stream name Build date and time Build owner Version and build number For example: install.pl -version Cisco Prime Network install version , built on Thu May 1 11:34:03 IDT 2010 BID: SOL_NETWORK3.8_IL_ _0504 BST: dev.ana3.8 BU: cwadmin 9-1

2 Installing the Unit Chapter 9 Installing the Unit Complete the following steps to install the Cisco Prime Network unit and the tools that are required for unit functionality, including JDK and Active Perl 5.8.6: Step 1 Insert Disk 1: New Install in the DVD drive. (See Installation DVDs, page 1-18.) Step 3 Step 4 Step 5 Open a Telnet or SSH session to the unit and log in as the user root. Check the unit prerequisites, such as the required disk space. See Cisco Prime Network Unit Installation Requirements, page 1-6. Back up and remove the old version of the unit (if an older version exists). For backup procedures, see the Cisco Prime Network 3.8 Administrator Guide. To change directories to the CD directory, enter: cd /cdrom/cdrom0/server Step 6 To install the Cisco Prime Network unit, complete one of the following substeps: a. For a new Cisco Prime Network 3.8 installation, enter the following command: perl./install.pl -user network-user You must enter the same network-user that you used when you installed the gateway. (If the gateway and unit have different usernames, the unit will not start.) For example, if the name of the user is network38, enter: perl./install.pl -user network38 b. If you are installing a new Cisco Prime Network 3.8 unit for a migrated Cisco Prime Network gateway, enter the following command: perl./install.pl -user sheer -dir /export/home/sheer4 The installation of the unit starts. This process might take a while. For information on the Cisco Prime Network environment created during installation, see Appendix A, Folders Created in Cisco Prime Network. Step 7 Step 8 After the installation is complete, you will be prompted to configure Prime Network. Enter yes to continue to Step 11 or no to configure later using the network-conf command. If you installed Cisco Prime Network on Linux, verify that ports are redirected by entering the following as the root user: iptables -L -t nat The result should contain the following rows: REDIRECT udp -- anywhere anywhereudp dpt:snmptrap redir ports 1162 REDIRECT udp -- anywhere anywhereudp dpt:syslog redir ports 1514 REDIRECT udp -- anywhere anywhereudp dpt:tftp redir ports 1069 REDIRECT udp -- anywhere anywhere udp dpt:snmptrap redir ports 1161 If not, enter the following: iptables -t nat -A PREROUTING -p udp --dport 162 -j REDIRECT --to-port 1162 iptables -t nat -A PREROUTING -p udp --dport 514 -j REDIRECT --to-port 1514 iptables -t nat -A PREROUTING -p udp --dport 69 -j REDIRECT --to-port

3 Chapter 9 Installing the Unit service iptables save iptables -t nat -A PREROUTING -p udp --dport 161 -j REDIRECT --to-port 1161 Step 9 Step 10 Step 11 Open a Telnet or SSH session to the unit and log in as network-user (where network-user is the operating system user account for the Cisco Prime Network application, created when Cisco Prime Network is installed). After logging in as the new user (network-user), enter the following command: network-conf At the Prime Network Configuration Utility screen, choose Set machine as Prime Network unit. Use the down arrow key to choose a machine as the unit, then press Enter. Prime Network Configuration Utility 1 Set machine as Prime Network unit. 2 Set machine as Prime Network gateway. q Quit Press Enter to choose. +Is NTP configured on this machine? (yes,no) yes Step 12 The Cisco Prime Network configuration utility configures the system by running a number of procedures: - Writing log to /export/home/network38/main/logs/network-conf log - Killing all Java/Perl process belonging to user network38 [OK] a. You are prompted to enter the IP address of the gateway and verify the input: - Enter the gateway IP address: IP-address Please make sure that the gateway is up and running before proceeding - Checking port reachability on the Prime Network GW [OK] If you are adding the unit to a Cisco Prime Network gateway configured for local redundant HA, either the Veritas gateway HA (see Chapter 6, Installing a Cisco Prime Network Gateway and Embedded Database in a Veritas High Availability Configuration ), or the Red Hat Cluster Suite/Oracle Advanced Data Guard (ADG) gateway HA (see Chapter 8, Installing a Cisco Prime Network Gateway and Embedded Database in a Red Hat Cluster Suite and Oracle Active Data Guard High Availability Configuration ), enter the floating IP address for the gateway, not the physical one. b. Enter the root user password: - Enter the password for OS root user: password c. If you install the unit on VMWare configured with ESX, the following message appears. Be sure to synchronize the unit s clock with the gateway clock before loading any AVMs on the unit: *** This server's clock is controlled by the VM management. Please make sure that it is synchronized with the Prime Network GW server before loading any AVMs on it. *** - Setup is updating the configuration directories, this might take a while - Adding leaf avm99/services to registry [OK] - Adding leaf avm99/services/registry to registry [OK] - Adding to avm99/services/registry/goldensource [OK] 9-3

4 Installing the Unit Chapter 9 d. If the installer detects more than one IP address configured on the unit, one of the following prompts will appear, depending on whether the gateway has connectivity to the unit If the unit has connectivity to the gateway, you are prompted to choose one, for example: + Detecting the network interfaces - Multiple network interfaces detected on host. Please select a single interface: Choose [1-3]: 1 If the unit does not have connectivity to the gateway, you are asked whether you want to continue: - The gateway has no connectivity to the chosen ip. The unit may be behind NAT, do you wish to proceed? (yes,no) [default yes] If the unit is connected to a gateway with IPv4 and IPv6 interfaces (dual stack), a second listener must be added to the unit. See the Configuring Dual Listeners procedure on page 9-6. e. Enter the administrator username and password: - Enter the Prime Network administrator username(root): username - Enter the Prime Network administrator password: password - Removing old SSH keys - Connecting to GW to get SSH keys - GW SSH keys copied successfully. + Detecting the network interfaces - Adding unit to gateway f. Select the Unit Protection Group name: -Please select the unit protection group name: 1. Default - pg Choose [1-3]: 1 default-pg Protection Group selected -Is this a standby unit? (yes,no) [default no] - Enter a unique name for this unit: username - Enable Unit Protection? (yes,no) [default yes] Database interface validation finished. Defults values should be used. + Updating local registry - Adding leaf avm99/services/os to registry [OK] - Adding localhost to avm99/services/os/localhost [OK] + Log was written to /export/home/network38/main/logs/network-conf log + Done setting the machine as unit. + Would you like to start Prime Network unit? (yes,no) [default yes] Starting Prime Network Unit... After you run the network-conf command on the unit, if the SSH keys are not retrieved automatically within 60 seconds, the following message is displayed: Connection to gateway-ip-address failed. 60 seconds timeout exceeded. To resolve this issue, verify that the unit can reach port 6081 on the gateway. Step 13 If required, you can change the NIC; use the choose_nic.pl tool to choose any IP address defined in the operating system. 9-4

5 Chapter 9 Verifying the Unit Processes Figure 9-1 Change the Default Route to the Gateway Verifying the Unit Processes The status command verifies that the following unit processes are up and running: AVM 0 High availability/switch process AVM 25 Event persistence AVM 83 Internal use; used as a TFTP server by Change and Configuration Management AVM 99 Management process AVM 100 Prime Network Event Collector (AEC) process secured connectivity daemon At this point in the installation, no AVMs have been added. When you add AVMs and assign VNEs to them, they appear as AVM XXX, where XXX is the number assigned to the AVM. To check the status of all processes and daemons, enter: status The output lists all processes. For each AVM process that is checked, the status command displays, in brackets, the number of exceptions found in the total number of log file lines for that process. For example, the information for AVM 0 is [OK 0/32]; that is, 0 exceptions in the 32 log file lines that were checked: = Welcome to server-name, running Cisco Prime Network unit (v3.8 (build number)) = Checking for services integrity: - Checking if host's time server is up and running [OK] - Checking if secured connectivity daemon is up and running [OK] + Detected AVM99 is up, checking AVMs - Checking for AVM83's status [OK 0/19] - Checking for AVM0's status [OK 0/32] - Checking for AVM100's status [OK] - Checking for AVM25's status [OK 0/25] 9-5

6 Configuring Dual Listeners Chapter 9 Configuring Dual Listeners If the unit connects to a gateway with multiple interfaces (dual stack), the installer asks you to specify the interface that should be used. (See Step d in the Installing the Unit procedure on page 9-2.) The question is asked when the gateway has multiple interfaces (dual stack) and the unit is installed with interface type that differs from the interface on which the database is installed. For example, the gateway and database are installed on an IPv4 interface. The gateway also has an IPv6 interface, and the unit only has an IPv6 interface. To add the unit, the database must be configured with dual listeners and an interface that allows the unit to communicate with the database. To add a listener to an Oracle Embedded database installation: Step 1 Step 3 Step 4 As the network-user, log into the Cisco Prime Network gateway. Change to the embedded database directory: cd Main/scripts/embedded_db Run the following perl script: add_oracle_listener.pl Answer the script's questions. Is the database installed on a remote server? (yes,no) If you enter yes, the following response appears: Provide the new IP Address to be supported by the listener. Enter the database IP address that the new listener should use. If you enter no, the following response appears: The following network interfaces were detected on this host. Please select a single interface to be used by the new listener: Select the address to be added to the listener. To add a listener to an Oracle external database installation: Step 1 Step 3 Step 4 As the Oracle user, log into the Oracle database. Change to the Oracle home directory: cd $ORACLE_HOME/network/admin Add the new address to the listener.ora to Stop and then start the listener. In dual-stack gateway installation, redundant units must be of same IP type as the unit. In other words, an IPv4 redundant unit cannot replace an IPv6 unit. 9-6

7 Chapter 9 Verifying the Unit Installation Verifying the Unit Installation The following sections describe how to check the Cisco Prime Network unit installation: Cisco Prime Network Version Information, page 9-7 Key Directories and File Configuration, page 9-7 Registry Configuration, page 9-8 Golden Source Configuration, page 9-8 Cisco Prime Network Version Information Use this procedure to view the version of Cisco Prime Network installed on the unit and to verify that the major components of the Cisco Prime Network system are located correctly and are running. This test also checks additional characteristics of the installation, such as directories and classes. If there are any files missing or problems with the configuration, this check fails. Step 1 On the unit, enter: status Confirm that the correct version of Cisco Prime Network has been installed. The following is an example of the message that should be displayed: = Welcome to server-name, running Cisco Prime Network unit (v3.8 (build number)) = Key Directories and File Configuration Use this procedure to verify that key directories and files exist in the setup. In the ~/Main directory, confirm that: The scheme subdirectory exists and contains the correct scheme files. The scripts and UNIX subdirectories were created correctly. Successful Result The scheme subdirectory exists. The scripts and UNIX subdirectories exist. If Failure Occurs Rerun the installation. 9-7

8 Configuring the Unit Chapter 9 Registry Configuration To verify that the registry directory has been created correctly and contains the necessary files, browse to the ~/Main/registry directory on the server. Successful Result The registry directory exists and contains the necessary files. If Failure Occurs Rerun the installation. Golden Source Configuration Use this procedure to verify that the Golden Source was configured correctly on the unit. Step 1 On the server, locate and open the ~/Main/registry/avm99.xml file. Confirm that the file contains an entry for the key parent, which is the value of the IP address of the gateway. Successful Result The file contains an entry for the key parent, which is the value of the IP address of the gateway. If Failure Occurs Rerun the installation. Configuring the Unit At this point, the unit is installed and ready to host VNEs. For information on setting up AVMs and VNEs using Cisco Prime Network Administration, see the Cisco Prime Network 3.8 Administrator Guide. Before creating any AVMs on the unit, the transport uplinks must be in place. What s Next? After installing the gateway and the units, the system is up and ready to use. You can now install the client application to enable users to view the network. See Chapter 10, Installing Cisco Prime Network Clients. 9-8