Cisco Element Manager System Installation and Configuration Guide, 3.1
Administering Cisco EMF Workstations
Download this chapter
Administering Cisco EMF WorkstationsAdministering Cisco EMF Workstations
 Feedback

Table Of Contents

Administering Cisco EMF Workstations

Starting Cisco EMF

Stopping Cisco EMF

Checking the Status of Cisco EMF

Logging On to Cisco EMF

Getting a Cisco EMF Shell

Updating Hostname

Updating IP address

Updating Server

TAC Support Tool


Administering Cisco EMF Workstations

This section describes how to administer Cisco EMF Server or Client workstations.

Starting Cisco EMF

The Cisco EMF software on a Server or Client workstation is automatically started during system boot-up. To start this software at other times:

Step 1 Login as the superuser (su).

Step 2 From the command line, type

<CEMF_ROOT>/bin/cemf start

where <CEMF_ROOT> is the directory in which Cisco EMF is installed.

The Cisco EMF processes start. A message informs you when the startup is complete.

Note Cisco EMF processes will not start if the host IP address cannot be reached. The Host IP address <IP Address> is unreachable - aborting .... message is displayed. The Cisco EMF processes stop.

Stopping Cisco EMF

The Cisco EMF software on a Server or Client is stopped during system shut down. To stop this software at other times:

Step 1 Quit any running Cisco EMF Launchpad sessions.

Step 2 Login as the superuser (su).

Step 3 From the command line prompt, type

<CEMF_ROOT>/bin/cemf stop

where <CEMF_ROOT> is the directory in which Cisco EMF is installed.

The Cisco EMF processes stop. A message informs you when Cisco EMF has stopped.

Checking the Status of Cisco EMF

To check the status of Cisco EMF, type:

<CEMF_ROOT>/bin/cemf query

where <CEMF_ROOT> is the directory in which Cisco EMF is installed.

If Cisco EMF is active, the system responds with a list of running Cisco EMF processes. The message Cisco EMF system not running is displayed if Cisco EMF is inactive.

Logging On to Cisco EMF

Note You must invoke the cemf start command on the Client workstation before trying to start the Client application.

To log on to Cisco EMF and start the Client application, type:

<CEMF_ROOT>/bin/cemf session

where <CEMF_ROOT> is the directory in which Cisco EMF is installed.

Getting a Cisco EMF Shell

A Cisco EMF shell is required when the Command Line Interface utility is used to perform certain operations, for example to create new thresholding regimes.

To get a Cisco EMF shell;

Step 1 Login as the superuser (su).

Step 2 From the command line prompt, type:

<CEMF_ROOT>/bin/cemf shell

The Command Line Interface screen is displayed.

Updating Hostname

During the Cisco EMF installation process the Server Hostname and Server IP Address are specified. The hostname that the Cisco EMF installation holds can be changed, if required.

This procedure only updates the information that the Cisco EMF installation has about the hostname.

To change the hostname information, proceed as follows:

Step 1 Quit any running Cisco EMF Launchpad sessions.

Step 2 Login as superuser (su).

Step 3 Change directory to the Cisco EMF bin directory, type:

cd <CEMF_ROOT>/bin

Step 4 To stop Cisco EMF, type:

./cemf stop

where <CEMF_ROOT> is the directory where Cisco EMF is installed. The Cisco EMF processes stop.

If you attempt to run this command with Cisco EMF running, an error message is displayed.

Step 5 To update the hostname, type:

./cemf updateName -m

Step 6 Enter the new hostname of your machine.

Step 7 Type <CEMF_ROOT>/bin cemf start. The Cisco EMF processes start. A message informs you when the startup is complete.

Updating IP address

During the Cisco EMF installation process the Server Hostname and Server IP Address are specified. The IP Address that the Cisco EMF installation holds can be changed, if required.

This procedure only updates the information that the Cisco EMF installation has about the IP Address.

To change the IP Address, proceed as follows:

Step 1 Quit any running Cisco EMF Launchpad sessions.

Step 2 Login as superuser (su).

Step 3 Change directory to the Cisco EMF bin directory, type:

cd <CEMF_ROOT>/bin

Step 4 To stop Cisco EMF, type:

./cemf stop

where <CEMF_ROOT> is the directory where Cisco EMF is installed. The Cisco EMF processes stop.

If you attempt to run this command with Cisco EMF running, an error message is displayed.

Step 5 To update the IP Address, type:

./cemf updateIP -m

Step 6 Enter the new IP Address of your machine.

Step 7 Type <CEMF_ROOT>/bin/cemf start. The Cisco EMF processes start. A message informs you when the startup is complete.

Updating Server

A client installation communicates back to the Cisco EMF server when required to retrieve management information. You can point the client at a new server without having to deinstall the client.

Step 1 On the client installation on a separate machine, quit any running Cisco EMF Launchpad sessions.

Step 2 Login as superuser (su).

Step 3 Change directory to the Cisco EMF bin directory, type:

cd <CEMF_ROOT>/bin

Step 4 To stop Cisco EMF, type:

./cemf stop

where <CEMF_ROOT> is the directory where Cisco EMF is installed. The Cisco EMF processes stop.

If you attempt to run this command with Cisco EMF running, an error message is displayed.

Step 5 To update the Cisco EMF server, type:

./cemf updateServer

You see the following messages: 

WARNING:This operation will change Server information held in the CEMF Client 
installation.


WARNING:For CEMF Client to function correctly, you must ensure that you provide a valid 
Server name.

Step 6 To change the server, type y, then press Enter.

Step 7 Enter, then confirm, the hostname of the new server.

Step 8 Enter, then confirm, the server host IP address.

Step 9 Type <CEMF_ROOT>/bin/cemf start. The Cisco EMF processes start. A message informs you when the startup is complete.

TAC Support Tool

The Cisco Technical Assistance Center (TAC) is available to warranty or maintenance contract customers who need technical assistance with a Cisco product that is under warranty or covered by a maintenance contract.

The script getDiagnostics is used to collect diagnostic information which can be used by TAC to support Cisco EMF development and deployments. A cemf shell is required to perform this operation.

The following parameters can be used with the getDiagnostics command.

Table 6-1 getDiagnostics Command Parameters

Parameter
Description

-d

Specify the location of database.

-t

Specify the location of tar file.

-z

Specify the location of gzip executable.

-n

Specify that file zipping should not occur.

-h

Displays help.


Step 1 Login as the superuser (su).

Step 2 Change directory to the Cisco EMF bin directory, type:

cd <CEMF_ROOT>/bin

Step 3 Get a cemf shell, type:

./cemf shell

Step 4 To gather the diagnostic information, type

./getDiagnostics <database_dir>

where <database_dir> is the location of the database directory.

A tar file, named after the current date and time is created. It can then be sent to TAC to help with problem diagnoses.

For example, at 11:23am on 9th March 2000 the superuser on machine duras cds into directory /opt/cemf/bin and executes ./getDiagnostics. A tar file, duras030900_1123.tar, containing the diagnostic information is generated. The file is generated in the directory the command is run from.