Installation Guide for the Cisco Mobile Wireless Transport Manager 6.1 - Installing the MWTM on Linux [Cisco Mobile Wireless Transport Manager]

Table Of Contents

Installing the MWTM on Linux

Overview of the Installation Process

Installation Prerequisites

Installing the MWTM Server and Client on Linux

Installing the MWTM Server on Linux

Installing the MWTM Client on Linux

Installing the MWTM Server Only on Linux

Installing the MWTM Client on Linux Using the Web Server

Verifying MWTM Installation

Checking for Error Messages

Viewing Package Information for the MWTM Server on Linux

Verifying the Installation Directories

Starting the MWTM on Linux

Starting the MWTM Server on Linux Immediately After Installation

Starting the MWTM Server on Linux from the Command Line

Starting the MWTM Client on Linux

Uninstalling the MWTM

Overview of the Uninstallation Process

Running the Uninstall Tool on Linux

Installing the MWTM on Linux

This chapter describes how to install the MWTM server software on a Linux system. It also provides information about verifying the MWTM installation and uninstalling and reinstalling the MWTM on Linux.

This chapter includes the following sections:

•Overview of the Installation Process

•Installation Prerequisites

•Installing the MWTM Server and Client on Linux

•Installing the MWTM Server Only on Linux

•Installing the MWTM Client on Linux Using the Web Server

•Verifying MWTM Installation

•Starting the MWTM on Linux

•Uninstalling the MWTM

Overview of the Installation Process

When you start the MWTM install tool, you will see these installation options:

•Installing the MWTM server and client—Use this option when you want the MWTM server and client software to reside on the same system. The MWTM uses separate server and client install tools. If you choose to install both the server and client, the server script runs first, followed immediately by the client script.

Note The MWTM client is unsupported on Linux. This is because Cisco Systems cannot exhaustively test the client side of all installations.

•Installing the MWTM server—Use this option when you want to install only the MWTM server software on this system.

The MWTM server software consists of the following Linux Red Hat Package Manager (RPM) packages:

•CSCOmwtm-s—MWTM Server

•CSCOmwtm-c—MWTM Client

•CSCOmwtm-jre—Java package

•CSCOmwtm-web—Web server and Tomcat packages

•CSCOopenssl—OpenSSL package

When the MWTM install tool prompts you for a response, it displays the default value for each prompt in square brackets [ ]. To accept the default value, press Return. (When in doubt, accept the default.)

The MWTM also verifies the availability of all values, such as port numbers, before accepting them.

To stop the MWTM install tool at any time, press Ctrl-C.

If you attempt to install the MWTM in one window while installing another product in another window, the MWTM installation will fail. If this situation occurs, wait until all other product installations are complete, then enter the following command from the top of the MWTM CD image:
./uninstall.sh -n
This command removes all MWTM components and restores your system to a clean state. Then reinstall the MWTM.

Installation Prerequisites

Before you run the MWTM install tool:

•Make sure your Linux system meets the requirements listed in Server System Requirements, page 1-7.

•Determine how you want the MWTM to receive SNMP traps. If you want the MWTM to receive traps natively, determine whether MWTM is to receive traps on the standard UDP port number 162 or on another port. For example, if your ITPs have been configured to send traps to a different port, or if trap multiplexing devices and NMS applications in your network have been configured to send traps to a different port, you need to specify that port number when prompted by the MWTM install tool.

•Determine whether you want to configure MWTM Security Services, and whether you want local-based or Linux-based authentication. For more information, see the "Configuring MWTM User-Based Access" section in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1.

•Determine whether CiscoWorks is installed on your system, whether you want to integrate the MWTM with CiscoWorks, and the name and port number for the CiscoWorks web server. The default port number is 1741.

•Determine whether you want the MWTM server to automatically discover your network the first time the server starts after installation. If so, determine the name or IP address of the node you want to use as a seed node. For more information about the discovery process and how to use seed nodes, see the "Discovering Your Network" section of the User Guide for the Cisco Mobile Wireless Transport Manager 6.1.

Installing the MWTM Server and Client on Linux

This procedure assumes that you have not already installed the MWTM server or client on this workstation. If you have already installed the MWTM server or client on this workstation, some steps might be added, some might be different, and some might be unnecessary and ignored by the MWTM.

The MWTM uses separate server and client installation scripts. If you choose to install both the server and client, the server script runs first, followed immediately by the client script.

Installing the MWTM Server on Linux

Installing the MWTM server requires the following actions, in this order. Many of these steps are partially or fully automated.

1. Preliminary Activities

2. Starting the Install Tool

3. Enabling TFTP

4. Selecting the TCP/IP Address for the MWTM Server

5. Selecting the TCP/IP Address for the MWTM Server

6. Reviewing Your Selections

7. Checking Disk Space Usage

8. Checking Release and Upgrade Information

9. Selecting Express or Standard Installation

10. Selecting the Directory for Installation

11. Checking for Available Ports

12. Selecting a TCP Port for the Web Server

13. Selecting a TCP Port for the JSP Server

14. Selecting a TCP Port for the Naming Server

15. Reviewing Your Selections

16. Configuring SNMP Traps

17. Configuring Security Services

18. Choosing Network Types

19. Discovering your Network

20. Concluding Server Installation

21. Viewing the Installation Log

22. Verifying MWTM Installation

Preliminary Activities

Complete these preliminary steps:

Note These steps include logging in as the root user. As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands you use. If you are a relatively inexperienced Linux user, limit your activities as the root user to the tasks described in this guide.

Step 1 If you have not already logged in, log in as the root user:
> login: root
> Password: root-password 
If you are already logged in, but not as the root user, use the su command to change your login to root:
# su
# Password: root-password
Step 2 Mount the DVD-ROM drive, as described in Appendix A, "Mounting and Unmounting the DVD-ROM Drive for Installations on Solaris or Linux."

Step 3 Change to the mounted directory using the cd command:
# cd /cdrom/MWTM61/linux
or
# cd /cdrom/cdrom0/linux
Starting the Install Tool

In this step you start the install tool and select the appropriate installation option.

Step 1 Start the install tool by entering the following command:
# ./setup.sh
or
# ./setup.sh -i
Note If you are installing the MWTM using an NFS-exported DVD-ROM drive, image checking is highly recommended, however it can take several hours to complete. To avoid this problem, enter ./setup.sh -i, which disables image checking.

Step 2 The MWTM install tool displays the installation menu:
1) Review README File First (Recommended)
2) Install MWTM Server and Client (Client Unsupported)
3) Install MWTM Server
4) Exit Setup
Please choose an option -> 
Choose one of the following installation options:

•To read the latest information about the MWTM in the README file, enter 1, then press Enter.

The README file contains late-breaking information about the MWTM that might not be found in the other product documentation.

•To install both the MWTM server and client, enter 2, then press Enter.

The MWTM uses separate server and client install tools. If you choose to install both the server and client, the server script runs first, followed immediately by the client script.

Note The Linux client works with many distributions, but it is not formally supported. Use it at your own discretion.

You can also install the Linux client from the MWTM web interface (for details, see Installing the MWTM Client on Linux Using the Web Server).

•To install the MWTM server alone, enter 3, then press Enter.

•To exit the install tool, enter 4, then press Enter.

If you selected option 2 or 3, the install tool displays information similar to the following:
===================- MWTM Server Install Tool Started -==================
Started : date, time
Host    : Linux your_MWTM_server
Version : 6.1.0
========================================================================
INFO: Checking UID...  root,    OK.
where your_MWTM_server is the name of your MWTM server.

The install tool now performs a system-requirements check to ensure that all requirements are met. Information similar to the following appears:
=============================================================
=================- System Requirements Check -===============
=============================================================
INFO: Checking Host Operating System...Linux, OK.
INFO: Checking Operating System Version... 4, OK.
INFO: Checking for RHEL Update Number... 4, OK.
INFO: This product requires:
	RAM	       2048 MB
	SWAP	       2048MB
	CPU		   1024 MHz
INFO: Checking RAM...  2048 MB OK
INFO: Checking Swap... 2048 MB OK
INFO: Checking CPU... 2 x 1005 MHz OK
If a previous MWTM version is installed, a message similar to the following appears:
INFO: Version on System: MWTM 6.0
INFO: Available Latest Version: MWTM 6.1
If any requirement is missing, a warning message appears. For a list of all system requirements, see Server System Requirements, page 1-7.

If you are performing an upgrade, one of the following messages appear:
INFO: Upgrading from MWTM version 6.0 to MWTM version 6.1...
or
INFO: Upgrade from MWTM version 5.0 to MWTM version 6.0 supported.
Enabling TFTP

The MWTM checks to see if TFTP is installed and enabled on the system.

