Administration Guide for Cisco Unified Messaging Gateway Release 8.6
Maintaining the Cisco UMG System

Table Of Contents

Maintaining the Cisco UMG System

Copying Configurations

Copying the Startup Configuration from the Hard Disk to Another Location

Copying the Startup Configuration from the Network FTP Server to Another Location

Examples

Copying the Running Configuration from the Hard Disk to Another Location

Examples

Copying the Running Configuration from the Network TFTP Server to Another Location

Examples

Restoring Factory Default Values

Going Offline, Reloading, Rebooting, Shutting Down, and Going Back Online

Taking the Cisco UMG System Offline

Example

Restarting the Cisco UMG System

Example

Shutting Down the Cisco UMG System

Shutting Down the Software

Shutting Down the Hardware


Maintaining the Cisco UMG System


Last updated: August 5, 2011

Copying Configurations

Restoring Factory Default Values

Going Offline, Reloading, Rebooting, Shutting Down, and Going Back Online

Copying Configurations

Use Cisco UMG EXEC commands to copy the startup configuration and running configuration to and from the hard disk on the Cisco UMG module, the network FTP server, and the network TFTP server.


Note Depending on the specific TFTP server you are using, you might need to create a file with the same name on the TFTP server and verify that the file has the correct permissions before transferring the running configuration to the TFTP server.


Copying the Startup Configuration from the Hard Disk to Another Location

Copying the Startup Configuration from the Network FTP Server to Another Location

Copying the Running Configuration from the Hard Disk to Another Location

Copying the Running Configuration from the Network TFTP Server to Another Location

Copying the Startup Configuration from the Hard Disk to Another Location

Starting in Cisco UMG EXEC mode, use the following command to copy the startup configuration on the hard disk to another location:

copy startup-config {ftp: user-id:password@ftp-server-url | tftp:tftp-server-url}

Syntax Description

ftp: user-id:password@

Username and password for the FTP server. Include the colon (:) and the at sign (@) in your entry.

ftp-server-url

