Table Of Contents
Installing Cisco Multicast Manager
Solaris Installation Instructions
Creating the Installation Directory (Optional)
Running the Solaris Installation Script
Linux Installation Instructions
Creating the Linux Installation Directory (Optional)
Running the Linux Installation Script
Upgrading to Cisco Multicast Manager 2.5
Upgrading on Linux Using a CD or ISO Image
Upgrading on Linux Using a Tar File
Upgrading on Solaris Using a CD or ISO Image
Upgrading on Solaris Using a Tar File
Installing Cisco Multicast Manager
This chapter contains the following sections:
•
Solaris Installation Instructions
•
•
System Requirements
This section describes the system requirements for running Cisco Multicast Manager 2.5.
Operating Systems
Cisco Multicast Manager can run on Linux systems and on Sun Microsystems systems running Sun Solaris.
Linux
CMM 2.5 can run on the following Linux versions:
•
•
Sun Systems
CMM 2.5 can run on the following Sun Solaris versions:
•
•
•
Note
Supported Hardware Platforms
This section describes the minimum recommended hardware for running Cisco Multicast Manager 2.5 on a Linux system or a Sun Solaris system.
Linux
On Linux systems, the following hardware is supported:
•
A 2.4 GHz 64-bit processor is recommended for a large enterprise network (more than 500 devices).
•
•
Sun Microsystems Servers
Cisco Multicast Manager supports the following hardware on Sun Microsystems servers:
•
•
Note
Disk Space Requirements
CMM requires 300 MB of disk space.
Note
<INSTALLDIR>/mmtsys/sys/events.log
<INSTALLDIR>/mmtsys/sys/rmspolld.log
<INSTALLDIR>/httpd_perl/logs/error_log
Memory Requirements
•
•
Licensing
CMM 2.5 requires a license file, which is provided when you purchase the product. The license file enables the product features that you have purchased.
The license file can enable:
•
•
•
If one of the features is not enabled, then the menus in the user interface do not include selections that enable options provided with the feature.
The application license is contained in the license.key file.
The license.key file can be saved anywhere on the installation machine. During installation of CMM, the system prompts for the license key. If license.key file is present on the installation machine, then the path and filename of the license key must be entered.
If the license.key file is not present during installation, or the system has an invalid license file, then place the correct valid license file in the following directory:
On Solaris:
/opt/RMSMMT/mmtsys/sysOn Linux:
/usr/local/netman/mmtsys/sysThe file should be owned by mmtuser (chown mmtuser:mmtuser license.key) and be set to read-only (chmod 0444 license.key). The license is tied to the IP address of the CMM server.
TFTP Server
Cisco Multicast Manager requires that the server have TFTP enabled if you want to download router configurations and use the router config verification tool.
A TFTP directory should be created on the largest partition and then linked from the root directory as follows—assuming the directory was created under /usr: ln -s /usr/tftpboot /tftpboot.
For Linux ES/AS 4:
tftp-0.39-2
For Linux ES/AS 3:
tftp-0.39-0.EL3.1
After TFTP is installed, modify the /etc/xinetd.d/tftp file to enable the TFTP server.
Set the ownership and permissions as follows:
chown root:mmtuser tftpbootchmod 0775 tftpbootThen restart the xinetd process: /etc/init.d/xinetd restart.
For Solaris:
Comment out the tftpd line in the /etc/inetd.conf file to enable the TFTP server, then restart the inetd process.
Linux IP Address/Default Route
•
•
•
ifconfig eth0 x.x.x.xroute delete defaultroute add default gw x.x.x.x metric 1Solaris Installation Instructions
Complete these steps to install CMM 2.5 on a Sun Solaris system:
1.
2.
3.
4.
5.
Installing the License File
Copy the license.key file into an appropriate directory on the host machine. During installation, the interface will prompt you for the location of the license file. Enter the path where the license.key file is located. If the license file is invalid, or not present in the host, then after the installation is complete, copy the valid license file under the directory /opt/RMSMMT/mmtsys/sys with the owner as mmtuser, and then restart the CMM.
Creating the Installation Directory (Optional)
On Solaris systems, Cisco Multicast Manager must be installed in the /opt/RMSMMT directory, and requires approximately 300MB of disk space.
If there is not enough room in /opt, create the RMSMMT directory on another partition, then create a symbolic link to it from /opt. For example, log in as root and issue these commands:
# mkdir /space/RMSMMT# cd /opt# ln -s /space/RMSMMT RMSMMT# chown -h mmtuser:mmtuser RMSMMTIf you symbolically link /opt/RMSMMT to the actual installation directory as shown above, when the installation is complete, you must change directory to the actual installation directory. For example:
# cd /spaceand issue the following command:
# chown -R mmtuser:mmtuser RMSMMTOtherwise, the installation creates the directory and sets the ownership for you.
Mounting the CD-ROM
If you are mounting a DVD and the process vold is not running, you will need to manually mount the CD-ROM, use one of the following commands:
# mount -rt hsfs /dev/sr0 /cdromor# mount -rt hsfs /dev/dsk/c0t6d0s2 /cdromIf you are mounting an ISO CD-ROM image downloaded from Cisco.com, use the following command::
mount -F hsfs -o ro `lofiadm -a /export/temp/cmm25.iso` /mnt
Note
Unzipping the Tar File
If you are installing from the tar file, create a /tmp directory and place the tar file there:
# cd /tmp# gunzip -c mmt-sol-2.5-X-full.tar.gz | tar xvf -Running the Solaris Installation Script
To run the Solaris installation script:
Step 1
Step 2
# cd /cdrom/cdrom0#./install.shIf you are installing from the extracted tar file location, enter:
# cd /tmp/RMSMMT#./setup.shThe system issues a series of prompts.
Step 3
Example 1-1 shows sample output from the Solaris installation.
Example 1-1 Sample Output from the Solaris Installation Script
# /tmp/RMSMMT/# ./setup.shInstalling Cisco Multicast Manager Version 2.5Installing Cisco Route Manager Version 2.3.2Copyright (c) 2003-2007 Cisco Systems, Inc. All Rights Reserved.Each product must be purchased individually, however a single license can enableone or more of the applications.Have you obtained a license key? [y/n]: yPlease install the license file according to the release notes once this installation finishes.The application installs in /opt/RMSMMT. Do you wish to continue? [y/n]: yCreating mmtuser gid...The mmtuser group already existsCreating mmtuser uid...The mmtuser id already exists.Installing Apache...Installing Perl...Installing MIBS...Installing support files...Installing ciscomm to /etc/init.d...ln: /etc/init.d/ciscomm and /etc/rc0.d/K03ciscomm are identicalln: /etc/init.d/ciscomm and /etc/rc1.d/K03ciscomm are identicalln: /etc/init.d/ciscomm and /etc/rc3.d/S98ciscomm are identicalln: /etc/init.d/ciscomm and /etc/rcS.d/K03ciscomm are identicalInitializing IP Address database with reserved Multicast Addresses...Modifying httpd.conf file for this system...Configuring Trap Receiver and SNMP Agent...-eGetting Configuration Information for SNMP Agent=================================================-eAccess control Setup-e Description: SNMPv1/SNMPv2c read-only access community name-eThe community name to add read-only access for (default - public):-e Community name for read only access is public-eSystem Information Setup-e Description: This section defines some of the information reported in the-e "System" mib group-eThe physical Location of the system :-e Contact Information of the Administrator (default - root@):-eContact Information of the Administrator is root@-eGetting Configuration Information for Trap Receiver===================================================-eAccess control Setup-e Do you want to disable access control checks (y/n) (default - y):-eDisables the access control check and accepts all incoming Notification traps-eFollowing are the list of default OIDs the TRAP receiver is configured with-e1. ciscoIpMRouteMissingHeartBeats (1.3.6.1.4.1.9.10.2.3.1.0.1)-e 2. pimNeighborLoss (1.3.6.1.3.61.1.0.1)-e 3. CISCO-PIM-MIB Traps (1.3.6.1.4.1.9.9.184.2.0.*)-e 4. MSDP-MIB Traps (1.3.6.1.3.92.1.1.7.*)-e 5. ciscoMvpnMvrfChange (1.3.6.1.4.1.9.10.113.0.2)-e 6. iVMS Traps (1.3.6.1.4.1.15181.11.1.*)-eDo you want to add some other Trap OIDs with the default list (y/n) (default - n):-e Defualt Trap OIDs ConfiguredInstallation Finished.Would you like to install the license key now? [y/n]: yCisco Multicast Manager/Cisco Route ManagerLicense Installation UtilityCopyright (c) 2003-2007 Cisco Systems, Inc. All Rights Reserved.Enter license file: /opt/license.keyInstalling license...Testing license...Licensed to : CiscoIp address : 172.20.111.216Expire date : No expiration date.Features : MMT,VOS,MVPNDevice limit : 1000Starting the application...Sun Microsystems Inc. SunOS 5.8 Generic Patch February 2004going to start liblogcompleted to start liblog/opt/RMSMMT/httpd_perl/bin/apachectl startssl: httpd startedStarting the polling daemon...Sun Microsystems Inc. SunOS 5.8 Generic Patch February 2004Starting the CLI proxy daemon...Sun Microsystems Inc. SunOS 5.8 Generic Patch February 2004Starting SNMP Trap Receiver daemon...-e Starting SNMP Trap ReceiverStarting SNMP Agent daemon...-e Starting SNMP Agent
Linux Installation Instructions
Complete these steps to install CMM 2.5 on a Linux system:
1.
2.
3.
4.
5.
Installing the License File
Copy the license.key file into an appropriate directory on the host machine. During installation, the interface will prompt you for thelocation of the license file. Enter the path where the license.key file is located. If the license file is invalid, or not present in the host, then after the installation is complete, copy the valid license file under the directory /usr/local/netman/mmtsys/sys with the owner as mmtuser, and then restart the CMM.
Creating the Linux Installation Directory (Optional)
On a Linux system, install Cisco Multicast Manager in /usr/local/netman. On a Linux installation, Cisco Multicast Manager requires approximately 300 MB of disk space.
If there is not enough room in /usr/local, create the netman directory on another partition, then create a symbolic link to it from /usr/local. For example:
# mkdir /space/netman# cd /usr/local# ln -s /space/netman netman# chown -h mmtuser:mmtuser netmanIf you symbolically link /usr/local/netman to the actual installation directory as shown above, then when the installation is complete, you must change directory to the actual installation directory. For example:
# cd /spaceand issue the following command:
# chown -R mmtuser:mmtuser netmanOtherwise, the installation program creates the directory and sets the ownership for you.
Mounting the CD-ROM (Linux)
If you are mounting an actual physical CD-ROM, use one of the following commands:
For Red Hat Linux ES/AS 3:
# mount /dev/cdrom /mnt/cdromFor Red Hat Linux ES/AS 4:
# mount /dev/hdc /media/cdromIf you are mounting an ISO CD-ROM image downloaded from Cisco.com, use the following command:
# mount -t iso9660 -o loop image.iso /mnt/isoimage
Note
Unzipping the Tar File
If you are installing from the tar file, create a /tmp directory and place the tar file there:
# cd /tmp# gunzip -c mmt-lin-2.5-X-full.tar.gz | tar xvf -Running the Linux Installation Script
To run the Linux installation script:
Step 1
Step 2
# cd /cdrom/cdrom0#./install.shIf installing from the extracted tar file location enter:
# cd /tmp/netman#./setup.shThe system issues a series of prompts.
Step 3
Example 1-2 shows sample output from the Linux installation.
Example 1-2 Sample Linux Installation Output
# ./install.shInstalling CMM for LinuxAS4 okInstalling Cisco Multicast Manager Version 2.5Installing Cisco Route Manager Version 2.3.2Copyright (c) 2003-2007 Cisco Systems, Inc. All Rights Reserved.Each product must be purchased individually, however a single license can enable one or more of the applications.Have you obtained a license key? [y/n]: yPlease install the license file according to the release notes once this installation finishes.The application installs in /usr/local/netman. Do you wish to continue? [y/n]: yCreating mmtuser gid...The mmtuser group already existsCreating mmtuser uid...The mmtuser id already exists.Installing Apache...Installing Perl...Installing MIBS...Installing support files...Installing ciscomm to /etc/init.d.../bin/ln: `/etc/rc0.d/K03ciscomm': File exists/bin/ln: `/etc/rc1.d/K03ciscomm': File exists/bin/ln: `/etc/rc2.d/S98ciscomm': File exists/bin/ln: `/etc/rc3.d/S98ciscomm': File exists/bin/ln: `/etc/rc4.d/S98ciscomm': File exists/bin/ln: `/etc/rc5.d/S98ciscomm': File exists/bin/ln: `/etc/rc6.d/K03ciscomm': File existsInitializing IP Address database with reserved Multicast Addresses...Modifying httpd.conf file for this system...Configuring Trap Receiver and SNMP Agent...Getting Configuration Information for SNMP Agent=================================================Access control SetupDescription: SNMPv1/SNMPv2c read-only access community nameThe community name to add read-only access for (default - public):Community name for read only access is publicSystem Information SetupDescription: This section defines some of the information reported in the"System" mib groupThe physical Location of the system : SJContact Information of the Administrator (default - root@): cmm-dev@cisco.comGetting Configuration Information for Trap Receiver===================================================Access control SetupDo you want to disable access control checks (y/n) (default - y):Disables the access control check and accepts all incoming Notification trapsFollowing are the list of default OIDs the TRAP receiver is configured with1. ciscoIpMRouteMissingHeartBeats (1.3.6.1.4.1.9.10.2.3.1.0.1)2. pimNeighborLoss (1.3.6.1.3.61.1.0.1)3. CISCO-PIM-MIB Traps (1.3.6.1.4.1.9.9.184.2.0.*)4. MSDP-MIB Traps (1.3.6.1.3.92.1.1.7.*)5. ciscoMvpnMvrfChange (1.3.6.1.4.1.9.10.113.0.2)6. iVMS Traps (1.3.6.1.4.1.15181.11.1.*)Do you want to add some other Trap OIDs with the default list (y/n) (default - n):Defualt Trap OIDs ConfiguredInstallation Finished.Would you like to install the license key now? [y/n]: yCisco Multicast Manager/Cisco Route ManagerLicense Installation UtilityCopyright (c) 2003-2007 Cisco Systems, Inc. All Rights Reserved.Enter license file: /usr/local/license.keyInstalling license...Testing license...Licensed to : CiscoIp address : 172.20.111.239Expire date : No expiration date.Features : MMT,VOS,MVPNDevice limit : unlimitedStarting the application...going to start liblogcompleted to start liblog/usr/local/netman/httpd_perl/bin/apachectl startssl: httpd startedStarting the polling daemon...Starting the CLI proxy daemon...Starting SNMP Trap Receiver daemon...Starting SNMP Trap ReceiverStarting SNMP Agent daemon...Starting SNMP Agent
Changing the HTTPS Port
The server is configured by default to run on port 8080.
Step 1
Step 2
Linux:
/usr/local/netman/httpd_perl/conf/httpd.conf.Solaris:
/opt/RMSMMT/httpd_perl/conf/httpd.confStep 3
Example:<IfDefine SSL>Listen 8080</IfDefine><VirtualHost _default_:8080>Upgrading to Cisco Multicast Manager 2.5
You may upgrade from version 2.4 to 2.5 using a DVD, ISO image downloaded from Cisco.com,
or a tar file from the enterprise application bundle.
Upgrading on Linux Using a CD or ISO Image
Step 1
a.
For Red Hat Linux ES/AS 3:
# mount /dev/cdrom /mnt/cdromFor Red Hat Linux ES/AS 4:
# mount /dev/hdc /media/cdromb.
# mount -t iso9660 -o loop image.iso /mnt/isoimage
Note
Step 2
For a physical DVD:
cd /mnt/cdromFor an ISO image downloaded from Cisco.com:
cd /mnt/<isoimage folder >Step 3
Upgrading on Linux Using a Tar File
Step 1
# cd /tmp# gunzip -c mmt-lin-2.5-X-full.tar.gz | tar xvf -Step 2
# cd /tmp/netmanStep 3
Upgrading on Solaris Using a CD or ISO Image
Step 1
a.
# mount -rt hsfs /dev/sr0 /cdromor# mount -rt hsfs /dev/dsk/c0t6d0s2 /cdromb.
mount -F hsfs -o ro `lofiadm -a /export/temp/cmm25.iso` /mnt
Note
Step 2
For a DVD:
cd /cdrom/cdrom0For an ISO image downloaded from Cisco.com:cd /mnt/<isoimage folder>Step 3
Upgrading on Solaris Using a Tar File
Step 1
# cd /tmp# gunzip -c mmt-sol-2.5-X-full.tar.gz | tar xvf -Step 2
# cd /tmp/RMSMMTStep 3
Starting and Stopping CMM
To start the application:
On Solaris:
From the CMM home directory (by default, /opt/RMSMMT), run the S98mmt script.
On Linux:
From the CMM home directory (by default, /usr/local/netman), run the S98mmt script.
To stop the application, run the K98mmt script.
The S98mmt script also runs the S98mmtpolld script, which starts the polling daemon. The S98mmtpolld script can also be used as a watchdog script to ensure that the polling daemon is up and running. The root crontab configuration would be:
On Solaris:
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /opt/RMSMMT/S98mmtpolldOn Linux:
*/5 * * * * /usr/local/netman/S98mmtpolldThese entries will run the script every 5 minutes.
The default login user name is admin, and the default password is rmsmmt.
Note
During installation, the K98mmt script is installed in the /etc/rc0.d directory. This ensures that the polling daemon shuts down properly upon system reboot.