•If the TFTP server on this system is installed and enabled, the MWTM installation program displays the following messages and prompt:
============================================================
====================- TFTP Server Check -===================
============================================================
INFO: Checking TFTP Server...  Enabled
Installation continues with Concluding Server Installation.

•If the TFTP server on this system is not enabled, the MWTM installation program displays the following messages and prompt:
INFO: Checking TFTP Server...  Not Installed
WARNING: The TFTP server on this system is not installed.
INFO: If you plan to use this system as a TFTP server to send
INFO: configuration files to ITP devices, install and enable
INFO: the TFTP server.
•If the TFTP server on this system is installed but not enabled, the MWTM installation program displays the following messages and prompt:
INFO: Checking TFTP Server...  Not Enabled
WARNING: The TFTP server on this system is not enabled.
INFO: If you plan to use this system as a TFTP server to send
INFO: configuration files to ITP devices, enable the TFTP server
INFO: and ensure that it is working properly.
INFO: Check the /etc/xinetd.d/tftp file for the entries:
    disable = no and user = rootCheck the specified line in the etc/inetd.conf file, 
then press Return.
Selecting the TCP/IP Address for the MWTM Server

The install tool now performs a TCP/IP port usage check. Information similar to the following appears:
=================================================
=============- TCP/IP Address Check -============
=================================================
The server must bind to a specific IP address. This address will be used 
by any remote client connecting to the server.
Available IP addresses
----------------------
172.16.0.0
172.31.255.255
Enter IP address to use for client communications: 
Step 1 Enter the IP address that you want to use, choosing from the list of available IP addresses, then press Enter.

If you are performing an upgrade, or if only one IP address is available, you are not prompted to enter an IP address, as the system uses the previous configuration or single IP address to make that determination, and provides output similar to:
Using 172.31.255.255 for client communications
Checking the TCP/IP Port Usage for the MWTM Server

The install tool now performs a TCP/IP port usage check. Information similar to the following appears:
============================================================
=================- TCP/IP Port Usage Check -================
============================================================
INFO: This product uses these port numbers by default:
INFO:   [ 1] Server Name         : your_MWTM_server
INFO:   [ 2] Web Server          : 1774/tcp
INFO:   [ 3] JSP Server          : 1775/tcp
INFO:   [ 4] Naming Server       : 44742/tcp
INFO: Checking the system for available ports to see if these are in use...
INFO: Checking port   1774 for Web Server   ... Available.
INFO: Checking port   1775 for JSP Server   ... Available.
INFO: Checking port  44742 for Naming Server... Available.
where your_MWTM_server is the name of the MWTM server.

If any ports are in use, you receive prompts for any ports that need to be configured. However, if you are performing an upgrade, the system automatically uses ports defined in the previous installation, and skips to Checking Disk Space Usage.

Reviewing Your Selections

The install tool now displays information similar to the following:
========================================================
=================- MWTM Server Summary -================
========================================================
INFO: The following parameters will be used:
INFO:   [1] Server Name     : your_MWTM_server
INFO:   [2] Web Server      : 1774/tcp
INFO:   [3] JSP Server      : 1775/tcp
INFO:   [4] Naming Server   : 44742/tcp
Press Return to continue ->
where your_MWTM_server is the name of the MWTM server.

Step 1 Press Enter. The MWTM now checks for disk space usage.

Checking Disk Space Usage

The MWTM installation tool now attempts to determine whether there is adequate space in the default installation directory, /opt, to install the MWTM server, and displays information similar to the following:
============================================================
================- Disk Space Usage check -==================
============================================================
INFO: For this product the default disk space requirements are:
        /opt                   1024 MB
        /var/lib/rpm             1 MB
        /var/tmp                 1 MB
        /tmp                     1 MB
INFO: Checking default disk space requirements... OK.
============================================================
Note The /var/lib/rpm directory is the default on most devices, but might vary depending upon your device set up.

•If there is adequate space, installation now continues.

•If there is not adequate space, the MWTM install tool asks you to specify a different directory. When you have specified a different directory, installation continues.

The MWTM install tool also checks the /var/sadm directory to determine whether there is adequate space. If there is not adequate space on any of these directories, the following message appears:
INFO: There is insufficient space in </directory> for an installation
INFO: to proceed. Disk Space of at least <x> MB
INFO: is required for the install. 
Cannot continue...
The installation process stops and exits.

If errors or warnings are encountered up to this point, you might receive the following message:
System does not qualify for a Server Install. Found Errors/Warnings during system check! 
Do you want to continue to install the MWTM - Server? (y/n)?
Do either of these:

•To continue with installation, enter y. The following warning appears:
WARNING: Installing the MWTM - Server without basic requirements  
WARNING: may restrict you to use some of the MWTM - Server features.
•To stop installation, enter n. The installation stops and exits.

Checking Release and Upgrade Information

The MWTM installation tool checks your release for all components and displays information similar to the following:
INFO: Checking your release... All components present.
The MWTM now checks for existing releases. If no existing releases are present:
INFO: Checking for existing product tree... None.
Or, if an existing release is found:
INFO: Checking for existing product tree... Found.
If an existing release is found, you are prompted to upgrade:
Do you want to upgrade to MWTM - Server version 6.1 (y/n)?
Step 1 Do either of these:

•Enter y to continue upgrading. The installation proceeds, using prior settings. No further questions are asked. Skip to Viewing the Installation Log.

•Enter n to stop the process.

Selecting Express or Standard Installation

The Express Install option uses default settings, minimizing system prompts, and places the MWTM in the /opt directory.

If your system does not meet the requirements for Express Install, installation now continues with Selecting the Directory for Installation. If you are upgrading, Express Install is not an option.

If your system does meet the requirements, the install tool displays the following information and prompt:
============================================================
================- Express Install Check -===================
============================================================
The Express Install takes all defaults and places the product
in /opt. No more questions will be asked.
Do you want the Express Install (y/n)? [Y] 
Step 1 Choose either of these installation options:

•To choose the Express Install, press Enter.

•To choose the standard installation, which prompts you for additional information, enter n, then press Enter.

Selecting the Directory for Installation

If you do not choose the Express Install option, the MWTM install tool displays the following prompt:
INFO: Filesystems on this machine with enough space to install:
Filesystem            kbytes    used   avail capacity  Mounted on
/dev/dsk/c0t0d0s0     493688  126228  318092    29%    /
/dev/dsk/c0t0d0s4    7153253  677611 6404110    10%    /usr
/dev/dsk/c0t0d0s3    1018382   23281  933999     3%    /var
/dev/dsk/c0t1d0s5    4573659 1570527 2957396    35%    /opt
Where should the product be installed ? [/opt] 
Step 1 Do either of these:

•To accept the default value, press Enter.

•Enter a different location, and press Enter.

Checking for Available Ports

If you did not select express installation, the MWTM install tool then displays information similar to the following:
INFO: This product uses these port numbers by default:
INFO:   [ 1] Server Name         : ems-lnx179.cisco.com
INFO:   [ 2] Web Server          : 1774/tcp
INFO:   [ 3] JSP Server          : 1775/tcp
INFO:   [ 4] Naming Server       : 44742/tcp
INFO:   [ 5] Browser Path        : /opt/netscape/netscape
INFO: Checking the system to see if these are already in use...
INFO: Checking port   1774 for Web Server   ... Available.
INFO: Checking port   1775 for JSP Server   ... Available.
INFO: Checking port  44742 for Naming Server... Available.
INFO: Express install disabled.
INFO: You will be prompted for any ports which need to be configured.
Selecting a TCP Port for the Web Server

The MWTM works on standard web port 80. However, any software you install in the future that requires port 80 could conflict with the MWTM. The MWTM install tool therefore now prompts for a TCP server for the web server to use:
Which tcp port should Web Server use? [1774]
Step 1 Do either of these:

•To accept the default value (recommended), press Enter.

•Enter a different port number, and press Enter.

Selecting a TCP Port for the JSP Server

The MWTM install tool now displays the following prompt:
Which tcp port should JSP Server use? [1775]
Step 1 Do either of these:

•To accept the default value, press Enter.

•Enter a different port number, and press Enter.

Note After you confirm all port selections, the install tool sets the JSP server shutdown port to 1776 by default.

Selecting a TCP Port for the Naming Server

The MWTM install tool now displays the following prompt:
Which tcp port should Naming Server use? [44742]
Step 1 Do either of these:

•To accept the default value, press Enter.

•Enter a different port number, and press Enter.

Reviewing Your Selections