URL of the FTP server including directory and filename (e.g. ftps://server/dir/filename)

tftp:tftp-server-url

URL of the TFTP server including directory and filename (e.g. tftps://server/dir/filename)


This command is interactive and prompts you for the information. You cannot enter the parameters in one line. The following examples illustrate this process.

In this example, the startup configuration is copied to the FTP server, which requires a username and password to transfer files. The startup configuration file is saved on the FTP server with the filename start.

umg-1# copy startup-config ftp
Address or name of remote host? admin:messaging@ftps://server/dir/start
Source filename? temp_start

The following example shows the startup configuration copied to the TFTP server, which does not require a username and password. The startup configuration is saved in the TFTP directory configs as filename temp_start.

umg-1# copy startup-config tftp
Address or name of remote host? tftps://server/dir/temp_start
Source filename? temp_start

Note Depending on the specific TFTP server you are using, you might need to create a file with the same name on the TFTP server and verify that the file has the correct permissions before transferring the running configuration to the TFTP server.


Copying the Startup Configuration from the Network FTP Server to Another Location

Starting in Cisco UMG EXEC mode, use the following command to copy the startup configuration on the network FTP server to another location:

copy ftp: {running-config | startup-config} user-id:password@ftps://server/dir/filename

Syntax Description

running-config

Active configuration on hard disk.

startup-config

Startup configuration on hard disk.

user-id:password@

Username and password for the FTP server. Include the colon (:) and the at sign (@) in your entry.

ftp-server-url

URL of the FTP server.


This command is interactive and prompts you for the information. You cannot enter the parameters in one line. The following example illustrates this process.

Examples

In this example, the FTP server requires a username and password. The file start in the FTP server configs directory is copied to the startup configuration.

umg-1# copy ftp: startup-config 
!!!WARNING!!! This operation will overwrite your startup configuration.
Do you wish to continue[y]? y
Address or name or remote host? admin:messaging@tftps://server/configs 
Source filename? start

Note Depending on the specific TFTP server you are using, you might need to create a file with the same name on the TFTP server and verify that the file has the correct permissions before transferring the running configuration to the TFTP server.


Copying the Running Configuration from the Hard Disk to Another Location

Starting in Cisco UMG EXEC mode, use the following command to copy the running configuration on the hard disk to another location:

copy running-config {ftp: user-id:password@ftps://server/dir/filename |
startup-config | tftp:tftps://server/dir/filename }

Syntax Description

ftp: user-id:password@

Username and password for the FTP server. Include the colon (:) and the at sign (@) in your entry.

ftp-server-url

URL of the FTP server including directory and filename..

startup-config

Startup configuration on hard disk.

tftp-server-url

URL of the TFTP server including directory and filename.


When you copy the running configuration to the startup configuration, enter the command on one line.

When you copy to the FTP or TFTP server, this command becomes interactive and prompts you for the information. You cannot enter the parameters in one line. The following example illustrates this process.

Examples

In the following example, the running configuration is copied to the FTP server, which requires a username and password. The running configuration is copied to the configs directory as file saved_start.


umg-1# copy running-config ftp:
Address or name of remote host? admin:messaging@ftps://server/configs
Source filename? saved_start

In the following example, the running configuration is copied to the startup configuration. In this instance, enter the command on a single line.

umg-1# copy running-config startup-config 

Note Depending on the specific TFTP server you are using, you might need to create a file with the same name on the TFTP server and verify that the file has the correct permissions before transferring the running configuration to the TFTP server.


Copying the Running Configuration from the Network TFTP Server to Another Location

Starting in Cisco UMG EXEC mode, use the following command to copy the running configuration from the network TFTP server to another location:

copy tftp: {running-config | startup-config} tftps://server/dir/filename

Syntax Description

running-config

Active configuration on hard disk.

startup-config

Startup configuration on hard disk.

tftp-server-url

URL of the TFTP server.


This command is interactive and prompts you for the information. You cannot enter the parameters in one line. The following example illustrates this process.

Examples

In this example, the file start in directory configs on the TFTP server is copied to the startup configuration.

umg-1# copy tftp: startup-config
!!!WARNING!!! This operation will overwrite your startup configuration.
Do you wish to continue[y]? y
Address or name of remote host? tftps://server/configs
Source filename? start

Note Depending on the specific TFTP server you are using, you might need to create a file with the same name on the TFTP server and verify that the file has the correct permissions before transferring the running configuration to the TFTP server.


Restoring Factory Default Values

Cisco UMG provides a command to restore the factory default values for the entire system. Restoring the system to the factory defaults erases the current configuration. This function is available in offline mode. When the system is clean, a message appears indicating that the system will reload, and the system begins to reload. When the reload is complete, the system prompts you to go through the postinstallation process.


Caution This operation is irreversible. All data and configuration files are erased. Use this feature with caution. We recommend that you do a full system backup before proceeding with this feature.

Procedure


Step 1 Enter the following to put the system into offline mode:

umg-1# offline

Step 2 Enter the following:

umg-1(offline)# restore factory default

The system displays a message stating that this will cause all the configuration and data on the system to be erased and this is not reversible, and asks if you want to continue.

Step 3 Do one of the following:

Enter n if you want to retain the system configuration and data.

The operation is cancelled, but the system remains in offline mode. To return to online mode, enter continue.

Enter y if you want to erase the system configuration and data.

When the system is clean, a message appears indicating that the system will start to reload. When the reload is complete, a prompt appears to start the postinstallation process.


Going Offline, Reloading, Rebooting, Shutting Down, and Going Back Online

You must take the Cisco UMG system offline before you can back up, reload, or restore the system; however, you do not need to take the system offline to shut down the system.

Always shut down Cisco UMG before power-cycling the router to avoid data loss or file corruption.

Taking the Cisco UMG System Offline

Restarting the Cisco UMG System

Shutting Down the Cisco UMG System

Taking the Cisco UMG System Offline

Using the offline command in Cisco UMG EXEC mode takes the system into offline/administration mode and terminates all directory exchanges and message forwarding. All outstanding messages will be stored for processing when the system goes back online. When you use the offline command, the system asks for confirmation. The default is no, so to confirm, you must enter yes.

Procedure


Step 1 Enter the following command:

offline

Step 2 Enter y to confirm.


Example

umg-1# offline
!!!WARNING!!!: If you are going
offline to do a backup, it is
recommended
that you save the current
running configuration using the
`write' command,
prior to going to the offline
state.
Putting the system offline will
terminate all end user sessions.
Are you sure you want to go
offline[n]? :y
umg-1(offline)

Restarting the Cisco UMG System

To restart the system using the starting configuration, use the reload command in Cisco UMG offline/administration mode. Restarting the system will terminate all end-user sessions and cause any unsaved configuration data to be lost.

Procedure


Step 1 Enter the following command:

reload


Example

umg-1(offline) reload
umg-1(offline)>
MONITOR SHUTDOWN...
EXITED: probe exit status 0
EXITED: SQL_startup.sh exit status 0
EXITED: LDAP_startup.sh exit status 0
[...]
Booting from Secure secondary boot loader..., please wait.

[BOOT-ASM]


Please enter '***' to change boot configuration:
[...]
STARTED: /bin/products/umg/umg_startup.sh

 waiting 70 ...
SYSTEM ONLINE
umg-1#

Shutting Down the Cisco UMG System

To halt the system, use the shutdown command in Cisco UMG EXEC mode. Shutting down Cisco UMG not only terminates all directory exchange and message forwarding and causes any unsaved configuration data to be lost; it also causes all registered endpoints to go offline.


Caution You must shut down the software before you shut down the hardware.

Shutting Down the Software

Shutting Down the Hardware

Shutting Down the Software

Procedure


Step 1 Enter the following command:

shutdown


Shutting Down the Hardware

Press the reset button on the network module faceplate for less than two seconds to perform a graceful shutdown of the hard disk before removing power from the router or before starting an online insertion and removal (OIR) sequence on the router. The application may take up to two minutes to fully shut down.


Caution If you press the shutdown button for more than 4 seconds, an immediate, non-graceful shutdown of the hard disk will occur and may cause file corruption on the network module's hard disk. After a non-graceful shutdown, the HD and SYS LEDs remain lit. Press the shutdown button for less than 2 seconds to gracefully reboot the network module.