User manual MACROMEDIA COLDFUSION MX-CLUSTERCATS

[. . . ] macromedia ® Using ClusterCATS Trademarks Afterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver, Authorware, Authorware Attain, Authorware Interactive Studio, Authorware Star, Authorware Synergy, Backstage, Backstage Designer, Backstage Desktop Studio, Backstage Enterprise Studio, Backstage Internet Studio, ColdFusion, Design in Motion, Director, Director Multimedia Studio, Doc Around the Clock, Dreamweaver, Dreamweaver Attain, Drumbeat, Drumbeat 2000, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, FreeHand Graphics Studio, Generator, Generator Developer's Studio, Generator Dynamic Graphics Server, JRun, Knowledge Objects, Knowledge Stream, Knowledge Track, Lingo, Live Effects, Macromedia, Macromedia M Logo & Design, Macromedia Flash, Macromedia Xres, Macromind, Macromind Action, MAGIC, Mediamaker, Object Authoring, Power Applets, Priority Access, Roundtrip HTML, Scriptlets, SoundEdit, ShockRave, Shockmachine, Shockwave, Shockwave Remote, Shockwave Internet Studio, Showcase, Tools to Power Your Ideas, Universal Media, Virtuoso, Web Design 101, Whirlwind and Xtra are trademarks of Macromedia, Inc. and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words or phrases mentioned within this publication may be trademarks, servicemarks, or tradenames of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. [. . . ] The cluster appears below the Cluster Manager icon in the ClusterCATS Explorer left pane. To manually add additional cluster members to your new cluster, see "Adding cluster members" on page 63. Creating clusters in UNIX 1 In the ClusterCATS Web Explorer, click the Create New Cluster link. The Create New Cluster page appears: 60 Chapter 4 Configuring Clusters 2 Add a cluster using the fields as described in the following table: Field Cluster Name Description Enter a unique name for the cluster. Make cluster names logically consistent with their purpose -- for example, Sales Web, or Customer Support Web. Web Server Name Enter the fully qualified host name (for example, doc. macromedia. com) for the first server you want to be a member of this cluster. You cannot create an empty cluster; you must specify a web server that will be part of the cluster. The first server that you add to a cluster is known as the Admin Manager. You cannot create an empty cluster; you must specify a web server that will be part of the cluster. 3 Click OK. ClusterCATS creates the cluster and displays its members on the Cluster Member List page, as in the following figure: Creating clusters 61 Removing clusters To delete a cluster, you must delete each member from the cluster individually, using the procedure described in "Removing cluster members" on page 65. Note: When deleting cluster members, you must delete the Admin Manager (Windows) or the Admin Agent (UNIX) last. This server is the first server you added to the cluster. When the last cluster member has been removed, the cluster itself is deleted. To determine which server is the Admin Manager in Windows: 1 Open the ClusterCATS Explorer. 2 Right-click on the cluster icon and select Configure > Administration. The cluster's Properties dialog box opens displaying the Administration tab. The server designated as the Admin Manager is the active entry in the drop-down list. To determine which server is the Admin Agent in UNIX: 1 In the ClusterCATS Web Explorer, click the Show Cluster link. 2 Enter the fully qualified host name of a server in the Web Server Name field. If you get an "Error: Server <cluster_member_name> could not be found", ensure that you used the correct, fully qualified server name and that the server is running. The Cluster Administration page appears. The Admin Agent is the currently selected host in the Admin Agent field. 62 Chapter 4 Configuring Clusters Adding cluster members You can add servers to a cluster at any time. This section describes the following: · "Adding cluster members in Windows" on page 63 · "Adding cluster members in UNIX" on page 64 Adding cluster members in Windows Use the ClusterCATS Explorer to add servers to a cluster. If you used the Cluster Setup Wizard (Windows only) to create a cluster and populate it with cluster members, you can also add clusters using the following procedure. To add an additional cluster member to a cluster: 1 Open the ClusterCATS Explorer and select a cluster. 2 Select Cluster > New > Cluster Member. Alternatively, you can click the Add button or right-click the cluster icon and select New > Cluster Member. The Add New Server to Cluster dialog box appears: 3 In the Web Server Name field, enter the fully qualified host name of the web server (for example, doc. macromedia. com). [. . . ] For servers that process database-intensive requests, ROUND_TRIP_TIME is not a good indication of load, because JRun/ColdFusion processes the threads that calculate ROUND_TRIP_TIME differently than queued database connection requests. With this in mind, if your web server uses many concurrent connections to a database, either use AVG_REQ_TIME as your load type, or include a database call in getsimpleload. jsp/ getsimpleload. cfm to make this load type's results more indicative of actual conditions. Output variables During processing, getsimpleload. jsp/getsimpleload. cfm generates three significant output variables that are sent in response to the probe agent's HTTP query: · CCLOADVALUE -- the load calculated by getsimpleload. jsp/ getsimpleload. cfm using one of the available load metrics. The load value identifies how busy the server is as a percentage of its total capacity. · CCLOADMAX -- the maximum acceptable time (in milliseconds) for a request to complete; marks the "busy threshold" for this server. [. . . ]