The MWTM install tool now displays the following messages and prompt:
========================================================
=================- MWTM Server Summary -================
========================================================
INFO: The following parameters will be used:
INFO:   [1] Server Name     : your_MWTM_server
INFO:   [2] Web Server      : your_web_server_port/tcp
INFO:   [3] JSP Server      : your_JSP_server_port/tcp
INFO:   [4] Naming Server   : your_naming_server_port/tcp
INFO:   [5] Browser Path    : your_browser_path
If necessary, you can change these settings after installing the MWTM by using the following commands:

•To change the Server Name, use the mwtm servername command. The MWTM client name changes to match the new server name.

•To change the Browser Path, use the mwtm browserpath command.

•To change the Web Server TCP port number, use the mwtm webport command.

•To change the JSP Server TCP port number, use the mwtm jspport command.

•To verify the new settings, use the mwtm props command.

The MWTM install tool then displays the following prompt:
Press Return to continue ->
Step 1 Press Enter. The install tool updates the relevant files.

Configuring SNMP Traps

The MWTM can receive traps natively on default UDP port number 162, or on any other UDP port that you choose. If another application is already bound to this standard SNMP trap-reception port, you must specify an alternate port number for MWTM to receive traps. The default UDP port number is 44750.

Note When you select an SNMP trap port number for the MWTM server, make sure that your devices use the same SNMP trap port number. See the description of the snmp-server host command in SNMP Configuration Requirements, page 1-12 for more information.

The MWTM install tool now displays the following prompt:
Would you like to configure MWTM to receive SNMP traps? [y]
Step 1 Do either of these:

•If you do not want to configure the MWTM to receive SNMP traps, enter n and press Enter.

•If you want to configure the MWTM to receive SNMP traps, press Enter.

The MWTM enables the trap listener, sets the SNMP trap type and port as specified, and by default sets the SNMP read community string to public.

Configuring Security Services

MWTM provides two types of security authentication: Linux and local. Local authentication allows creation of user accounts and passwords local to the MWTM system. When using this method, you can manage usernames, passwords, and access levels using MWTM commands.

Linux authentication uses the standard Linux-based user accounts and passwords, as specified in the /etc/nsswitch.conf file. Using this method, authentication can be provided by the local /etc/passwd file or from a distributed NIS or Kerberos system. When you use this method, you can assign access levels to user accounts using MWTM commands, but you can manage all usernames and passwords using Linux commands.

The MWTM install tool now displays the following prompt:
Would you like to configure MWTM Security Services? [y]
Step 1 Do either of these:

•If you do not want to configure MWTM Security Services, press Enter, then go on to Discovering your Network.

•If you want to configure MWTM Security Services, enter y and press Enter.

The MWTM install tool displays the following messages and prompt:
MWTM provides two types of security authentication, linux and local.
Local authentication allows creation of user accounts and passwords local to the MWTM 
system. When using this method, user names, passwords, and access levels are managed 
using MWTM commands.
Linux authentication uses the Pluggable Authentication Module (PAM)
library to authenticate standard Linux-based user accounts and passwords.
When using this method, usernames and passwords are managed using Linux
commands, but access levels are managed using MWTM commands.
The valid choices for authentication type are linux and local.
Please choose the type of authentication to use: [local]
Step 2 Do either of these:

•If you want the MWTM to use local-based authentication, press Enter. The MWTM install tool displays the following message:
Authentication type set to: local.
•If you want the MWTM to use Linux-based authentication, enter linux and press Enter. The MWTM install tool displays the following message:
Authentication type set to: linux.
The MWTM install tool then displays the following messages:
User-Based Access Protection Is Enabled.
Use the "mwtm adduser" command to add users.
Log in with user names and passwords for access to MWTM features.
Choosing Network Types

The MWTM can manage multiple types of networks. You are prompted to choose a network type or types:
Select the type of network that you want to manage. To select
multiple items, enter the numbers separated by commas:
1) ITP
2) IP-RAN
3) CSG1
4) CSG2
5) GGSN
6) BWG
7) HA
Enter your selection ->
Step 1 Enter the number or numbers corresponding to the items that you want to select. For example:
Enter your selection -> 1,4,5
Step 2 Verify the output indicates your network preferences. For example:
ITP - Enabled
CSG2 - Enabled
GGSN - Enabled
Note You can change the network type after installation using the mwtm manage command (see the User Guide for the Cisco Mobile Wireless Transport Manager 6.1 ). If you are performing an upgrade, the network preference is automatically set to your previous preferences.

Discovering your Network

The MWTM must discover your network during operation. If the MWTM server installation is successful, and if you do not now configure the MWTM server to automatically discover your network the first time the server starts after installation, the Discovery dialog box and the MWTM main window appear upon client startup. For details about these windows and the discovery process, see the User Guide for the Cisco Mobile Wireless Transport Manager 6.1.

The install tool now prompts for whether or not you want to discovery the network after startup:
Would you like to discover your network after startup? [n]
Step 1 Do either of these:

•If you do not want the MWTM server to automatically discover your network the first time the server starts after installation, press Enter and go on to Enabling TFTP, page 2-5.

•If you want the MWTM server to automatically discover your network the first time the server starts after installation, enter y and press Enter.

Step 2 If you chose to discover the network automatically:

a. You receive the following prompt:
Enter name of device to use to seed discovery:
Enter the name or IP address of a seed node and press Enter.

Note The MWTM does not verify that the node name you enter is a valid node name.

b. You then receive the following prompt:
Enter default SNMP read community string: [ public ] 
Press Enter to accept the default, or enter in a different SNMP read community string.

c. If you have the RAN-O network type selected, you see the following prompt:
Authentication is required for ONS discovery.
Would you like to specify default ONS credentials for use in discovery? [n]
Do either of the following:

•Enter n to bypass setting ONS credentials.

•Enter y to set ONS credentials. If you select yes, you are prompted as follows:
Enter default username: 
Enter default password: 
Confirm default password: 
Concluding Server Installation

The MWTM install tool now finishes the installation of the MWTM server and displays the following message:
To use this product, set your path to:
   /opt/CSCOmwtm/bin:$PATH
To access the MWTM Web Server use the URL:
http://your_MWTM_server:your_web_server_port
where:

•your_MWTM_server is the name of the MWTM web server.

•your_web_server_port is the TCP port number used by the web server.

Tip You can also use the web interface on the MWTM server to access server logs, system information, and MWTM documentation.

Viewing the Installation Log

The MWTM install tool now displays the following messages and prompt:
No Errors were encountered during installation.
start date/time
end_date/time
Please review /var/tmp/cisco_sgmsvr_install.log for detailed results.
Would you like to view the log? [n]
Step 1 If you do not want to view the log, installation is complete. Press Enter.

Step 2 If you want to view the log, enter y and press Enter.

The server installation log appears, followed by the prompt:
Press Return to continue ->
Step 3 Press Enter.

Installing the MWTM Client on Linux

The MWTM uses separate server and client installation scripts. If you choose to install both the server and client, the server script runs first, followed immediately by the client script. If you have just installed the server, client installation now begins. The MWTM install tool performed the necessary system requirements check when you started the server installation.

The MWTM install tool now displays information similar to the following:
========================================================================
===================- MWTM Client Install Tool Started -==================
Started : Wed Apr 26 16:58:51 EDT 2006
Host    : Linux your_MWTM_server
Version : 6.1.0
========================================================================
Archive:  archive_path
where:

•your_MWTM_server is the name of the MWTM web server.

•archive_path is the path to the download zip file.

The MWTM install tool now unpacks the zip file, listing the content files as it goes.

The MWTM install tool now displays the following messages and prompt:
To start the MWTM Client type:
   /opt/CSCOsgmClient/bin/mwtm client
or include /opt/CSCOsgmClient/bin in your path and type 'mwtm client'
 Would you like to view the log? [ n ] -> 
Step 1 Do either of these:

•If you do not want to view the log, installation is complete. Press Enter.

•If you want to view the log, enter y and press Enter. The server installation log appears, followed by the prompt:
Press Return to continue ->
Press Enter.

Installing the MWTM Server Only on Linux

This procedure assumes that you have not already installed the MWTM server or client on this workstation. If you have already installed the MWTM server or client on this workstation, some steps might be added, some might be different, and some might be unnecessary and ignored by the MWTM install tool.

To install the MWTM server only:

Step 1 When the following install tool startup menu displays:
1) Review README File First (Recommended)
2) Install MWTM Server and Client (Client Unsupported)
3) Install MWTM Server
4) Exit Setup
 Please choose an option -> 
enter 3, then press Enter.

See Installing the MWTM Server on Linux, for the remaining steps in this procedure.

Installing the MWTM Client on Linux Using the Web Server

While you cannot install the client alone from the MWTM install tool, you can access the MWTM client installation software from the MWTM web server. After you have downloaded the MWTM client installation software to your system, you must install the software on your local system by entering the setup.sh command.

