Installing SGM on Solaris
Available Languages
Table Of Contents
Prerequisites for Installing SGM
Installing the SGM Server and Client
Installing the SGM Server Only
Installing the SGM Client Only
Installing SGM to a Different Directory
Installing the SGM Client for Solaris Using the Web Server
Viewing Packaging Information for the SGM Server and Client
Verifying the Installation Directories
Installing SGM on Solaris
This chapter describes how to install the SGM server and client software on a Sun Solaris system. It also provides information about verifying the installation and uninstalling and reinstalling SGM on Solaris.
This chapter includes the following sections:
•
Prerequisites for Installing SGM
•
•
•
•
•
Overview of Installing SGM
You can install both the SGM server software and SGM client software on a Solaris system using the following installation menu options:
•
•
•
The SGM software consists of the following Solaris packages:
•
•
When you install both the SGM server and client software on the same system, both of the listed packages must be installed successfully. When you install only the SGM server or client, only the respective package (CSCOsgm-s or CSCOsgm-c) must be installed successfully.
When the SGM installation program prompts you for a response, it displays the default value for each prompt in square brackets [ ]. To accept the default value, press Enter. (When in doubt, accept the default.)
SGM also verifies the availability of all values, such as port numbers, before accepting them.
To stop the SGM installation program at any time, press Break or Ctrl-C.
If you attempt to install SGM in one window while installing another product (such as HP OpenView) in another window, the SGM installation fails. If this situation occurs, wait until all other product installations are complete, then enter the following command from the top of the SGM CD Image:
./uninstall.sh -nThis command removes all SGM components and restores your system to a clean state. Then reinstall SGM.
Prerequisites for Installing SGM
Before you run the SGM installation program:
•
•
–
–
•
•
•
•
Upgrading SGM
If you are upgrading SGM to a new version and release (for example, from SGM 2.1 to SGM 2.2), keep the following considerations in mind:
•
–
–
•
–
–
–
–
–
–
•
For more information about SGM preferences and how to set them, see the "Modifying Preferences Settings" section of the Cisco Signaling Gateway Manager User Guide.
Becoming the Root User
To install and configure SGM, you must be logged in as the root user on the system where you want to install SGM.
Caution
If you are not logged in, log in as the root user:
> login: root> Password: root-passwordIf you are already logged in, but not as the root user, use the su command to change your login to root:
# su# Password:root-passwordInstalling the SGM Server and Client
This procedure assumes that you have not already installed the SGM server or client on this workstation. If you have already installed the SGM server or client on this workstation, some steps might be added, some might be different, and some might be unnecessary and ignored by SGM.
To install the SGM server and client at the same time, complete the following steps:
Step 1
Step 2
Step 3
# cd /cdrom/cdrom0Step 4
# ./setup.sh
Note
Step 5
1) Review README File First (Recommended)2) Install SGM Server and Client3) Install SGM Server Only4) Install SGM Client Only5) Exit SetupPlease choose an option ->Choose one of the following installation options:
•
•
Note
Step 6
=========================================================================- TCP/IP Port Usage check -=========================================================================INFO: The following parameters will be used:INFO: [1] Server Name : your_sgm_serverINFO: [2] Web Server : 1774/tcpINFO: [3] JSP Server : 1775/tcpINFO: [4] Naming Server : 44742/udpINFO: [5] Browser Path : /opt/netscape/netscapePress Enter to continue.where your_sgm_server is the name of the SGM Server.
Press Enter.
Step 7
•
•
Step 8
If you are upgrading to a new version and release of the SGM server, the SGM installation program displays the following prompt:
Do you want to upgrade to SGM - Server version 2.2.0? (y/n)? [Y]Press Enter.
The SGM installation program begins installing the SGM server, then displays the following prompt:
Press Enter to continue ->Press Enter. SGM converts your version 2.1 server data to version 2.2. Skip to Step 20.
Step 9
If your system does meet the requirements, the SGM installation program displays the following prompt:
Do you want the Express Install (y/n)? [Y]The Express Install option uses default settings, minimizing system prompts.
•
•
Step 10
Where should the product be installed? [/opt]To accept the default value, press Enter; or type a different location and press Enter.
Step 11
Which tcp port should Web Server use? [1774]To accept the default value (recommended), press Enter; or type a different, numeric port number and press Enter.
(SGM works on standard Web port 80, but software installed in the future that requires port 80 might conflict with SGM.)
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 12
Which tcp port should JSP Server use? [1775]To accept the default value, press Enter; or type a different, numeric port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 13
Which udp port should Naming Server use? [44742]To accept the default value, press Enter; or type a different, numeric port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 14
=========================================================================- SGM Server Summary -=========================================================================INFO: The following parameters will be used:INFO: [1] Server Name : your_sgm_serverINFO: [2] Web Server : your_web_server_port/tcpINFO: [3] JSP Server : your_JSP_server_port/tcpINFO: [4] Naming Server : your_naming_server_port/udpINFO: [5] Browser Path : your_netscape_browser_pathIf necessary, you can change these settings after installing SGM by using the following commands:
•
•
•
•
•
The SGM installation program then displays the following prompt:
Press Enter to continue.Press Enter.
Step 15
If CiscoWorks2000 is installed on your system, the SGM installation program automatically integrates the SGM server with CiscoWorks2000 and displays the following messages:
Registering SGM Server with CiscoWorks2000 Application Registry...Integrating SGM Server with CiscoWorks2000 Common Management Foundation...CiscoWorks2000 must be restarted to register SGM menus:/etc/init.d/dmgtd stop/etc/init.d/dmgtd startIntegration of SGM Server with CiscoWorks2000 Complete.
Note
Step 16
Would you like to configure SGM to receive SNMP traps? [yes]•
•
SGM can receive traps natively on a UDP port or receive traps via integration with HP OpenView.Enter SNMP trap integration type: native or hpov? [native]–
SGM can receive traps natively on the standard UDP port number 162 or on any other UDP port chosen. If another application is already bound to the SNMP standard trap reception port of 162, an alternate port number for SGM must be specified.UDP port number 44750 is the default alternate port.Enter trap port number? [162]By default, ITP routers send traps to port 162. To accept the default value, press Enter.
If your ITP routers have been configured to send traps to a different port, type that port number and press Enter.
By default, SGM listens for traps from trap multiplexing devices and NMS applications on port 44750. If you want SGM to monitor that port, and port 162 is not available on the SGM server device, type 44750 and press Enter.
If trap multiplexing devices and NMS applications in your network have been configured to send traps to a different port, type that port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
When you select an SNMP trap port number for the SGM server, make sure your ITP routers use the same SNMP trap port number. See the description of the snmp-server host command in the "ITP Router Requirements" section for more information.
–
Please enter location of HP OpenView home directory: [/opt/OV]To accept the default value, press Enter; or type a different location and press Enter.
Step 17
Would you like to configure SGM Security Services? [n]•
•
SGM provides two types of security authentication, Solaris and Local.Local-based authentication allows creation of user accounts and passwords local to the SGM system. When using this method, usernames, passwords, and access levels are managed using SGM commands.Solaris-based authentication uses the standard Solaris-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 system. When using this method, access levels are assigned to user accounts using SGM commands, but all usernames and passwords are managed using Solaris commands.The valid choices for authentication type are "solaris" and "local".Please choose the type of authentication to use: [local]–
Authentication type set to: local.–
Authentication type set to: solaris.The SGM installation program then displays the following messages:
User-Based Access Protection Is Enabled.Use the "sgm adduser" command to add users.Log in with usernames and passwords for access to SGM features.Step 18
SGM will discover standard ANSI/ITU Point Code Display Format from ITP Routers.Would you like to choose a custom Point Code Display Format? [n]•
•
Valid format strings areX, X.X, X.X.XorX, X-X, X-X-XX represents number of bits.Total number of bits must be either 14 bits (ITU variant) or 24 bits (ANSI or CHINA variant).Enter "itu" for 3.8.3Enter "ansi" for 8.8.8Enter "china" for 8.8.8Enter a Point Code Format Value:–
Point Code Format set to: ansi–
Point Code Format set to: china–
Point Code Format set to: ituStep 19
Would you like SGM to discover your ITP network after startup? [n]•
The SGM installation program displays the following prompt:
Enter name of ITP router to use to seed discovery:Type the name or IP address of a seed node and press Enter.
Note
For more information about the Discovery process and how to use seed nodes, see the "Discovering the Network" section of the Cisco Signaling Gateway Manager User Guide.
•
Step 20
To access the SGM Web Server use the URL:http://your_sgm_server:your_web_server_portwhere:
•
•
This URL is required if you want to install the SGM client software using the Web interface on the SGM server. See the "Installing the SGM Client for Solaris Using the Web Server" section for more information.
Tip
The SGM installation program then displays the following messages and prompt:
No Errors were encountered during installation.Please review /var/tmp/cisco_sgmsvr_install.log for detailed results.Would you like to view the log? [n]•
•
Press Enter to continue.Press Enter.
Step 21
•
•
Step 22
If you are upgrading to a new version and release of the SGM client, the SGM installation program displays the following prompt:
Do you want to upgrade to SGM - Client version 2.2.0? (y/n)? [Y]Press Enter.
The SGM installation program begins installing the SGM client, then displays the following prompt:
Press Enter to continue ->Press Enter, and skip to Step 25.
Step 23
If your system does meet the requirements, the SGM installation program displays the following prompt:
Do you want the Express Install (y/n)? [Y]The Express Install option uses default settings, minimizing system prompts.
•
•
Step 24
Where should the product be installed? [/opt]To accept the default value, press Enter; or type a different location and press Enter.
Step 25
Integrate client with a CiscoWorks2000 Server? [n]•
Integration with a CiscoWorks2000 Server was not chosen.Press Enter to continue.Press Enter.
•
Enter server name for CiscoWorks2000 Server. [your_cw2000_server]where your_cw2000_server is the host name of the CiscoWorks2000 server. The CiscoWorks2000 server can be the same as the SGM server, or it can be a different server.
To accept the default value, press Enter; or type a different server name and press Enter.
The SGM installation program displays the following prompt:
Enter port number for CiscoWorks2000 Web Server on cw2000_server. [1741]where cw2000_server is the name of the CiscoWorks2000 server. To accept the default port number, press Enter; or type a different, numeric port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
The SGM installation program displays the following message and prompt:
Integration with CiscoWorks2000 server {cw2000_server} complete.Press Enter to continue.Press Enter.
Step 26
If you are upgrading to a new version and release of the SGM client, the SGM installation program displays the following prompt:
INFO: Restoring old SGM Client Data Files...Press Enter to continue ->Press Enter, and continue with Step 27.
Step 27
No Errors were encountered during installation.Please review /var/tmp/cisco_sgmcli_install.log for detailed results.Would you like to view the log? [n]•
•
Press Enter to continue.Press Enter.
Step 28
Step 29
1) Start SGM Server and Client2) Start SGM Server Only3) Exit SetupPlease choose an option ->To start SGM at this time, type one of the options and press Enter. To start SGM at a later time, see the "Starting SGM" section.
Installing the SGM Server Only
This procedure assumes that you have not already installed the SGM server or client on this workstation. If you have already installed the SGM server or client on this workstation, some steps might be added, some might be different, and some might be unnecessary and ignored by SGM.
To install the SGM server only, complete the following steps:
Step 1
Step 2
Step 3
# cd /cdrom/cdrom0Step 4
# ./setup.sh
Note
Step 5
1) Review README File First (Recommended)2) Install SGM Server and Client3) Install SGM Server Only4) Install SGM Client Only5) Exit SetupPlease choose an option ->Choose one of the following installation options:
•
•
Step 6
=========================================================================- SGM Server Summary -=========================================================================INFO: The following parameters will be used:INFO: [1] Server Name : your_sgm_serverINFO: [2] Web Server : 1774/tcpINFO: [3] JSP Server : 1775/tcpINFO: [4] Naming Server : 44742/udpINFO: [5] Browser Path : /opt/netscape/netscapePress Enter to continue.where your_sgm_server is the name of the SGM Server.
Press Enter.
Step 7
•
•
Step 8
If you are upgrading to a new version and release of the SGM server, the SGM installation program displays the following prompt:
Do you want to upgrade to SGM - Server version 2.2.0? (y/n)? [Y]Press Enter.
The SGM installation program begins installing the SGM server, then displays the following prompt:
Press Enter to continue ->Press Enter. SGM converts your version 2.1 server data to version 2.2. Skip to Step 20.
Step 9
If your system does meet the requirements, the SGM installation program displays the following prompt:
Do you want the Express Install (y/n)? [Y]The Express Install option uses default settings, minimizing system prompts.
•
•
Step 10
Where should the product be installed? [/opt]To accept the default value, press Enter; or type a different location and press Enter.
Step 11
Which tcp port should Web Server use? [1774]To accept the default value (recommended), press Enter; or type a different, numeric port number and press Enter.
(SGM works on standard Web port 80, but software installed in the future that requires port 80 might conflict with SGM.)
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 12
Which tcp port should JSP Server use? [1775]To accept the default value, press Enter; or type a different, numeric port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 13
Which udp port should Naming Server use? [44742]To accept the default value, press Enter; or type a different, numeric port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 14
=========================================================================- SGM Server Summary -=========================================================================INFO: The following parameters will be used:INFO: [1] Server Name : your_sgm_serverINFO: [2] Web Server : your_web_server_port/tcpINFO: [3] JSP Server : your_JSP_server_port/tcpINFO: [4] Naming Server : your_naming_server_port/udpINFO: [5] Browser Path : your_netscape_browser_pathIf necessary, you can change these settings after installing SGM by using the following commands:
•
•
•
•
•
The SGM installation program then displays the following prompt:
Press Enter to continue.Press Enter.
Step 15
If CiscoWorks2000 is installed on your system, the SGM installation program automatically integrates the SGM server with CiscoWorks2000 and displays the following messages:
Registering SGM Server with CiscoWorks2000 Application Registry...Integrating SGM Server with CiscoWorks2000 Common Management Foundation...CiscoWorks2000 must be restarted to register SGM menus:/etc/init.d/dmgtd stop/etc/init.d/dmgtd startIntegration of SGM Server with CiscoWorks2000 Complete.
Note
Step 16
Would you like to configure SGM to receive SNMP traps? [yes]•
•
SGM can receive traps natively on a UDP port or receive traps via integration with HP OpenView.Enter SNMP trap integration type: native or hpov? [native]–
SGM can receive traps natively on the standard UDP port number 162 or on any other UDP port chosen. If another application is already bound to the SNMP standard trap reception port of 162, an alternate port number for SGM must be specified.UDP port number 44750 is the default alternate port.Enter trap port number? [162]By default, ITP routers send traps to port 162. To accept the default value, press Enter.
If your ITP routers have been configured to send traps to a different port, type that port number and press Enter.
By default, SGM listens for traps from trap multiplexing devices and NMS applications on port 44750. If you want SGM to monitor that port, and port 162 is not available on the SGM server device, type 44750 and press Enter.
If trap multiplexing devices and NMS applications in your network have been configured to send traps to a different port, type that port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
When you select an SNMP trap port number for the SGM server, make sure your ITP routers use the same SNMP trap port number. See the description of the snmp-server host command in the "ITP Router Requirements" section for more information.
–
Please enter location of HP OpenView home directory: [/opt/OV]To accept the default value, press Enter; or type a different location and press Enter.
Step 17
Would you like to configure SGM Security Services? [n]•
•
SGM provides two types of security authentication, Solaris and Local.Local-based authentication allows creation of user accounts and passwords local to the SGM system. When using this method, usernames, passwords, and access levels are managed using SGM commands.Solaris-based authentication uses the standard Solaris-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 system. When using this method, access levels are assigned to user accounts using SGM commands, but all usernames and passwords are managed using Solaris commands.The valid choices for authentication type are "solaris" and "local".Please choose the type of authentication to use: [local]–
Authentication type set to: local.–
Authentication type set to: solaris.The SGM installation program then displays the following messages:
User-Based Access Protection Is Enabled.Use the "sgm adduser" command to add users.Log in with usernames and passwords for access to SGM features.Step 18
SGM will discover standard ANSI/ITU Point Code Display Format from ITP Routers.Would you like to choose a custom Point Code Display Format? [n]•
•
Valid format strings areX, X.X, X.X.XorX, X-X, X-X-XX represents number of bits.Total number of bits must be either 14 bits (ITU variant) or 24 bits (ANSI or CHINA variant).Enter "itu" for 3.8.3Enter "ansi" for 8.8.8Enter "china" for 8.8.8Enter a Point Code Format Value:–
Point Code Format set to: ansi–
Point Code Format set to: china–
Point Code Format set to: ituStep 19
Would you like SGM to discover your ITP network after startup? [n]•
The SGM installation program displays the following prompt:
Enter name of ITP router to use to seed discovery:Type the name or IP address of a seed node and press Enter.
Note
For more information about the Discovery process and how to use seed nodes, see the "Discovering the Network" section of the Cisco Signaling Gateway Manager User Guide.
•
Step 20
To access the SGM Web Server use the URL:http://your_sgm_server:your_web_server_portwhere:
•
•
This URL is required if you want to install the SGM client software using the Web interface on the SGM server. See the "Installing the SGM Client for Solaris Using the Web Server" section for more information.
Tip
The SGM installation program then displays the following messages and prompt:
No Errors were encountered during installation.Please review /var/tmp/cisco_sgmsvr_install.log for detailed results.Would you like to view the log? [n]•
•
Press Enter to continue.Press Enter.
Step 21
Step 22
1) Start SGM Server Only2) Exit SetupPlease choose an option ->To start SGM at this time, type one of the options and press Enter. To start SGM at a later time, see the "Starting SGM" section.
Installing the SGM Client Only
This procedure assumes that you have not already installed the SGM server or client on this workstation. If you have already installed the SGM server or client on this workstation, some steps might be added, some might be different, and some might be unnecessary and ignored by SGM.
During installation, the SGM installation program prompts you for the full path to the Netscape Communicator executable file. Verify the location of the file before installing the SGM client. You can run SGM without Netscape, but Netscape is required to access the online help, to install the SGM client using the Web Server, to access the SGM server home page, and to launch CiscoView and CiscoWorks2000. You can also change the path at any time after installation using the sgm browserpath command. For more information, see the "SGM Command Reference" appendix in the Cisco Signaling Gateway Manager User Guide.
To install the SGM client only, complete the following steps:
Step 1
Step 2
Step 3
# cd /cdrom/cdrom0Step 4
# ./setup.sh
Note
Step 5
1) Review README File First (Recommended)2) Install SGM Server and Client3) Install SGM Server Only4) Install SGM Client Only5) Exit SetupPlease choose an option ->Choose one of the following installation options:
•
•
Step 6
•
•
Step 7
If you are upgrading to a new version and release of the SGM client, the SGM installation program displays the following prompt:
Do you want to upgrade to SGM - Client version 2.2.0? (y/n)? [Y]Press Enter.
The SGM installation program begins installing the SGM client, then displays the following prompt:
Press Enter to continue ->Press Enter, and skip to Step 14.
Step 8
What is the hostname of the SGM Server?Type the name of the SGM server host, and press Enter.
Step 9
Which tcp port does SGM Web Server use? [1774]To accept the default value (recommended), press Enter; or type a different, numeric TCP/IP port number and press Enter.
(SGM works on standard Web port 80, but software installed in the future that requires port 80 might conflict with SGM.)
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 10
Which tcp port does SGM JSP Server use? [1775]To accept the default value, press Enter; or type a different, numeric TCP/IP port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 11
Which udp port does SGM Naming Server use? [44742]To accept the default value, press Enter; or type a different, numeric UDP port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
Step 12
What is the executable path name for Netscape? [/opt/netscape/netscape]•
•
Tip
Step 13
Where should the product be installed? [/opt]To accept the default value, press Enter; or type a different location and press Enter.
Step 14
Integrate client with a CiscoWorks2000 Server? [n]•
Integration with a CiscoWorks2000 Server was not chosen.Press Enter to continue.Press Enter.
•
Enter server name for CiscoWorks2000 Server. [your_cw2000_server]where your_cw2000_server is the host name of the CiscoWorks2000 server.The CiscoWorks2000 server can be the same as the SGM server, or it can be a different server.
To accept the default value, press Enter; or type a different server name and press Enter. The SGM installation program displays the following prompt:
Enter port number for CiscoWorks2000 Web Server on cw2000_server. [1741]where cw2000_server is the name of the CiscoWorks2000 server. To accept the default port number, press Enter; or type a different, numeric port number and press Enter.
Do not enter a non-numeric port number. If you do, you are prompted to enter a numeric port number.
The SGM installation program displays the following message and prompt:
Integration with CiscoWorks2000 server {cw2000_server} complete.Press Enter to continue.Press Enter.
Note
Step 15
If you are upgrading to a new version and release of the SGM client, the SGM installation program displays the following prompt:
INFO: Restoring old SGM Client Data Files...Press Enter to continue ->Press Enter, and continue with Step 16.
Step 16
No Errors were encountered during installation.Please review /var/tmp/cisco_sgmcli_install.log for detailed results.Would you like to view the log? [n]•
•
Press Enter to continue.Press Enter.
Step 17
Step 18
1) Start SGM Client and Connect to Default Remote Server2) Start SGM Client and Connect to Alternate Remote Server4) Exit SetupPlease choose an option ->To start SGM at this time, type one of the options and press Enter. To start SGM at a later time, see the "Starting SGM" section.
Installing SGM to a Different Directory
To install the SGM software in a directory other than the /opt default directory, use the standard installation and specify a new location to install the SGM software.
In the following example, the SGM installation program detects insufficient space in the /opt default directory and recommends an alternate directory, /usr2, which has enough available space:
============================================================================- Disk Space Usage check -==============================================================================INFO: For this product the default disk space requirements are:/opt 30000 K/var/sadm 1000 K/var/tmp 1000 K/tmp 1000 KINFO: Checking default disk space requirements...INFO: /opt has insufficient space for installation.INFO: Express Install has been disabled.============================================================INFO: Local disks on this machine with enough space to install:Filesystem kbytes used avail capacity Mounted on/dev/dsk/c0t4d0s6 1925720 288623 1444527 17% /usr2Where should the product be installed? [/usr2]To accept the recommended directory, press Enter. Otherwise, specify another directory and press Enter.
Specifying Alternate Ports
The SGM client and server software must be set up to communicate on the same port. If you are installing the SGM client on the same machine as the SGM server, the installation program handles this automatically. If you are installing the SGM client on a separate system from the server, you must make sure the ports specified during the client installation match those installed for the SGM server. In most installation situations the default ports should be available for the SGM client and server.
The SGM server software uses the following default ports:
•
•
•
The SGM client software must know which ports the SGM server is using. By default, the client uses the following ports:
•
•
•
When you install the SGM server, or the SGM server and client, the SGM installation program determines whether or not these ports are available. (This is not done when you install only the SGM client.) If there are conflicts with the ports, the software provides you with the option to specify an alternate port number.
To determine the ports that are currently in use on your system, use the netstat command for the corresponding port type (TCP or UDP):
#netstat -a -n -f inet -P {tcp|udp}
Note
Installing the SGM Client for Solaris Using the Web Server
You can access the SGM client installation software from the SGM Web Server. This is useful if you do not have the CD-ROM, or if you prefer to download the software from the SGM server. Once you have downloaded the SGM 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 SGM client software on a Solaris system.
To install the SGM client using the Web interface:
Step 1
Step 2
http://sgm_web_server:1774where sgm_web_server is the name or IP address of the SGM Web Server and 1774 is the Web port being using by SGM. (1774 is the default port number.) If you do not know the name or Web port of the SGM Web Server, contact the system administrator who installed the SGM server software.
SGM displays the SGM Server Home Page (Figure 2-1).
Figure 2-1 SGM Server Home Page
Step 3
Step 4
Step 5
Step 6
# unzip sgmClient22-download-sol.zipStep 7
# cd sgmClient22-download-solStep 8
# ./setup.sh
Note
The SGM installation program displays the installation menu:
1) Review README File First (Recommended)4) Install SGM Client Only5) Exit SetupPlease choose an option ->Choose one of the following installation options:
•
•
The rest of the SGM client installation is identical to Step 8 through Step 18 of the "Installing the SGM Client Only" section.
Step 9
# rm -rf temp_directoryWhere temp_directory is the directory containing the downloaded files.
Verifying SGM Installation
You can verify successful installation of the SGM server and client software by performing the following tasks:
•
•
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 SGM installation script.
To check for installation error messages:
Step 1
Step 2
# more install_directory/install/cisco_sgmsvr_install.logWhere install_directory is the directory in which SGM was installed. The default installation directory for SGM is /opt/CSCOsgm.
Step 3
# more install_directory/install/cisco_sgmcli_install.logStep 4
You can also display the SGM server and client installation logs using the sgm installlog command. For more information, see the "SGM Command Reference" appendix in the Cisco Signaling Gateway Manager User Guide.
Viewing Packaging Information for the SGM Server and Client
You can use the pkginfo command to verify that the SGM server (CSCOsgm-s) and SGM client (CSCOsgm-c) software packages are installed on your system.
To view packaging information for the SGM server and client:
Step 1
#pkginfo -l CSCOsgm-s#pkginfo -l CSCOsgm-cStep 2
PKGINST: CSCOsgm-sNAME: Cisco SGM ServerCATEGORY: applicationARCH: sparcVERSION: 2.2BASEDIR: /opt/CSCOsgmVENDOR: Cisco Systems, IncDESC: Cisco SGM ServerPSTAMP: cwb-sun1m09030230INSTDATE: October 27 2002 11:44HOTLINE: 1-800-553-2447EMAIL: tac@cisco.comSTATUS: completely installedFILES: 600 installed pathnames92 directories471 executables102052 blocks used (approx)If the package was not found, the following message is displayed:
ERROR: information for "CSCOsgm-s" was not foundThe SGM software package was not installed. Install SGM again.
Verifying the Installation Directories
After you install SGM, use the ls command to verify that you have a new directory structure containing the SGM software.
•
•
•
Starting SGM
After you install the SGM server and client software, verify that you can start the SGM software. You can start the SGM software by selecting the corresponding option on the start-up menu after the installation program is complete.
You can also start the SGM server and client from the command line.
There is no harm in attempting to start an SGM server or client if it is already running.
Note
To start just the SGM server from the command line, log in as the root user and use the following commands:
# cd /opt/CSCOsgm/bin# ./sgm startTo start just the SGM client from the command line, use the following commands:
# cd /opt/CSCOsgm/bin# ./sgm client server_nameFor a complete list of all of the SGM commands, see the "SGM Command Reference" appendix in the Cisco Signaling Gateway Manager User Guide.
If the SGM server and client installation was successful, and if you did not configure the SGM server to automatically discover your network the first time the server starts after installation, SGM displays the Discovery Dialog (Figure 2-2) and the Linkset window (Figure 2-3).
Figure 2-2 Discovery Dialog
Figure 2-3 Linkset Window
When you start SGM for the first time, if you did not configure the SGM server to automatically discover your network the first time the server starts after installation, the SGM database contains no information, and the Linkset window is blank. The database is populated, and reflected in the Linkset window, when you run Discovery for the first time; SGM displays the Discovery Dialog to make it easier for you to do so. In fact, any time you start the SGM client and the SGM database is empty, SGM automatically opens the Discovery Dialog so you can run Discovery and populate the database. For more information about Discovery, see the "Discovering the Network" section of the Cisco Signaling Gateway Manager User Guide.
SGM will always display the Linkset window at startup unless you specify otherwise in the General GUI Settings section of the Preferences window. For more information about setting GUI preferences, see the "Modifying Preference Settings" section of the Cisco Signaling Gateway Manager User Guide.
Uninstalling SGM
The uninstall program provides you with a menu similar to that presented for installation. You can choose whether to uninstall both the SGM client and server software (for example, after a failed installation) or uninstall each package individually.
Uninstalling SGM is discussed in the following sections:
•
Overview of Uninstalling SGM
When you run the uninstall program, remember the following information:
•
•
•
Uninstall both the SGM server software and client software on a Solaris system, either at the same time or separately, using the following menu options provided by the uninstall program.
1.
2.
Note
3.
Running the Uninstall Program
To uninstall the SGM software:
Step 1
Step 2
Tip
You do not need to stop the SGM server; the SGM uninstall program stops the server automatically.
Step 3
# cd /opt/CSCOsgm/install# ./uninstall.shIf you installed the SGM client only, enter the following commands:
# cd /opt/CSCOsgmClient/install# ./uninstall.shYou can also use the sgm uninstall command; see the "SGM Command Reference" appendix in the Cisco Signaling Gateway Manager User Guide.
Step 4
Choose one of the following actions:
•
•
•
Step 5
Step 6
For example, the following example shows the message received when uninstalling the SGM server:
INFO: The following Cisco SGM packagesINFO: have been successfully deleted from the system: CSCOsgm-sPlease review /var/tmp/cisco_sgmsvr_uninstall.log for detailed resultsStep 7
# pkginfo -l CSCOsgm-sERROR: information for "CSCOsgm-s" was not found# pkginfo -l CSCOsgm-cERROR: information for "CSCOsgm-c" was not found
Feedback