Before following the steps in this chapter, see Planning for Cisco CSS Controller. This chapter explains how to create a basic configuration for the Cisco CSS Controller component of Load Balancer.
Before you begin any of the configuration methods in this chapter:
Task | Description | Related information |
---|---|---|
Set up the Cisco CSS Controller machine | Finding out about the requirements | Setting up the Controller for Cisco CSS Switches machine |
Test your configuration | Confirming that the configuration is working | Testing your configuration |
To create a basic configuration for the Cisco CSS Controller component of Load Balancer, there are three methods:
This method is the most direct means of configuring Cisco CSS Controller. The procedures in this manual assume use of the command line. The command parameter values must be entered in English characters. The only exceptions are host names (used, for example, in the consultant add command) and file names.
To start Cisco CSS Controller from the command line:
You can enter an abbreviated version of the ccocontrol command parameters. You only need to enter the unique letters of the parameters. For example, to get help on the file save command, you can type ccocontrol he f instead of ccocontrol help file.
To start up the command line interface: issue ccocontrol to receive an ccocontrol command prompt.
To end the command line interface: issue exit or quit.
The currently-defined configuration can be saved to an XML file. This enables the configuration to be loaded at a later time when you want to quickly recreate the configuration.
To run the content of an XML file (for example, myscript.xml), use either of the following commands:
ccocontrol file save XMLFilename
ccocontrol file load XMLFileName
Use the load command only if you have previously done a file save.
The XML files are saved in the ...ibm/edge/lb/servers/configurations/cco/ directory.
For general instructions and an example of the graphical user interface (GUI), see Figure 38.
To start the GUI, follow these steps
ccoserver
.To configure the Cisco CSS Controller component from the GUI:
You can use the GUI to do anything that you would do with the ccocontrol command. For example:
To run a command from the GUI:
The results and history of the commands that you run in the current session appear in the Result box.
To access Help click the question mark icon in the upper right corner of the Load Balancer window.
For more information about using the GUI, see Appendix A. GUI: General instructions.
Before setting up the Cisco CSS Controller machine, you must be the root user (on AIX, HP-UX, Linux , or Solaris systems) or the Administrator (on Windows systems).
Consultant must be able to connect to the Cisco CSS Switch as a Cisco CSS Switch administrator.
When configuring the consultant, you must configure the address and SNMP community name to match the corresponding attributes on the Cisco CSS Switch.
For help with commands used in this procedure, see Command reference for Cisco CSS Controller.
If the ccoserver is not already running, type ccoserver as root to start it now.
Type ccocontrol to start the command line interface.
You must configure the switch address and SNMP community name. These values must match the corresponding attributes on the Cisco CSS Switch.
To add a consultant, type:
consultant add switchConsultantID address switchIPAddress
community communityName
An ownercontent is a representation of a content rule for an owner, which is defined on the Cisco CSS Switch. The owner name and content rule name must match how it is defined on the switch.
To define an ownercontent, type:
ownercontent add switchConsultantID:ownercontentID ownername ownerName
contentrule contentRuleName
When the ownercontent is defined, the consultant completes the configuration by retrieving the services configured on the switch. Compare the configuration on the switch with the configuration for the consultant to ensure that the services match.
Metrics are the measurements used to determine the service weights and associated proportions (importance of one metric compared to another), and can be any combination of connection data metrics, application advisor metrics, and metric server metrics. The proportions must always total 100.
When the ownercontent is configured, the default metrics are defined as activeconn and connrate. If you want additional metrics, or if you want metrics that are altogether different from the defaults, type:
ownercontent metrics switchConsultantID:ownercontentID metric1 proportion1
metric2 proportion2...metricN proportionN
To start the consultant, type:
consultant start switchConsultantID
This starts the metric collectors, and weight calculation begins.
If system metrics are defined in Step 5, the metric server must be started on the service machines. See Metric Server for information on using the metric server.
To configure high availability, type:
highavailability add address IPaddress partneraddress IPaddress port 80
role primary
In a high availability environment, you can configure multiple switches. To ensure that weight information is always available when one switch takes over for another switch, the Cisco CSS Controller must be configured to provide weights for all switches and their backups.
See Advanced features for Cisco CSS Controller and Nortel Alteon Controller for detailed information on how to use and configure controller high availability.
Test to see if the configuration is working: