Server
From Jaymzworld
Contents |
NAME
server - display or change server status
SYNOPSIS
server [-c|-b|-r|-i[f]|-?]
DESCRIPTION
This command allows a non-privileged user to display server duplication status as well as the simultaneous display of status for each server, along with the status of any outstanding major or minor alarms and the state of health for each of the three components: hardware health, process health, and control network health (see example below).
Other options allow a privileged user to busyout the Standby server (if present), release the busied-out server, and to interchange servers.
- no parameters
- By default, a snapshot of server status is displayed.
- -b
- Place this server out of service (i.e., busyout this server), if it is not active. If ACP has not yet been started, the request is pending and will cause the server to be placed out of service upon issuing the start command.
- -c
- Continuous looping (1-second intervals) of system status updates.
- -i
- Interchange the Active and Standby servers. File syncs are first allowed to complete before the interchange proceeds. If granting such a request would result in calls being dropped, the request will be denied.
- To over-ride this safety feature, a forced interchange may be requested by using the -f option with -i. A forced interchange will cause an interchange to occur immediately, without waiting for the Standby server to be refreshed and without waiting for a file sync to complete (potentially hazardous).
- -o
- Query state of other server
- -q
- Query state of this server
- -r
- Release this server if busied-out or, if ACP has not been started, clear any pending requests to take this server out of service.
- -v
- Verbose state of both servers
- -?
- Display the command usage.
Example of the command output
CM 2.x
SERVER STATUS
Duplicated? yes
Standby Busied? no
Standby Refreshed? yes
Standby Shadowing: on
Duplication Link: up
Last Spontaneous Interchange: 9d 22:25:57 (curbs in)
stingray-srv1 stingray-srv2
Mode: Standby Mode: Active
Major Alarms: yes Major Alarms: no
Minor Alarms: no Minor Alarms: no
Control Network: 4 / 4 Control Network: 4 / 4
Server Hardware: okay Server Hardware: degraded
Processes: crit_os Processes: okay
CM 3.x
SERVER STATUS
Cluster ID: 007
Duplicated? yes
Standby Busied? no
Standby Refreshed? yes
Standby Shadowing: on
Duplication Link: up
Last Spontaneous Interchange: 9d 22:25:57 (curbs in)
ess7-srv1 ess7-srv2
ID: 013 (1) ID: 014 (2)
Mode: Standby Mode: Active
Major Alarms: yes Major Alarms: no
Minor Alarms: no Minor Alarms: no
Control Network: 4 / 4 / 5 Control Network: 4 / 4 / 5
Server Hardware: okay Server Hardware: degraded
Processes: crit_os Processes: okay
CM 4.x
SERVER STATUS
Cluster ID: 001
Duplication: hw
Standby Busied? no
Standby Refreshed? no
Standby Shadowing: off
Duplication Link: up
Elapsed Time since Init/Interchange: 12d 21:16:04 (curbs in)
florida-s8710a florida-s8710b
ID: 001 (1) ID: 002 (2)
Mode: Active Mode: Standby
Major Alarms: no Major Alarms: no
Minor Alarms: no Minor Alarms: no
Control Network: 2 / 2 / 2 Control Network: 0 / 0 / 0
Server Hardware: okay Server Hardware: okay
Processes: okay Processes: okay
CM 5.x Processor Ethernet
SERVER STATUS
Cluster ID: 001
Duplication: sw
Standby Busied? no
Standby Refreshed? yes
Standby Shadowing: on
Duplication Link: up
Elapsed Time since Init/Interchange: 12d 21:12:39
texas-s8720a texas-s8720b
ID: 001 (1) ID: 002 (2)
Mode: Active Mode: Standby
Major Alarms: no Major Alarms: no
Minor Alarms: no Minor Alarms: no
Control Network: 0 / 0 / 0 Control Network: 0 / 0 / 0
Processor Ethernet: up Processor Ethernet: up
PE Priority: high PE Priority: high
Server Hardware: okay Server Hardware: okay
Processes: okay Processes: okay
The meaning of each line is as follows:
- Cluster ID
- Displays a three digit number corresponding to the known cluster identifier. If the license file has not been properly configured with the cluster ID, then "???" is displayed.
- Duplicated
- Displays "yes" if the local server has been configured to operate as part of a two-processor, duplicated system. Displays "no" otherwise.
- Standby Busied
- Displays "yes" if Standby server is prevented from going Active. Displays "no" otherwise.
- Standby Refreshed
- Displays "yes" if data shadowing on the Standby server is in sync with the Active server (and can therefore go Active without dropping calls), Displays "no" otherwise.
- Standby Shadowing
- Displays on if data shadowing between servers has started, Displays off otherwise.
- Duplication Link
- Displays up if the dupmgr processes on both servers have established a link in both directions. A status of half means dupmgr communication has been established in one but not both directions. A status of init means neither side knows yet whether it is even capable of contacting the other side. A status of down means no attempt is currently being made to establish a connection between dupmgrs.
- Active RAID HDD Status
- Shows that status of the RAID controller. Will be 1, 2, or -1.
- Elapsed Time since Init/Interchange
- Displays the days, hours:minutes:seconds since the last known interchange (or since system initialization, in the case where interchanges have not yet occurred).
The use of anti-thrashing curbs to restrain an interchange is indicated by the message "(curbs in)" to the right of the time since init/interchange.
The remainder of the display is divided into two columns, with headings corresponding to the names of the local server (on the left) and the remote server (on the right). The meaning of each column entry is as follows:
- ID
- Displays the server's three-digit identifier (unique across all servers and clusters) and, in parentheses, the intra-cluster server number. i.e., (1) for server1, (2) for server2. An ID of ??? (or intra-cluster server number of (?)) is displayed if the appropriate identifier cannot be determined from /etc/opt/ecs/servers.conf.
- Mode
- Displays mode of server: Not Ready (if down or initializing), Standby, BUSY OUT, or Active.
- Major Alarms
- Displays "yes" if any major ACP alarms or any major server alarms are outstanding. Displays "no" otherwise.
- Minor Alarms
- Displays "yes" if any minor ACP alarms or any minor server alarms are outstanding. Displays "no" otherwise.
- Control Network
- Displays X/Y/Z, where X = the number of IPSI-connected port networks currently being controlled by the server, and Y = the number of IPSI-connected port networks in contact with (connected to) the server. Z = the maximum number of IPSI-connected port networks that have been configured to be controlled by the server (or ?? if unknown).
Until health is reported by the alternate server, alternate health status will appear blanked out.
- Processor Ethernet
- Displays the SOH of the PE interface for each server. Values are up or down or unused. A blank value indicates an unknown status.
- PE Priority
- Weight assigned to the PE interface relative to the IPSIs, for deciding when an interchange should take place. May be set to HIGH, LOW, or IGNORE using the server web pages.
- Server Hardware
- Displays "okay" if no hardware failures have been detected, "degraded" if any hardware failures have been detected, or blank status if it has not yet been determined whether there are any hardware failures.
- Processes
- Displays "okay" if no processes watched by the watchd process have have become unrestartable. Displays blank status if the watchd process is not running, "acp_fail" if the CommunicaMgr process has failed, "svr_fail" if a non-CommunicaMgr platform process has failed, or "crit_os" if a critical O.S. service has failed.
DIAGNOSTICS
- The following messages may be produced
- 1
- Privileged Option!
- Only a super-user may use the -b, -r, -i, or -f options.
- 2
- Unable to place request now
- A prior server request did not complete properly. Cleaning up. Try again.
- 3
- A server request is already in progress
- A simultaneous server request is being processed. Try again.
- 4
- DENIED: Standby is not refreshed
- Not safe to interchange yet. Either wait or force an interchange with the -f option.
- 5
- DENIED: Standby is less healthy than Active
- An interchange can be forced (-f option). However, doing so will only result in the new Active deciding to interchange back to the healthier server.
- 6
- DENIED: No Standby is currently in service
- No other server can go active -- it has either been stopped or busied out.
- 7
- DENIED: An interchange is ALREADY in progress
- Two interchange requests have been made simultaneously, and an interchange from the first request is underway.
- 8
- DENIED: Servers are in Dual-Active mode
- This should rarely happen. Both servers are in the Active state. Through arbitration, one server will eventually correct itself, at which time interchanges may be possible.
- 9
- DENIED: server is ACTIVE!
- server -b and server -r apply to the server from which the command is issued, and that server must NOT be Active at the time.
- 10
- DENIED: Conflict with pending request
- server -b and server -r have been simultaneously issued.
