Cisco GSS Getting Started Guide (Software Version 2.0) - Activating GSS Devices from the CLI [Cisco ACE GSS 4400 Series Global Site Selector Appliances]

Table Of Contents

Activating GSS Devices from the CLI

Activating or Deleting GSS Devices from the Primary GSSM

Displaying the Configuration for Registered GSS Devices

Using Scripts in GSLB Configuration

Where to Go Next

Activating GSS Devices from the CLI

This chapter describes how to activate GSS devices from the primary GSSM CLI as the first step in configuring request routing and global server load balancing on your GSS network.

This chapter contains the following major sections:

•Activating or Deleting GSS Devices from the Primary GSSM

•Displaying the Configuration for Registered GSS Devices

•Using Scripts in GSLB Configuration

•Where to Go Next

Activating or Deleting GSS Devices from the Primary GSSM

After you log in to the CLI and enable privileged EXEC mode, you enter the gslb command to access the global server load-balancing configuration mode. The CLI prompt then changes to (config-gslb). For example:
gssm1.example.com(config)# gslb
gssm1.example.com(config-gslb)# 
To activate the registered GSS devices on the primary GSSM, perform the following steps:

1. Modify or activate GSS device configuration by using the gss-device command. Specifically, this command does the following:

–Activates the GSS device

–Changes the Location

–Changes the Name

The syntax for this command is as follows:

gss-device Name [name newName] [location locationName] activate

The keywords and arguments are as follows:

–name—Specifies the GSS device name.

–name newName—(Optional) Specifies the new GSS device name.

–location locationName—(Optional) Specifies the GSS location. The location is part of the overall GSLB configuration

–activate—Activates the specified GSS. Be aware that you can only activate one GSS at a time.

For example:
gss1.com(config-gslb)# gss-device gss-sample.cisco.com name name1 
location sj activate
gss1.com(config-gslb)#
If the named GSS is not registered, the command displays an error message.

Note The configuration for this command is stored in the GSLB configuration and propagated to the other GSS devices in the mesh.

2. Delete a GSS device by using the no gss-device command. The syntax for this command is as follows:

no gss-device Name

The name argument specifies the GSS that you wish to delete.

If there is no GSS with the specified name, an error message appears.

Note The no gss-device command clears the device status from the show gslb-config gss-device command output. For more information on this command, see the "Displaying the Configuration for Registered GSS Devices" section.

3. Clear the GSLB configuration from the show gslb-config gss-device command output by using the clear gslb-config command.

The syntax for this command is as follows:

clear gslb-config

For example:
gss1.com# clear gslb-config
gss1.com#
If a location is referenced in the GSS configuration, the location and region fields are cleared from the configuration by this command.

Note If you attempt to delete a location while it is being used in the GSS configuration, an error message displays and the command is not executed.

Displaying the Configuration for Registered GSS Devices

To display configuration information for registered GSS devices, perform the following steps:

1. List all the registered GSS devices and display minimal information for each by using the show resources gss-device command. The syntax for this command is as follows:

show resources gss-devices

For example:
gss-kingfisher.cisco.com#show resources gss-device
GSS Device: gss-kingfisher.cisco.com
	Status		: Online 
	Node Services		: GSS; Primary GSSM 
	IP Address		: 16.1.1.105 
	Location			: Bangalore
	Region		: India
GSS Device: gss-kiwi.cisco.com
	Status		: Online 
	Node Services		: GSS
	IP Address		: 16.1.1.114 
	Location			: SJ 
	Region		: USA
2. Display complete information for a specified device by using the show resources gss-device command followed by a given name.

The syntax for this command is as follows:

show resources gss-devices name

