system_log ‑collect

Collects system logs and stores them in a log bundle on the Oracle FS System.

SYNOPSIS

system_log ‑collect 
      { ‑all
       |[‑eventLog]
        [‑statistics]
        [‑systemConfig]
        [‑pilot]
        [‑sanhostLogs]
        [‑controllerBackup]
        [‑controllerInMemory]
        [‑controllerLogs]
        [‑replicationAppliance]
        [‑client]
    }
      [‑controller controller‑id‑or‑fqn [, controller‑id‑or‑fqn ]... ]
      [‑sanhost sanhost‑id‑or‑fqn [, sanhost‑id‑or‑fqn]... ]
      [‑sendToCallHome
            [{ ‑logBundle log‑bundle‑id‑or‑fqn [,log‑bundle‑id‑or‑fqn]...
            | ‑previousBundles time‑frame {minutes | hours | days}
            }]
      ]
      [‑withinLastHours number‑of‑hours ]
      [‑collectionReason reason‑description ]
      [‑uploadClientLogsFirst]

   [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}]
   [{‑outputformat | ‑o} { text | xml }]
   [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]

DESCRIPTION

Your Oracle Customer Support representative might ask you to collect logs and either send them to the Oracle Server or transfer them using My Oracle Support. If your Oracle Customer Support representative does not specify which logs to collect, assume that all are collected. Run the system_log ‑collect ‑all command when instructed to do so.

Note: The private interconnect management (topology) logs are not collected with system logs. The topology logs cannot be collected with any other logs.

Note: Administrators with primary administrator, admin1, admin2, monitor, or support roles are authorized to run the system_log ‑collect command.

OPTIONS

‑all

Collects the following information and creates a log bundle:

Event log
System statistics
System configuration database (Persistence)
Pilot logs
Controller backup data
Controller logs that are stored in memory
Controller logs
Replication appliance logs
Client logs for GUI clients that are currently logged in.

‑client

Specifies that any Oracle FS System Manager (GUI) logs and Oracle FS CLI client logs that have already been uploaded to the Pilot to be included in the log bundle.

‑collectionReason

Specifies a string to describe the reason for collecting the logs. If the string contains spaces, you do not need to enclose the string in double quotes.

Important! If you are collecting logs and transferring them to the Call‑Home server, ensure that there is an existing My Oracle Support (MOS) service request (SR) and enter the number of the SR in this field. This field is required and must contain an SR number when sending logs to the Oracle Call‑Home server so that those logs are properly attached to the MOS SR. Also, ensure that you have enabled Oracle Auto Service Request (ASR).

‑controller

Specifies the fully qualified name (FQN) or the unique identifier (ID) of one or more Controllers for the Oracle FS System.

‑controllerBackup

Collects data from the Controller backup logs.

‑controllerInMemory

Collects the current Controller logs that are stored in memory.

‑controllerLogs

Collects the Controller logs that are backed up and stored in memory.

‑eventLog

Collects the log of all events that are generated and stored on the Pilot.

‑logBundle

Specifies the fully qualified names or unique IDs of one or more log bundles that were previously collected. Multiple log bundles are specified by using a comma separated list of log bundles.

‑pilot

Collects all logs that are maintained for the software components on the Pilot.

‑previousBundles

Transfers all previously existing log bundles within the specified the -timeframe option. The previous bundles are transferred individually, but their sequence numbers are modified to indicate that they are part of a larger set of log transfers. To specify the time frame, provide a value followed by one of the following labels:

minutes
hours
days

‑replicationAppliance

Collects information from all of the replication appliances that are configured to work with and are currently logged into the Oracle FS System.

‑sanhost

Specifies the IDs or the fully qualified names (FQNs) of one to 10 SAN hosts. Used with the ‑sanhostLogs option.

‑sanhostLogs

Collects logs from up to 10 SAN hosts that are running the Oracle FS Path Manager and are currently logged in to the Oracle FS System.

‑sendToCallHome

Sends the log bundle to the Call‑Home server immediately after collecting the logs.

‑statistics

Requests that the log of system statistics be included in the log bundle.

‑systemConfig

Collects the System Configuration Database and Storage Configuration (Persistence and COD) information.

‑uploadClientLogsFirst

Specifies that FSCLI log files on the client’s computer be first collected and sent to the Oracle FS System for inclusion in the specified set of collected logs using the ‑client option.

‑withinLastHours

Restricts the log information to collect from the logs to the specified number of hours before the present time.

EXAMPLE

Task

Oracle Customer Support has instructed you to collect all of the system logs that the Oracle FS System captured within the last two hours.

Parameters

Number of hours: 2

$ fscli system_log -collect ‑withinLastHours 2