The following procedure explains how to download, unzip, and install the MWTM client software on a Linux system.

To install the MWTM client using the web interface:

Step 1 Create a temporary directory in a disk partition that contains at least 60 MB of space on the system where you want to install the MWTM client software.

Step 2 From your browser, go to the URL for the MWTM web server:
http://mwtm_web_server:1774
where mwtm_web_server is the name or IP address of the MWTM web server and 1774 is the web port being using by the MWTM. (1774 is the default port number.) If you do not know the name or web port of the MWTM web server, contact the system administrator who installed the MWTM server software.

The MWTM displays the MWTM server home page.

Step 3 Scroll down to and click Download Linux Client. The Download Instructions for MWTM Client on Linux page appears.

Step 4 Click Download the Linux Client to download the client software installation files.

Step 5 When prompted, specify the directory where you want the installation software files to be downloaded, such as /tmp/mwtmClient.

Step 6 From the Linux command line, change to the directory where you downloaded the installation software and unzip the files using the following command:
# unzip mwtmClient61-download-linux.zip
Step 7 Change to the CDImage directory using the following command:
# cd mwtmClient61-download-linux
Step 8 Run the MWTM client software install tool by entering the following command:
# ./setup.sh
Note If you are installing MWTM using an NFS-exported DVD-ROM drive, image checking might take several hours to complete. To avoid this problem, enter ./setup.sh -i, which disables image checking.

The MWTM install tool displays the installation menu:
1) Review README File First (Recommended)
4) Install MWTM Client Only
5) Exit Setup
Please choose an option -> 
Choose one of the following installation options:

•To read the latest information about the MWTM in the README file, enter 1 and press Enter. The README file contains late-breaking information about the MWTM that might not be found in the other product documentation.

•To install only the MWTM client on the system, enter 4 and press Enter.

Step 9 After verifying that the MWTM client software installed successfully, remove all installation files in the temporary directory using the following command:
# rm -rf tmp/mwtmClient
where tmp/mwtmClient is the directory containing the downloaded files.

Verifying MWTM Installation

You can verify successful installation of the MWTM server software by performing the following tasks:

•Checking for Error Messages

•Viewing Package Information for the MWTM Server on Linux

•Verifying the Installation Directories

Checking for Error Messages

During installation, messages are recorded in a log file to provide diagnostic information about problems that might arise. The location of the installation log file is provided in a message at the end of the MWTM install tool.

To check for installation error messages:

Step 1 Log in as the root user, as described in Preliminary Activities.

Step 2 Use the following command to examine the MWTM server installation log:
# more install_directory/install/cisco_mwtmsvr_install.log
Where install_directory is the directory in which the MWTM was installed. The default installation directory for the MWTM is /opt/CSCOmwtm.

Step 3 Press the Space bar to scroll through the display one screen at a time.

You can also display the MWTM server installation logs using the mwtm installlog command. For more information, see the "MWTM Command Reference" appendix in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1.

Viewing Package Information for the MWTM Server on Linux

You can use the rpm command to verify that the MWTM server (CSCOmwtm-s) software package is installed on your system.

To view package information for the MWTM server:

Step 1 Enter one of the following rpm commands:
# rpm -qi CSCOsgm-s
# rpm -     CSCOsgm-jre
# rpm -qi CSCOsgm-web
# rpm -qi CSCOsgm-openssl
Step 2 Verify that you receive output similar to the following display:
Name: CSCOsgm-s                     
Relocations: /opt/CSCOsgm 
Version: 6.1.0 
Vendor: Cisco Systems, Inc.
Release: 01                             
Build Date: Mon 18 Dec 2008 03:39:41 AM EST
Install Date: Mon 15 Dec 2006 11:46:22 AM EST       
Build Host: localhost.localdomain
Group: Cisco/Network Management       
Source RPM: CSCOsgm-s-6.1.0-01.src.rpm
Size: 51993130 
License: Copyright 2008 Cisco Systems, Inc.
Signature: (none)
Summary: Cisco Mobile Wireless Transport Manager - Server
Description: The Cisco Mobile Wireless Transport Manager.
If the package was not found, one of the following messages are displayed:
package "CSCOsgm-s" is not installed
package "CSCOsgm-jre" is not installed
package "CSCOsgm-web" is not installed
package "CSCOsgm-openssl" is not installed
The MWTM software package was not installed. Install the MWTM again.

Verifying the Installation Directories

After you install the MWTM, use the ls command to verify that you have a new directory structure containing the MWTM software.

•For the MWTM server, the default directory is /opt/CSCOsgm.

•If you installed the MWTM in a directory other than /opt, then the CSCOsgm directory is located in that directory.

Starting the MWTM on Linux

After you install the MWTM server, verify that you can start the MWTM software using any of these methods:

•Starting the MWTM Server on Linux Immediately After Installation

•Starting the MWTM Server on Linux from the Command Line

•Starting the MWTM Client on Linux

Note No harm results from attempting to start an MWTM server if it is already running.

Starting the MWTM Server on Linux Immediately After Installation

At the conclusion of installation, the MWTM install tool displays the following MWTM start menu:
1) Start MWTM Server Only
2) Exit Setup
Please choose an option -> 
•To start the MWTM server immediately after installation, select option 1 and press Enter.

•To exit the set up without starting the MWTM server, select option 2 and press Enter. Use the command line option to start the MWTM server at a later time.

Starting the MWTM Server on Linux from the Command Line

Note The following procedures assume that you installed the MWTM in the default directory, /opt. If you installed the MWTM in a different directory, use the name of that directory in place of /opt.

To start just the MWTM server from the command line, log in as the root user and use the following commands:
# cd /opt/CSCOsgm/bin
# ./mwtm start
For a complete list of all of the MWTM commands, see the "MWTM Command Reference" appendix in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1.

Starting the MWTM Client on Linux

The MWTM client install tool now displays the following MWTM start menu:
1) Start MWTM Server and Client
2) Start MWTM Server Only
3) Exit Setup
Please choose an option -> 
Note Starting the client on Linux requires that you set the variable DISPLAY to your display in your Linux shell environment. If you use Telnet to get to the server, you will not have access to your display and will not have the DISPLAY variable set automatically for you.

To start the MWTM client now, enter one of the options and press Enter. To start the MWTM client at a later time:

Step 1 Choose either of these options:

•Enter:

/opt/CSCOsgmClient/bin/mwtm client

•Include the following in your path

/opt/CSCOsgmClient/bin

then enter:

mwtm client

If the MWTM server installation was successful, and if you did not configure the MWTM server to automatically discover your network the first time the server starts after installation, the Discovery dialog box and the MWTM main window appear upon client startup. For details about these windows and the discovery process, see the User Guide for the Cisco Mobile Wireless Transport Manager 6.1.

Uninstalling the MWTM

The uninstall tool provides you with a menu similar to that presented for installation.

Uninstalling the MWTM is covered in these sections:

•Overview of the Uninstallation Process

•Running the Uninstall Tool on Linux

Overview of the Uninstallation Process

When you run the uninstall program, remember the following information:

•The default for each prompt is the value in square brackets [ ]. To accept the default value, press Enter.

•If you elect to uninstall both the server and client, the uninstall tool uninstalls the client first.

•To stop the install tool at any time, press Break or Ctrl-C.

Running the Uninstall Tool on Linux

To uninstall the MWTM software:

Step 1 Log in as the root user, as described in Preliminary Activities.

Step 2 If you are running an MWTM client locally, exit all open MWTM windows.

Tip To display a list of all MWTM clients that are connected to the MWTM server, use the mwtm who command. To notify all MWTM clients that you are uninstalling MWTM, use the mwtm wall command.

You do not need to stop the MWTM server; the MWTM uninstall program stops the server automatically.

Step 3 To start the uninstall tool, enter the following command:
# /opt/CSCOsgm/install/uninstall.sh
You can also use the mwtm uninstall command; see the "MWTM Command Reference" appendix in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1.

Step 4 The MWTM uninstall program displays the uninstall menu. To uninstall the MWTM server, enter 1 and press Enter.

Step 5 The MWTM uninstall program asks you to verify that you want to uninstall the MWTM server. When prompted, enter y and press Enter.

Step 6 When uninstall is complete, the MWTM uninstall program displays messages indicating that the packages were deleted successfully.

For example, the following example shows the message received when uninstalling the MWTM server:
INFO: The following Cisco MWTM
INFO: packages have been successfully deleted from the system: CSCOsgm-s CSCOsgm-jre 
CSCOsgm-web CSCOsgm-openssl
Please review /var/tmp/cisco_sgmsvr_uninstall.log for detailed results
Would you like to view the log? [ n ] -> 
•If you do not want to view the log, uninstallation is complete. Press Enter.

