pilot

Performs troubleshooting and maintenance operations on the Pilots.

SYNOPSIS

pilot { [ ‑beacon | ‑forceFailover | ‑list | ‑sendInfoToSan | ‑serverHealthCheck | ‑shutdown ] | [ ‑usage | ‑help ] }

DESCRIPTION

When troubleshooting or maintaining an Oracle FS System, Oracle Customer Support might require that you issue one or more pilot commands. Except for the pilot ‑beacon command and the pilot ‑shutdown command, the pilot commands are not directed to a specific Pilot. Instead, the system automatically directs the pilot command to the active Pilot.

Note: The standby Pilot becomes the active Pilot in the following situations:

The active Pilot fails.
The active Pilot is forced to fail over.
The active Pilot is shut down.

Oracle Customer Support might instruct you to run a pilot ‑list command to identify the active or standby Pilot. If the IP addresses for the Pilots are required, Oracle Customer Support might request that you issue a system ‑list ‑details command.

The Pilot provides an interface for the fspm client, the fscli client, and the client for the Oracle FS System Manager to communicate with the Oracle FS System through port 26012. Within the Oracle FS System, port 26012 is enabled by default and must remain open.

SUBCOMMANDS

‑beacon: Flashes the LEDs of the specified Pilot to identify the Pilot in the data center.
‑forceFailover: Forces the active Pilot to fail over to the standby Pilot.
‑list: Returns status and operational information for the Pilots.
‑sendInfoToSan: Sends the shared IP address of the Pilots to the SAN components on the Controllers.
‑serverHealthCheck: Performs diagnostic tests on the active Pilot.
‑shutdown: Prepares the standby Pilot for maintenance.

EXAMPLE

Task

Before running diagnostic tests on an active Pilot, an Oracle Customer Support representative fails over the active Pilot to the standby Pilot. After completing the failover processes, the system marks the Pilot as SECONDARY. The system marks the former standby Pilot as PRIMARY.

Parameters

None

$ fscli pilot -forceFailover