For example:
gss-kingfisher.cisco.com#show resources gss-device
GSS Device: gss-kingfisher.cisco.com
	General Configuration 
		Name		: gss-kingfisher.cisco.com
	Locality 
		Location			: Bangalore 
		Region		: India
	Node Information 
		Status		: Online 
		Version			: 2.0.0.0.5 
		Node Services		: GSS; Primary GSSM
	Network Information 
		IP Address			: 16.1.1.105 
		HostName			: gss-kingfisher.cisco.com 
		Mac			: 00:c0:9f:e4:12:ef
3. List only the devices which are activated from the GUI or CLI among the registered devices by using the show gslb-config gss-device command.

The syntax for this command is as follows:

show gslb-config gss-device

For example:
gss-kingfisher.cisco.com#show gslb-config gss-device
gss-device gss-kingfisher.cisco.com location Bangalore activate
Using Scripts in GSLB Configuration

If you wish, you can copy and use scripts in GSLB configuration using the script play-config command.

The syntax for this command is as follows:

script play-config filename

The filename variable is the name of a previously created GSLB configuration file that resides on the root directory of the primary GSSM. The GSLB configuration file could be a file that was created on the primary GSSM on which it resides, or it could be a file that was created on the primary GSSM on another GSS network, then copied to this primary GSSM.

For example, if you take a GSS configuration from the primary GSSM A using the following CLI command:

copy gslb-config disk filename

You can then execute this configuration on primary GSSM B by using script play-config as follows:
gss1.com(config-gslb)# script play-config sampleconfig
gss1.com(config-gslb)#
This command will then run the commands to activate the device on the primary GSSM B if the device is registered with the same name. For more information on executing GSLB configuration files using script play-config, see the Cisco Global Site Selector CLI-Based Global Server Load Balancing Configuration Guide.

Note When upgrading from pre-v2.0 versions of the GSS software to v2.0, the entire registered GSS device configuration is retained.

Where to Go Next

After you activate your GSS devices from the primary GSSM, you can begin configuring request routing and global server load balancing on your GSS network. To configure your GSS devices and resources from the primary GSSM for global server load-balancing, proceed to Chapter 7, , Global Server Load Balancing Summary.

	Cisco GSS Getting Started Guide (Software Version 2.0)
	Activating GSS Devices from the CLI