•If you want to view the log, enter y and press Enter. The server uninstallation log appears, followed by the prompt:
Press Return to continue ->
Press Enter.

Step 7 To verify that the MWTM server and its associated services are uninstalled, enter the following rpm commands:
# rpm -q CSCOsgm-s
# rpm -q CSCOsgm-jre
# rpm -q CSCOsgm-web
# rpm -q CSCOsgm-openssl
package "CSCOsgm-s" is not installed
package "CSCOsgm-jre" is not installed
package "CSCOsgm-web" is not installed
package "CSCOsgm-openssl" is not installed

	Installation Guide for the Cisco Mobile Wireless Transport Manager 6.1
	Installing the MWTM on Linux
Installation Guide for the Cisco Mobile Wireless Transport Manager 6.1 Preface Preparing to Install the MWTM Installing the MWTM on Solaris Installing the MWTM on Linux Installing the MWTM Client on Windows Mounting and Unmounting the DVD-ROM Drive for Installations on Solaris or Linux Index	Download this chapter Installing the MWTM on Linux Download the complete book User Guide for the Cisco Mobile Wireless Transport Manager 6.1 (PDF - 1 MB) Table Of Contents Installing the MWTM on Linux Overview of the Installation Process Installation Prerequisites Installing the MWTM Server and Client on Linux Installing the MWTM Server on Linux Installing the MWTM Client on Linux Installing the MWTM Server Only on Linux Installing the MWTM Client on Linux Using the Web Server Verifying MWTM Installation Checking for Error Messages Viewing Package Information for the MWTM Server on Linux Verifying the Installation Directories Starting the MWTM on Linux Starting the MWTM Server on Linux Immediately After Installation Starting the MWTM Server on Linux from the Command Line Starting the MWTM Client on Linux Uninstalling the MWTM Overview of the Uninstallation Process Running the Uninstall Tool on Linux Installing the MWTM on Linux This chapter describes how to install the MWTM server software on a Linux system. It also provides information about verifying the MWTM installation and uninstalling and reinstalling the MWTM on Linux. This chapter includes the following sections: •Overview of the Installation Process •Installation Prerequisites •Installing the MWTM Server and Client on Linux •Installing the MWTM Server Only on Linux •Installing the MWTM Client on Linux Using the Web Server •Verifying MWTM Installation •Starting the MWTM on Linux •Uninstalling the MWTM Overview of the Installation Process When you start the MWTM install tool, you will see these installation options: •Installing the MWTM server and client—Use this option when you want the MWTM server and client software to reside on the same system. The MWTM uses separate server and client install tools. If you choose to install both the server and client, the server script runs first, followed immediately by the client script. Note The MWTM client is unsupported on Linux. This is because Cisco Systems cannot exhaustively test the client side of all installations. •Installing the MWTM server—Use this option when you want to install only the MWTM server software on this system. The MWTM server software consists of the following Linux Red Hat Package Manager (RPM) packages: •CSCOmwtm-s—MWTM Server •CSCOmwtm-c—MWTM Client •CSCOmwtm-jre—Java package •CSCOmwtm-web—Web server and Tomcat packages •CSCOopenssl—OpenSSL package When the MWTM install tool prompts you for a response, it displays the default value for each prompt in square brackets [ ]. To accept the default value, press Return. (When in doubt, accept the default.) The MWTM also verifies the availability of all values, such as port numbers, before accepting them. To stop the MWTM install tool at any time, press Ctrl-C. If you attempt to install the MWTM in one window while installing another product in another window, the MWTM installation will fail. If this situation occurs, wait until all other product installations are complete, then enter the following command from the top of the MWTM CD image: ./uninstall.sh -n This command removes all MWTM components and restores your system to a clean state. Then reinstall the MWTM. Installation Prerequisites Before you run the MWTM install tool: •Make sure your Linux system meets the requirements listed in Server System Requirements, page 1-7. •Determine how you want the MWTM to receive SNMP traps. If you want the MWTM to receive traps natively, determine whether MWTM is to receive traps on the standard UDP port number 162 or on another port. For example, if your ITPs have been configured to send traps to a different port, or if trap multiplexing devices and NMS applications in your network have been configured to send traps to a different port, you need to specify that port number when prompted by the MWTM install tool. •Determine whether you want to configure MWTM Security Services, and whether you want local-based or Linux-based authentication. For more information, see the "Configuring MWTM User-Based Access" section in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1. •Determine whether CiscoWorks is installed on your system, whether you want to integrate the MWTM with CiscoWorks, and the name and port number for the CiscoWorks web server. The default port number is 1741. •Determine whether you want the MWTM server to automatically discover your network the first time the server starts after installation. If so, determine the name or IP address of the node you want to use as a seed node. For more information about the discovery process and how to use seed nodes, see the "Discovering Your Network" section of the User Guide for the Cisco Mobile Wireless Transport Manager 6.1. Installing the MWTM Server and Client on Linux This procedure assumes that you have not already installed the MWTM server or client on this workstation. If you have already installed the MWTM server or client on this workstation, some steps might be added, some might be different, and some might be unnecessary and ignored by the MWTM. The MWTM uses separate server and client installation scripts. If you choose to install both the server and client, the server script runs first, followed immediately by the client script. Installing the MWTM Server on Linux Installing the MWTM server requires the following actions, in this order. Many of these steps are partially or fully automated. 1. Preliminary Activities 2. Starting the Install Tool 3. Enabling TFTP 4. Selecting the TCP/IP Address for the MWTM Server 5. Selecting the TCP/IP Address for the MWTM Server 6. Reviewing Your Selections 7. Checking Disk Space Usage 8. Checking Release and Upgrade Information 9. Selecting Express or Standard Installation 10. Selecting the Directory for Installation 11. Checking for Available Ports 12. Selecting a TCP Port for the Web Server 13. Selecting a TCP Port for the JSP Server 14. Selecting a TCP Port for the Naming Server 15. Reviewing Your Selections 16. Configuring SNMP Traps 17. Configuring Security Services 18. Choosing Network Types 19. Discovering your Network 20. Concluding Server Installation 21. Viewing the Installation Log 22. Verifying MWTM Installation Preliminary Activities Complete these preliminary steps: Note These steps include logging in as the root user. As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands you use. If you are a relatively inexperienced Linux user, limit your activities as the root user to the tasks described in this guide. Step 1 If you have not already logged in, log in as the root user: > login: root > Password: root-password If you are already logged in, but not as the root user, use the su command to change your login to root: # su # Password: root-password Step 2 Mount the DVD-ROM drive, as described in Appendix A, "Mounting and Unmounting the DVD-ROM Drive for Installations on Solaris or Linux." Step 3 Change to the mounted directory using the cd command: # cd /cdrom/MWTM61/linux or # cd /cdrom/cdrom0/linux Starting the Install Tool In this step you start the install tool and select the appropriate installation option. Step 1 Start the install tool by entering the following command: # ./setup.sh or # ./setup.sh -i Note If you are installing the MWTM using an NFS-exported DVD-ROM drive, image checking is highly recommended, however it can take several hours to complete. To avoid this problem, enter ./setup.sh -i, which disables image checking. Step 2 The MWTM install tool displays the installation menu: 1) Review README File First (Recommended) 2) Install MWTM Server and Client (Client Unsupported) 3) Install MWTM Server 4) Exit Setup Please choose an option -> Choose one of the following installation options: •To read the latest information about the MWTM in the README file, enter 1, then press Enter. The README file contains late-breaking information about the MWTM that might not be found in the other product documentation. •To install both the MWTM server and client, enter 2, then press Enter. The MWTM uses separate server and client install tools. If you choose to install both the server and client, the server script runs first, followed immediately by the client script. Note The Linux client works with many distributions, but it is not formally supported. Use it at your own discretion. You can also install the Linux client from the MWTM web interface (for details, see Installing the MWTM Client on Linux Using the Web Server). •To install the MWTM server alone, enter 3, then press Enter. •To exit the install tool, enter 4, then press Enter. If you selected option 2 or 3, the install tool displays information similar to the following: ===================- MWTM Server Install Tool Started -================== Started : date, time Host : Linux your_MWTM_server Version : 6.1.0 ======================================================================== INFO: Checking UID... root, OK. where your_MWTM_server is the name of your MWTM server. The install tool now performs a system-requirements check to ensure that all requirements are met. Information similar to the following appears: ============================================================= =================- System Requirements Check -=============== ============================================================= INFO: Checking Host Operating System...Linux, OK. INFO: Checking Operating System Version... 4, OK. INFO: Checking for RHEL Update Number... 4, OK. INFO: This product requires: RAM 2048 MB SWAP 2048MB CPU 1024 MHz INFO: Checking RAM... 2048 MB OK INFO: Checking Swap... 2048 MB OK INFO: Checking CPU... 2 x 1005 MHz OK If a previous MWTM version is installed, a message similar to the following appears: INFO: Version on System: MWTM 6.0 INFO: Available Latest Version: MWTM 6.1 If any requirement is missing, a warning message appears. For a list of all system requirements, see Server System Requirements, page 1-7. If you are performing an upgrade, one of the following messages appear: INFO: Upgrading from MWTM version 6.0 to MWTM version 6.1... or INFO: Upgrade from MWTM version 5.0 to MWTM version 6.0 supported. Enabling TFTP The MWTM checks to see if TFTP is installed and enabled on the system. •If the TFTP server on this system is installed and enabled, the MWTM installation program displays the following messages and prompt: ============================================================ ====================- TFTP Server Check -=================== ============================================================ INFO: Checking TFTP Server... Enabled Installation continues with Concluding Server Installation. •If the TFTP server on this system is not enabled, the MWTM installation program displays the following messages and prompt: INFO: Checking TFTP Server... Not Installed WARNING: The TFTP server on this system is not installed. INFO: If you plan to use this system as a TFTP server to send INFO: configuration files to ITP devices, install and enable INFO: the TFTP server. •If the TFTP server on this system is installed but not enabled, the MWTM installation program displays the following messages and prompt: INFO: Checking TFTP Server... Not Enabled WARNING: The TFTP server on this system is not enabled. INFO: If you plan to use this system as a TFTP server to send INFO: configuration files to ITP devices, enable the TFTP server INFO: and ensure that it is working properly. INFO: Check the /etc/xinetd.d/tftp file for the entries: disable = no and user = rootCheck the specified line in the etc/inetd.conf file, then press Return. Selecting the TCP/IP Address for the MWTM Server The install tool now performs a TCP/IP port usage check. Information similar to the following appears: ================================================= =============- TCP/IP Address Check -============ ================================================= The server must bind to a specific IP address. This address will be used by any remote client connecting to the server. Available IP addresses ---------------------- 172.16.0.0 172.31.255.255 Enter IP address to use for client communications: Step 1 Enter the IP address that you want to use, choosing from the list of available IP addresses, then press Enter. If you are performing an upgrade, or if only one IP address is available, you are not prompted to enter an IP address, as the system uses the previous configuration or single IP address to make that determination, and provides output similar to: Using 172.31.255.255 for client communications Checking the TCP/IP Port Usage for the MWTM Server The install tool now performs a TCP/IP port usage check. Information similar to the following appears: ============================================================ =================- TCP/IP Port Usage Check -================ ============================================================ INFO: This product uses these port numbers by default: INFO: [ 1] Server Name : your_MWTM_server INFO: [ 2] Web Server : 1774/tcp INFO: [ 3] JSP Server : 1775/tcp INFO: [ 4] Naming Server : 44742/tcp INFO: Checking the system for available ports to see if these are in use... INFO: Checking port 1774 for Web Server ... Available. INFO: Checking port 1775 for JSP Server ... Available. INFO: Checking port 44742 for Naming Server... Available. where your_MWTM_server is the name of the MWTM server. If any ports are in use, you receive prompts for any ports that need to be configured. However, if you are performing an upgrade, the system automatically uses ports defined in the previous installation, and skips to Checking Disk Space Usage. Reviewing Your Selections The install tool now displays information similar to the following: ======================================================== =================- MWTM Server Summary -================ ======================================================== INFO: The following parameters will be used: INFO: [1] Server Name : your_MWTM_server INFO: [2] Web Server : 1774/tcp INFO: [3] JSP Server : 1775/tcp INFO: [4] Naming Server : 44742/tcp Press Return to continue -> where your_MWTM_server is the name of the MWTM server. Step 1 Press Enter. The MWTM now checks for disk space usage. Checking Disk Space Usage The MWTM installation tool now attempts to determine whether there is adequate space in the default installation directory, /opt, to install the MWTM server, and displays information similar to the following: ============================================================ ================- Disk Space Usage check -================== ============================================================ INFO: For this product the default disk space requirements are: /opt 1024 MB /var/lib/rpm 1 MB /var/tmp 1 MB /tmp 1 MB INFO: Checking default disk space requirements... OK. ============================================================ Note The /var/lib/rpm directory is the default on most devices, but might vary depending upon your device set up. •If there is adequate space, installation now continues. •If there is not adequate space, the MWTM install tool asks you to specify a different directory. When you have specified a different directory, installation continues. The MWTM install tool also checks the /var/sadm directory to determine whether there is adequate space. If there is not adequate space on any of these directories, the following message appears: INFO: There is insufficient space in </directory> for an installation INFO: to proceed. Disk Space of at least <x> MB INFO: is required for the install. Cannot continue... The installation process stops and exits. If errors or warnings are encountered up to this point, you might receive the following message: System does not qualify for a Server Install. Found Errors/Warnings during system check! Do you want to continue to install the MWTM - Server? (y/n)? Do either of these: •To continue with installation, enter y. The following warning appears: WARNING: Installing the MWTM - Server without basic requirements WARNING: may restrict you to use some of the MWTM - Server features. •To stop installation, enter n. The installation stops and exits. Checking Release and Upgrade Information The MWTM installation tool checks your release for all components and displays information similar to the following: INFO: Checking your release... All components present. The MWTM now checks for existing releases. If no existing releases are present: INFO: Checking for existing product tree... None. Or, if an existing release is found: INFO: Checking for existing product tree... Found. If an existing release is found, you are prompted to upgrade: Do you want to upgrade to MWTM - Server version 6.1 (y/n)? Step 1 Do either of these: •Enter y to continue upgrading. The installation proceeds, using prior settings. No further questions are asked. Skip to Viewing the Installation Log. •Enter n to stop the process. Selecting Express or Standard Installation The Express Install option uses default settings, minimizing system prompts, and places the MWTM in the /opt directory. If your system does not meet the requirements for Express Install, installation now continues with Selecting the Directory for Installation. If you are upgrading, Express Install is not an option. If your system does meet the requirements, the install tool displays the following information and prompt: ============================================================ ================- Express Install Check -=================== ============================================================ The Express Install takes all defaults and places the product in /opt. No more questions will be asked. Do you want the Express Install (y/n)? [Y] Step 1 Choose either of these installation options: •To choose the Express Install, press Enter. •To choose the standard installation, which prompts you for additional information, enter n, then press Enter. Selecting the Directory for Installation If you do not choose the Express Install option, the MWTM install tool displays the following prompt: INFO: Filesystems on this machine with enough space to install: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t0d0s0 493688 126228 318092 29% / /dev/dsk/c0t0d0s4 7153253 677611 6404110 10% /usr /dev/dsk/c0t0d0s3 1018382 23281 933999 3% /var /dev/dsk/c0t1d0s5 4573659 1570527 2957396 35% /opt Where should the product be installed ? [/opt] Step 1 Do either of these: •To accept the default value, press Enter. •Enter a different location, and press Enter. Checking for Available Ports If you did not select express installation, the MWTM install tool then displays information similar to the following: INFO: This product uses these port numbers by default: INFO: [ 1] Server Name : ems-lnx179.cisco.com INFO: [ 2] Web Server : 1774/tcp INFO: [ 3] JSP Server : 1775/tcp INFO: [ 4] Naming Server : 44742/tcp INFO: [ 5] Browser Path : /opt/netscape/netscape INFO: Checking the system to see if these are already in use... INFO: Checking port 1774 for Web Server ... Available. INFO: Checking port 1775 for JSP Server ... Available. INFO: Checking port 44742 for Naming Server... Available. INFO: Express install disabled. INFO: You will be prompted for any ports which need to be configured. Selecting a TCP Port for the Web Server The MWTM works on standard web port 80. However, any software you install in the future that requires port 80 could conflict with the MWTM. The MWTM install tool therefore now prompts for a TCP server for the web server to use: Which tcp port should Web Server use? [1774] Step 1 Do either of these: •To accept the default value (recommended), press Enter. •Enter a different port number, and press Enter. Selecting a TCP Port for the JSP Server The MWTM install tool now displays the following prompt: Which tcp port should JSP Server use? [1775] Step 1 Do either of these: •To accept the default value, press Enter. •Enter a different port number, and press Enter. Note After you confirm all port selections, the install tool sets the JSP server shutdown port to 1776 by default. Selecting a TCP Port for the Naming Server The MWTM install tool now displays the following prompt: Which tcp port should Naming Server use? [44742] Step 1 Do either of these: •To accept the default value, press Enter. •Enter a different port number, and press Enter. Reviewing Your Selections The MWTM install tool now displays the following messages and prompt: ======================================================== =================- MWTM Server Summary -================ ======================================================== INFO: The following parameters will be used: INFO: [1] Server Name : your_MWTM_server INFO: [2] Web Server : your_web_server_port/tcp INFO: [3] JSP Server : your_JSP_server_port/tcp INFO: [4] Naming Server : your_naming_server_port/tcp INFO: [5] Browser Path : your_browser_path If necessary, you can change these settings after installing the MWTM by using the following commands: •To change the Server Name, use the mwtm servername command. The MWTM client name changes to match the new server name. •To change the Browser Path, use the mwtm browserpath command. •To change the Web Server TCP port number, use the mwtm webport command. •To change the JSP Server TCP port number, use the mwtm jspport command. •To verify the new settings, use the mwtm props command. The MWTM install tool then displays the following prompt: Press Return to continue -> Step 1 Press Enter. The install tool updates the relevant files. Configuring SNMP Traps The MWTM can receive traps natively on default UDP port number 162, or on any other UDP port that you choose. If another application is already bound to this standard SNMP trap-reception port, you must specify an alternate port number for MWTM to receive traps. The default UDP port number is 44750. Note When you select an SNMP trap port number for the MWTM server, make sure that your devices use the same SNMP trap port number. See the description of the snmp-server host command in SNMP Configuration Requirements, page 1-12 for more information. The MWTM install tool now displays the following prompt: Would you like to configure MWTM to receive SNMP traps? [y] Step 1 Do either of these: •If you do not want to configure the MWTM to receive SNMP traps, enter n and press Enter. •If you want to configure the MWTM to receive SNMP traps, press Enter. The MWTM enables the trap listener, sets the SNMP trap type and port as specified, and by default sets the SNMP read community string to public. Configuring Security Services MWTM provides two types of security authentication: Linux and local. Local authentication allows creation of user accounts and passwords local to the MWTM system. When using this method, you can manage usernames, passwords, and access levels using MWTM commands. Linux authentication uses the standard Linux-based user accounts and passwords, as specified in the /etc/nsswitch.conf file. Using this method, authentication can be provided by the local /etc/passwd file or from a distributed NIS or Kerberos system. When you use this method, you can assign access levels to user accounts using MWTM commands, but you can manage all usernames and passwords using Linux commands. The MWTM install tool now displays the following prompt: Would you like to configure MWTM Security Services? [y] Step 1 Do either of these: •If you do not want to configure MWTM Security Services, press Enter, then go on to Discovering your Network. •If you want to configure MWTM Security Services, enter y and press Enter. The MWTM install tool displays the following messages and prompt: MWTM provides two types of security authentication, linux and local. Local authentication allows creation of user accounts and passwords local to the MWTM system. When using this method, user names, passwords, and access levels are managed using MWTM commands. Linux authentication uses the Pluggable Authentication Module (PAM) library to authenticate standard Linux-based user accounts and passwords. When using this method, usernames and passwords are managed using Linux commands, but access levels are managed using MWTM commands. The valid choices for authentication type are linux and local. Please choose the type of authentication to use: [local] Step 2 Do either of these: •If you want the MWTM to use local-based authentication, press Enter. The MWTM install tool displays the following message: Authentication type set to: local. •If you want the MWTM to use Linux-based authentication, enter linux and press Enter. The MWTM install tool displays the following message: Authentication type set to: linux. The MWTM install tool then displays the following messages: User-Based Access Protection Is Enabled. Use the "mwtm adduser" command to add users. Log in with user names and passwords for access to MWTM features. Choosing Network Types The MWTM can manage multiple types of networks. You are prompted to choose a network type or types: Select the type of network that you want to manage. To select multiple items, enter the numbers separated by commas: 1) ITP 2) IP-RAN 3) CSG1 4) CSG2 5) GGSN 6) BWG 7) HA Enter your selection -> Step 1 Enter the number or numbers corresponding to the items that you want to select. For example: Enter your selection -> 1,4,5 Step 2 Verify the output indicates your network preferences. For example: ITP - Enabled CSG2 - Enabled GGSN - Enabled Note You can change the network type after installation using the mwtm manage command (see the User Guide for the Cisco Mobile Wireless Transport Manager 6.1 ). If you are performing an upgrade, the network preference is automatically set to your previous preferences. Discovering your Network The MWTM must discover your network during operation. If the MWTM server installation is successful, and if you do not now configure the MWTM server to automatically discover your network the first time the server starts after installation, the Discovery dialog box and the MWTM main window appear upon client startup. For details about these windows and the discovery process, see the User Guide for the Cisco Mobile Wireless Transport Manager 6.1. The install tool now prompts for whether or not you want to discovery the network after startup: Would you like to discover your network after startup? [n] Step 1 Do either of these: •If you do not want the MWTM server to automatically discover your network the first time the server starts after installation, press Enter and go on to Enabling TFTP, page 2-5. •If you want the MWTM server to automatically discover your network the first time the server starts after installation, enter y and press Enter. Step 2 If you chose to discover the network automatically: a. You receive the following prompt: Enter name of device to use to seed discovery: Enter the name or IP address of a seed node and press Enter. Note The MWTM does not verify that the node name you enter is a valid node name. b. You then receive the following prompt: Enter default SNMP read community string: [ public ] Press Enter to accept the default, or enter in a different SNMP read community string. c. If you have the RAN-O network type selected, you see the following prompt: Authentication is required for ONS discovery. Would you like to specify default ONS credentials for use in discovery? [n] Do either of the following: •Enter n to bypass setting ONS credentials. •Enter y to set ONS credentials. If you select yes, you are prompted as follows: Enter default username: Enter default password: Confirm default password: Concluding Server Installation The MWTM install tool now finishes the installation of the MWTM server and displays the following message: To use this product, set your path to: /opt/CSCOmwtm/bin:$PATH To access the MWTM Web Server use the URL: http://your_MWTM_server:your_web_server_port where: •your_MWTM_server is the name of the MWTM web server. •your_web_server_port is the TCP port number used by the web server. Tip You can also use the web interface on the MWTM server to access server logs, system information, and MWTM documentation. Viewing the Installation Log The MWTM install tool now displays the following messages and prompt: No Errors were encountered during installation. start date/time end_date/time Please review /var/tmp/cisco_sgmsvr_install.log for detailed results. Would you like to view the log? [n] Step 1 If you do not want to view the log, installation is complete. Press Enter. Step 2 If you want to view the log, enter y and press Enter. The server installation log appears, followed by the prompt: Press Return to continue -> Step 3 Press Enter. Installing the MWTM Client on Linux The MWTM uses separate server and client installation scripts. If you choose to install both the server and client, the server script runs first, followed immediately by the client script. If you have just installed the server, client installation now begins. The MWTM install tool performed the necessary system requirements check when you started the server installation. The MWTM install tool now displays information similar to the following: ======================================================================== ===================- MWTM Client Install Tool Started -================== Started : Wed Apr 26 16:58:51 EDT 2006 Host : Linux your_MWTM_server Version : 6.1.0 ======================================================================== Archive: archive_path where: •your_MWTM_server is the name of the MWTM web server. •archive_path is the path to the download zip file. The MWTM install tool now unpacks the zip file, listing the content files as it goes. The MWTM install tool now displays the following messages and prompt: To start the MWTM Client type: /opt/CSCOsgmClient/bin/mwtm client or include /opt/CSCOsgmClient/bin in your path and type 'mwtm client' Would you like to view the log? [ n ] -> Step 1 Do either of these: •If you do not want to view the log, installation is complete. Press Enter. •If you want to view the log, enter y and press Enter. The server installation log appears, followed by the prompt: Press Return to continue -> Press Enter. Installing the MWTM Server Only on Linux This procedure assumes that you have not already installed the MWTM server or client on this workstation. If you have already installed the MWTM server or client on this workstation, some steps might be added, some might be different, and some might be unnecessary and ignored by the MWTM install tool. To install the MWTM server only: Step 1 When the following install tool startup menu displays: 1) Review README File First (Recommended) 2) Install MWTM Server and Client (Client Unsupported) 3) Install MWTM Server 4) Exit Setup Please choose an option -> enter 3, then press Enter. See Installing the MWTM Server on Linux, for the remaining steps in this procedure. Installing the MWTM Client on Linux Using the Web Server While you cannot install the client alone from the MWTM install tool, you can access the MWTM client installation software from the MWTM web server. After you have downloaded the MWTM client installation software to your system, you must install the software on your local system by entering the setup.sh command. The following procedure explains how to download, unzip, and install the MWTM client software on a Linux system. To install the MWTM client using the web interface: Step 1 Create a temporary directory in a disk partition that contains at least 60 MB of space on the system where you want to install the MWTM client software. Step 2 From your browser, go to the URL for the MWTM web server: http://mwtm_web_server:1774 where mwtm_web_server is the name or IP address of the MWTM web server and 1774 is the web port being using by the MWTM. (1774 is the default port number.) If you do not know the name or web port of the MWTM web server, contact the system administrator who installed the MWTM server software. The MWTM displays the MWTM server home page. Step 3 Scroll down to and click Download Linux Client. The Download Instructions for MWTM Client on Linux page appears. Step 4 Click Download the Linux Client to download the client software installation files. Step 5 When prompted, specify the directory where you want the installation software files to be downloaded, such as /tmp/mwtmClient. Step 6 From the Linux command line, change to the directory where you downloaded the installation software and unzip the files using the following command: # unzip mwtmClient61-download-linux.zip Step 7 Change to the CDImage directory using the following command: # cd mwtmClient61-download-linux Step 8 Run the MWTM client software install tool by entering the following command: # ./setup.sh Note If you are installing MWTM using an NFS-exported DVD-ROM drive, image checking might take several hours to complete. To avoid this problem, enter ./setup.sh -i, which disables image checking. The MWTM install tool displays the installation menu: 1) Review README File First (Recommended) 4) Install MWTM Client Only 5) Exit Setup Please choose an option -> Choose one of the following installation options: •To read the latest information about the MWTM in the README file, enter 1 and press Enter. The README file contains late-breaking information about the MWTM that might not be found in the other product documentation. •To install only the MWTM client on the system, enter 4 and press Enter. Step 9 After verifying that the MWTM client software installed successfully, remove all installation files in the temporary directory using the following command: # rm -rf tmp/mwtmClient where tmp/mwtmClient is the directory containing the downloaded files. Verifying MWTM Installation You can verify successful installation of the MWTM server software by performing the following tasks: •Checking for Error Messages •Viewing Package Information for the MWTM Server on Linux •Verifying the Installation Directories Checking for Error Messages During installation, messages are recorded in a log file to provide diagnostic information about problems that might arise. The location of the installation log file is provided in a message at the end of the MWTM install tool. To check for installation error messages: Step 1 Log in as the root user, as described in Preliminary Activities. Step 2 Use the following command to examine the MWTM server installation log: # more install_directory/install/cisco_mwtmsvr_install.log Where install_directory is the directory in which the MWTM was installed. The default installation directory for the MWTM is /opt/CSCOmwtm. Step 3 Press the Space bar to scroll through the display one screen at a time. You can also display the MWTM server installation logs using the mwtm installlog command. For more information, see the "MWTM Command Reference" appendix in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1. Viewing Package Information for the MWTM Server on Linux You can use the rpm command to verify that the MWTM server (CSCOmwtm-s) software package is installed on your system. To view package information for the MWTM server: Step 1 Enter one of the following rpm commands: # rpm -qi CSCOsgm-s # rpm - CSCOsgm-jre # rpm -qi CSCOsgm-web # rpm -qi CSCOsgm-openssl Step 2 Verify that you receive output similar to the following display: Name: CSCOsgm-s Relocations: /opt/CSCOsgm Version: 6.1.0 Vendor: Cisco Systems, Inc. Release: 01 Build Date: Mon 18 Dec 2008 03:39:41 AM EST Install Date: Mon 15 Dec 2006 11:46:22 AM EST Build Host: localhost.localdomain Group: Cisco/Network Management Source RPM: CSCOsgm-s-6.1.0-01.src.rpm Size: 51993130 License: Copyright 2008 Cisco Systems, Inc. Signature: (none) Summary: Cisco Mobile Wireless Transport Manager - Server Description: The Cisco Mobile Wireless Transport Manager. If the package was not found, one of the following messages are displayed: package "CSCOsgm-s" is not installed package "CSCOsgm-jre" is not installed package "CSCOsgm-web" is not installed package "CSCOsgm-openssl" is not installed The MWTM software package was not installed. Install the MWTM again. Verifying the Installation Directories After you install the MWTM, use the ls command to verify that you have a new directory structure containing the MWTM software. •For the MWTM server, the default directory is /opt/CSCOsgm. •If you installed the MWTM in a directory other than /opt, then the CSCOsgm directory is located in that directory. Starting the MWTM on Linux After you install the MWTM server, verify that you can start the MWTM software using any of these methods: •Starting the MWTM Server on Linux Immediately After Installation •Starting the MWTM Server on Linux from the Command Line •Starting the MWTM Client on Linux Note No harm results from attempting to start an MWTM server if it is already running. Starting the MWTM Server on Linux Immediately After Installation At the conclusion of installation, the MWTM install tool displays the following MWTM start menu: 1) Start MWTM Server Only 2) Exit Setup Please choose an option -> •To start the MWTM server immediately after installation, select option 1 and press Enter. •To exit the set up without starting the MWTM server, select option 2 and press Enter. Use the command line option to start the MWTM server at a later time. Starting the MWTM Server on Linux from the Command Line Note The following procedures assume that you installed the MWTM in the default directory, /opt. If you installed the MWTM in a different directory, use the name of that directory in place of /opt. To start just the MWTM server from the command line, log in as the root user and use the following commands: # cd /opt/CSCOsgm/bin # ./mwtm start For a complete list of all of the MWTM commands, see the "MWTM Command Reference" appendix in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1. Starting the MWTM Client on Linux The MWTM client install tool now displays the following MWTM start menu: 1) Start MWTM Server and Client 2) Start MWTM Server Only 3) Exit Setup Please choose an option -> Note Starting the client on Linux requires that you set the variable DISPLAY to your display in your Linux shell environment. If you use Telnet to get to the server, you will not have access to your display and will not have the DISPLAY variable set automatically for you. To start the MWTM client now, enter one of the options and press Enter. To start the MWTM client at a later time: Step 1 Choose either of these options: •Enter: /opt/CSCOsgmClient/bin/mwtm client •Include the following in your path /opt/CSCOsgmClient/bin then enter: mwtm client If the MWTM server installation was successful, and if you did not configure the MWTM server to automatically discover your network the first time the server starts after installation, the Discovery dialog box and the MWTM main window appear upon client startup. For details about these windows and the discovery process, see the User Guide for the Cisco Mobile Wireless Transport Manager 6.1. Uninstalling the MWTM The uninstall tool provides you with a menu similar to that presented for installation. Uninstalling the MWTM is covered in these sections: •Overview of the Uninstallation Process •Running the Uninstall Tool on Linux Overview of the Uninstallation Process When you run the uninstall program, remember the following information: •The default for each prompt is the value in square brackets [ ]. To accept the default value, press Enter. •If you elect to uninstall both the server and client, the uninstall tool uninstalls the client first. •To stop the install tool at any time, press Break or Ctrl-C. Running the Uninstall Tool on Linux To uninstall the MWTM software: Step 1 Log in as the root user, as described in Preliminary Activities. Step 2 If you are running an MWTM client locally, exit all open MWTM windows. Tip To display a list of all MWTM clients that are connected to the MWTM server, use the mwtm who command. To notify all MWTM clients that you are uninstalling MWTM, use the mwtm wall command. You do not need to stop the MWTM server; the MWTM uninstall program stops the server automatically. Step 3 To start the uninstall tool, enter the following command: # /opt/CSCOsgm/install/uninstall.sh You can also use the mwtm uninstall command; see the "MWTM Command Reference" appendix in the User Guide for the Cisco Mobile Wireless Transport Manager 6.1. Step 4 The MWTM uninstall program displays the uninstall menu. To uninstall the MWTM server, enter 1 and press Enter. Step 5 The MWTM uninstall program asks you to verify that you want to uninstall the MWTM server. When prompted, enter y and press Enter. Step 6 When uninstall is complete, the MWTM uninstall program displays messages indicating that the packages were deleted successfully. For example, the following example shows the message received when uninstalling the MWTM server: INFO: The following Cisco MWTM INFO: packages have been successfully deleted from the system: CSCOsgm-s CSCOsgm-jre CSCOsgm-web CSCOsgm-openssl Please review /var/tmp/cisco_sgmsvr_uninstall.log for detailed results Would you like to view the log? [ n ] -> •If you do not want to view the log, uninstallation is complete. Press Enter. •If you want to view the log, enter y and press Enter. The server uninstallation log appears, followed by the prompt: Press Return to continue -> Press Enter. Step 7 To verify that the MWTM server and its associated services are uninstalled, enter the following rpm commands: # rpm -q CSCOsgm-s # rpm -q CSCOsgm-jre # rpm -q CSCOsgm-web # rpm -q CSCOsgm-openssl package "CSCOsgm-s" is not installed package "CSCOsgm-jre" is not installed package "CSCOsgm-web" is not installed package "CSCOsgm-openssl" is not installed
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.