The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Cisco provides these tools to manage the Cisco MobilityManager server platform:
•Cisco IPT Platform Administration web pages that provide complete platform administration functions.
•Command Line Interface (CLI) that provides a subset of the platform administration functions.
Refer to these topics for instructions on using the browser-based interface and the command line interface:
•Using the Cisco IPT Platform Administration Web Pages
•Cisco IPT Platform Administration Command Line Interface
The Cisco IPT Platform Administration web pages allow you to configure and manage the Cisco MobilityManager server platform. You can perform these functions:
•Verify status of platform components—The Status window provides the following read-only hardware and platform information:
–Platform status—Displays information that was entered during Cisco MobilityManager server installation, including the host name, status of Ethernet ports, IP addresses, memory usage, and CPU utilization.
–Hardware status—Displays information about the hardware platform.
•Configure network settings—You can modify IP address and Dynamic Host Configuration Protocol (DHCP) information that was entered when the application was installed. You can also add Network Time Protocol (NTP) servers and clients and synchronize NTP settings.
•Verify connectivity with other network devices—You can use the Ping utility to verify network connectivity.
•Perform Software Upgrades—You can verify your current version of Cisco MobilityManager server software and upgrade software from a local source (CD-ROM or DVD) or remote source (server on the network).
•Reboot the System—You can reboot your system and continue to use the current software image or reboot your system and start using an alternative software image.
Related Topics
To access Cisco IPT Platform Administration and log in, follow these steps:
Procedure
Step 1 On the Cisco CallManager Administration window, click Show Navigation.
Step 2 In the left-hand pane, click Platform Administration.
Step 3 On the Cisco IPT Platform Administration Logon window, enter your user name and password.
Note The user name and password are established during installation.
Step 4 Click Submit.
Use these Show Status menu options to view information on platform status and hardware status:
•Platform Status—Displays information that was entered during platform installation, including the host name, status of Ethernet ports, IP addresses, memory usage, and CPU utilization.
•Hardware Status—Displays the platform model, CPU type, memory, object ID, and OS version.
To open the Platform Status window, choose Show Status > Platform Status. Table 6-1 describes the fields displayed in the window.
To open the Hardware Status window, choose Show Status > Hardware Status. Table 6-2 describes the fields displayed in the window.
Use the Settings windows to display and change:
•IP settings
•Host settings
•Network Time Protocol (NTP) settings
•Ping utility
The IP Settings window indicates whether Dynamic Host Configuration Protocol (DHCP) is active on Ethernet connections 0 and 1, lists the related Ethernet IP addresses, and shows the IP address for the network gateway.
To modify the IP settings, follow these steps:
Procedure
Step 1 Choose Settings > IP Settings.
Step 2 Enter the new value in the appropriate field as described in Table 6-3.
Step 3 Click Execute.
The Host Settings window displays the name and IP address of the platform host. You must set the values as part of the platform installation procedure.
To add a new host, follow these steps:
Procedure
Step 1 Choose Settings > Host Settings.
Step 2 Click Add.
Step 3 Enter a new host name and IP address.
Step 4 Click Save.
The NTP Settings window displays the NTP settings and enables you to configure the platform as either an NTP server or an NTP client. From this window, you can also start and stop the NTP service.
To configure NTP settings, follow these steps:
Procedure
Step 1 Choose Settings > NTP Settings.
Step 2 Enter information according to the descriptions in Table 6-4.
Step 3 Click Save.
The Ping Utility window enables you to send ping messages to another server in the network.
To use the Ping utility, follow these steps:
Procedure
Step 1 Choose Utilities > Ping.
Step 2 Enter the destination IP address and number of ping packet to send.
Step 3 Click Execute.
Step 4 The Ping Utility window displays the ping statistics. Click Cancel or Done to terminate the ping operation.
These Software Upgrade windows enable you to upgrade the Cisco IPT platform software from a local or a remote source, show the current software version, and verify individual software components:
•From Local Source
•From Remote Source
•Show Current Version
•Check Component Info
Use the From Local Source window to upgrade the server software from a CD or DVD.
Before You Begin
•Create or obtain the upgrade disk.
•Back up your system data. See the "Backing Up and Restoring the Database" section.
To perform the upgrade, follow these steps:
Procedure
Step 1 Insert the new CD or DVD into the disk drive on the local server that is to be upgraded.
Step 2 Choose Software Upgrade > From Local Source.
Step 3 Enter the required upgrade information, as described in Table 6-5:
Step 4 Click Submit.
You will see upgrade status messages including a list of previously downloaded images.
Step 5 Click Cancel if you need to terminate the upgrade operation before it is completed.
Use the From Remote Source window to upgrade software from a remote network location.
Before You Begin
Back up your system data. See the "Backing Up and Restoring the Database" section.
To upgrade from a remote location, follow these steps:
Procedure
Step 1 Choose Software Upgrade > From Remote Source.
Step 2 Enter the required upgrade information.
Table 6-6 describes the upgrade information.
Step 3 Click Submit.
Step 4 Choose a software version to download.
Step 5 Confirm the software upgrade.
Step 6 Reboot your system.
You will see upgrade status messages, including a list of previously downloaded images.
From the Show Current Version window, you can view the current version of software that is running on the Cisco IPT Platform.
To view the current software version, follow these steps:
Procedure
Step 1 Choose Software Upgrade > Show Current Version.
Step 2 Click Retrieve to obtain version information.
Step 3 When you have finished viewing the information, click OK.
From the Check Component Info window you can check these categories of information:
•Installed software packages
•Installation process
•Post-installation process
•Upgrade process
•Contents of a directory or file
To check the component information, follow these steps:
Procedure
Step 1 Choose Software Upgrade > Check Component Info.
Step 2 Choose one of the following types of information:
•Software Packages
•Install
•Post Install
•Upgrade
Alternatively, enter a file name to retrieve.
Step 3 (Optional) enter the number of lines to retrieve from the file. Entering 0 retrieves the entire file.
Step 4 Click Retrieve.
Step 5 An information window opens. Perform these functions in the information window:
•Click Refresh to retrieve updated information.
•Click Cancel to close the information window.
•To continue using the IPT Platform Administration pages, select from the menu located on the left side of the window.
When you upgrade your software from a local or remote source, the software upgrade downloads to the standby partition in your server. From the Switch Versions and Reboot window, you can switch from the active partition (which is running the older version of software) to the standby partition (containing the upgraded software).
You can also reboot the system that is running the current software version or power down the system completely.
When you upgrade your software from either a local or remote source, the software upgrade is downloads to the standby partition in your server. From this window, you can switch from the active partition (which is running the older version of software) to the standby partition (containing the upgraded software):
•To proceed with the software version switch and system reboot, click Proceed.
•To cancel the software version switch and system reboot, click Cancel.
From the Reboot Current Version window, you can reboot your system and continue running the same version of software:
•To proceed with the system reboot, click Proceed.
•To cancel the system reboot, click Cancel.
From the Poweroff System window, you can shut your system down safely:
•To start the system shutdown, click Confirm.
•To cancel the system shutdown, click Cancel.
This section describes commands to perform basic platform administration functions. All the commands described in this section are also available using the Cisco IPT Platform Administration web application, as described in the "Using the Cisco IPT Platform Administration Web Pages" section.
Note It is recommended that you use the command-line interface (CLI) only when the Cisco IPT Platform Administration web application is not available.
The following CLI commands are available:
•file list
•file view
•ping
•restart
•service list
•service start
•service stop
•set hostname
•set ip (DHCP)
•set ip (IP)
•set security
•set task alarm
•set task trace
•show status
•show hw
•show security
•show files activelog
•show files activlog cli.log
•show files inactive log
•show files install
•show files install ks.cfg
•show files install partAlloc
•show files install install.log
•show files install install.post
•tracert
You can access the Cisco IPT Platform Administration CLI from a local or remote location:
•Access the Cisco IPT Platform Administration CLI directly by using the monitor and keyboard that you used during Cisco MobilityManager installation or by using a terminal server that is connected to the serial port.
•Use SSH to make a secure connection to the Cisco IPT Platform Administration CLI from a client workstation.
Before You Begin
Ensure that the Cisco IPT Platform is installed with the following information configured:
•A primary IP address and hostname
•An administrator ID
•A password
You will need this information to log in to the Cisco IPT Platform Administration CLI.
To start a CLI session, perform these steps:
Procedure
Step 1 Choose one of these options to connect to the CLI:
•From a remote system, use SSH to connect securely to the Cisco IPT Platform Administration CLI. In your SSH client, enter
ssh adminname@hostname
where adminname specifies the Administrator ID and hostname specifies the hostname that waqs defined during installation.
For example, ssh admin@ipt-1.
•From a direct connection, you receive this prompt automatically:
ipt-1 login:
where ipt-1 represents the host name of the system.
Enter the administrator ID that was defined during installation.
Step 2 Enter the password.
The CLI prompt is presented. The prompt includes the Administrator ID, as in this example:
admin:
You can enter CLI commands.
Related Topics
This section contains basic tips for using the command line interface.
To complete commands, use Tab:
•Enter the start of a command and press Tab to complete the command. For example, if you enter se and press Tab, set gets completed.
•Enter a menu command and press Tab to display all the commands or menu commands that are available at this menu. For example, if you enter set and press Tab you see all the set menu commands. An asterisk (*) identifies the menus.
•If you reach a command and keep pressing Tab, the current command line repeats; no additional expansion is available.
You can obtain two kinds of help on any command:
•Detailed help including a definition of the command and an example of its use
•Short query help including only command syntax
To obtain detailed help from the CLI prompt, enter:
help <command> where <command> specifies the command name or menu command and parameter. See Example 6-1.
To obtain command syntax information from the CLI prompt, enter:
<command> ? where <command> represents the command name or menu command and parameter. See Example 6-2.
Note Entering a question mark (?) after a menu command is equivalent to pressing the Tab key. The possible command completions are listed.
These examples show typical uses of the help commands.
Example 6-1 Detailed Help Example
admin: help ping
This will send one or more ping packets to a remote destination
Example:
admin:ping www.cisco.com 5
PING www.cisco.com (198.133.219.25) from 172.22.119.166 : 56(84) bytes of data.
64 bytes from 198.133.219.25: icmp_seq=1 ttl=246 time=0.837 ms
64 bytes from 198.133.219.25: icmp_seq=2 ttl=246 time=0.962 ms
64 bytes from 198.133.219.25: icmp_seq=3 ttl=246 time=1.04 ms
64 bytes from 198.133.219.25: icmp_seq=4 ttl=246 time=0.635 ms
64 bytes from 198.133.219.25: icmp_seq=5 ttl=246 time=0.666 ms
Example 6-2 Query Example
ping?
Syntax:
ping dest [count]
dest mandatory dotted IP or host name
count optional count value (default is 4)
To end the CLI session, enter quit at the CLI prompt. The system responds in one of these ways:
•If you are logged in remotely, you are logged off, and the ssh session gets dropped.
•If you are logged in locally, you are logged off, and the login prompt returns, as in this example:
login:
Table 6-7 lists and describes the commands that are available on the Cisco IPT Platform Administration CLI.