The internal farm state as maintained by the SP is only visible to you through the SP command-line interface. You must understand these internal states as they help you monitor the progress of a farm through the various stages of automated activation, updates, and decommissioning, as well as troubleshooting problems. Internal states are represented as integers. The valid internal state values are described in the following table:
Table 6–1 Valid Internal State Values
Internal State |
Internal State Value |
External State |
Meaning |
---|---|---|---|
CREATED |
0 |
New |
The farm has just been created but not submitted for activation. |
NEW_CONFIG |
10 |
New |
Same as CREATED in terms of farm resource changes, but the SP has now taken over the farm. |
ALLOCATED |
20 |
New |
Resources are allocated to the farm in the database. |
WIRED |
30 |
New |
Physical devices are connected according to the farm topology. |
DISPATCHED |
40 |
New |
An SP server owns the farm. Domain Name System (DNS), Dynamic Host Configuration Protocol (DHCP), and Network Interface Card (NIC) are set up for the farm. Farm monitoring is also registered or in the process of registering at this stage if applicable. This action is part of both the initial activation process and the farm update process. |
ACTIVE |
50 |
Active |
The farm is active and running. |
IDLE |
60 |
Active |
Reserved for Sun Microsystems. |
STANDBY |
70 |
Standby |
The farm is on standby. IP addresses are still associated with the farm. |
SHUTDOWN |
90 |
Active (pending standby or inactive) |
The farm devices are shut down. |
UNWIRED |
100 |
Active (pending standby or inactive) |
Physical devices are detached from the farm. |
DEACTIVATED |
110 |
Inactive |
The farm is deactivated and all resources are freed. |
UPDATED |
120 |
Active |
The farm has been updated. |
Use the command farm -l to list information about a farm. Used as is, farm –l lists information about all farms. Used with a farm ID (a unique string assigned when the farm is created), farm –l farm_ID lists information for a specific farm. The output looks like the following:
FARM_ID FARM_NAME CUSTOMER STATE ISTATE ERROR OWNER 123 testx Customerx ACTIVE ACTIVE 0 SM:cp1
As shown in this example, both the farm's external and internal states are listed. Also, the internal state has been translated from a numerical value to a text string.