Cisco GSS Getting Started Guide (Software Version 2.0) Index Preface Using the CLI and GUI to Manage a GSS Network Configuring the GSS Using the CLI Setup Script Accessing the GSS CLI Setting Up Your GSS from the CLI Activating GSS Devices from the GUI Activating GSS Devices from the CLI Global Server Load Balancing Summary	Download this chapter Activating GSS Devices from the CLI Download the complete book Cisco Global Site Selector Getting Started Guide, Book-Length PDF (PDF - 1 MB) Table Of Contents Activating GSS Devices from the CLI Activating or Deleting GSS Devices from the Primary GSSM Displaying the Configuration for Registered GSS Devices Using Scripts in GSLB Configuration Where to Go Next Activating GSS Devices from the CLI This chapter describes how to activate GSS devices from the primary GSSM CLI as the first step in configuring request routing and global server load balancing on your GSS network. This chapter contains the following major sections: •Activating or Deleting GSS Devices from the Primary GSSM •Displaying the Configuration for Registered GSS Devices •Using Scripts in GSLB Configuration •Where to Go Next Activating or Deleting GSS Devices from the Primary GSSM After you log in to the CLI and enable privileged EXEC mode, you enter the gslb command to access the global server load-balancing configuration mode. The CLI prompt then changes to (config-gslb). For example: gssm1.example.com(config)# gslb gssm1.example.com(config-gslb)# To activate the registered GSS devices on the primary GSSM, perform the following steps: 1. Modify or activate GSS device configuration by using the gss-device command. Specifically, this command does the following: –Activates the GSS device –Changes the Location –Changes the Name The syntax for this command is as follows: gss-device Name [name newName] [location locationName] activate The keywords and arguments are as follows: –name—Specifies the GSS device name. –name newName—(Optional) Specifies the new GSS device name. –location locationName—(Optional) Specifies the GSS location. The location is part of the overall GSLB configuration –activate—Activates the specified GSS. Be aware that you can only activate one GSS at a time. For example: gss1.com(config-gslb)# gss-device gss-sample.cisco.com name name1 location sj activate gss1.com(config-gslb)# If the named GSS is not registered, the command displays an error message. Note The configuration for this command is stored in the GSLB configuration and propagated to the other GSS devices in the mesh. 2. Delete a GSS device by using the no gss-device command. The syntax for this command is as follows: no gss-device Name The name argument specifies the GSS that you wish to delete. If there is no GSS with the specified name, an error message appears. Note The no gss-device command clears the device status from the show gslb-config gss-device command output. For more information on this command, see the "Displaying the Configuration for Registered GSS Devices" section. 3. Clear the GSLB configuration from the show gslb-config gss-device command output by using the clear gslb-config command. The syntax for this command is as follows: clear gslb-config For example: gss1.com# clear gslb-config gss1.com# If a location is referenced in the GSS configuration, the location and region fields are cleared from the configuration by this command. Note If you attempt to delete a location while it is being used in the GSS configuration, an error message displays and the command is not executed. Displaying the Configuration for Registered GSS Devices To display configuration information for registered GSS devices, perform the following steps: 1. List all the registered GSS devices and display minimal information for each by using the show resources gss-device command. The syntax for this command is as follows: show resources gss-devices For example: gss-kingfisher.cisco.com#show resources gss-device GSS Device: gss-kingfisher.cisco.com Status : Online Node Services : GSS; Primary GSSM IP Address : 16.1.1.105 Location : Bangalore Region : India GSS Device: gss-kiwi.cisco.com Status : Online Node Services : GSS IP Address : 16.1.1.114 Location : SJ Region : USA 2. Display complete information for a specified device by using the show resources gss-device command followed by a given name. The syntax for this command is as follows: show resources gss-devices name For example: gss-kingfisher.cisco.com#show resources gss-device GSS Device: gss-kingfisher.cisco.com General Configuration Name : gss-kingfisher.cisco.com Locality Location : Bangalore Region : India Node Information Status : Online Version : 2.0.0.0.5 Node Services : GSS; Primary GSSM Network Information IP Address : 16.1.1.105 HostName : gss-kingfisher.cisco.com Mac : 00:c0:9f:e4:12:ef 3. List only the devices which are activated from the GUI or CLI among the registered devices by using the show gslb-config gss-device command. The syntax for this command is as follows: show gslb-config gss-device For example: gss-kingfisher.cisco.com#show gslb-config gss-device gss-device gss-kingfisher.cisco.com location Bangalore activate Using Scripts in GSLB Configuration If you wish, you can copy and use scripts in GSLB configuration using the script play-config command. The syntax for this command is as follows: script play-config filename The filename variable is the name of a previously created GSLB configuration file that resides on the root directory of the primary GSSM. The GSLB configuration file could be a file that was created on the primary GSSM on which it resides, or it could be a file that was created on the primary GSSM on another GSS network, then copied to this primary GSSM. For example, if you take a GSS configuration from the primary GSSM A using the following CLI command: copy gslb-config disk filename You can then execute this configuration on primary GSSM B by using script play-config as follows: gss1.com(config-gslb)# script play-config sampleconfig gss1.com(config-gslb)# This command will then run the commands to activate the device on the primary GSSM B if the device is registered with the same name. For more information on executing GSLB configuration files using script play-config, see the Cisco Global Site Selector CLI-Based Global Server Load Balancing Configuration Guide. Note When upgrading from pre-v2.0 versions of the GSS software to v2.0, the entire registered GSS device configuration is retained. Where to Go Next After you activate your GSS devices from the primary GSSM, you can begin configuring request routing and global server load balancing on your GSS network. To configure your GSS devices and resources from the primary GSSM for global server load-balancing, proceed to Chapter 7, , Global Server Load Balancing Summary.
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.