APC AP8861, AP8886, AP88XX manual How to use FTP or SCP to retrieve log files

Page 62

How to use FTP or SCP to retrieve log files

An Administrator or Device User can use FTP or SCP to retrieve a tab-delineated event log file (event.txt) or data log file (data.txt) and import it into a spreadsheet.

The file reports all events or data recorded since the log was last deleted or (for the data log) truncated because it reached maximum size.

The file includes information that the event log or data log does not display.

The version of the file format (first field)

The date and time the file was retrieved

The Name, Contact, and Location values and IP address of the Rack PDU

The unique Event Code for each recorded event (event.txt file only)

Note: The Rack PDU uses a four-digit year for log entries. You may need to select a four-digit date format in your spreadsheet application to display all four digits.

If you are using the encryption-based security protocols for your system, use SCP to retrieve the log file.

If you are using unencrypted authentication methods for the security of your system, use FTP to retrieve the log file.

See the Security Handbook, available at www.apc.com, for information on available protocols and methods for setting up the type of security you need.

To use SCP to retrieve the files. To use SCP to retrieve the event.txt file:

scp username@hostname_or_ip_address:event.txt ./event.txt

To use SCP to retrieve the data.txt file, use the following command:

scp username@hostname_or_ip_address:data.txt ./data.txt

To use FTP to retrieve the files. To use FTP to retrieve the event.txt or data.txt file:

1. At a command prompt, type ftp and the IP address of the Rack PDU, and press ENTER.

If the Port setting for the FTP Server option (set through the Network menu of the Administration tab) has been changed from its default (21), you must use the non-default value in the FTP command. For Windows FTP clients, use the following command, including spaces. (For some FTP clients, you must use a colon instead of a space between the IP address and the port number.)

ftp>open ip_address port_number

To set a non-default port value to enhance security for the FTP Server, see “FTP Server” on page 68. You can specify any port from 5001 to 32768.

2.Use the case-sensitive User Name and Password for Administrator or Device User to log on. For Administrator, apc is the default for User Name and Password. For the Device User, the defaults are device for User Name and apc for Password.

3.Use the get command to transmit the text of a log to your local drive.

ftp>get event.txt

or

ftp>get data.txt

4. Type quit at the ftp> prompt to exit from FTP.

Metered Rack PDU User Guide

54

Image 62
Contents User Guide Contents Log on to the Command Line Interface Web Interface Logs Administration Notification Device IP Configuration Wizard Troubleshooting Product Features IntroductionAccess Priorities for Logging on Types of User AccountsWatchdog Features Network Port SharingGetting Started Dhcp and Bootp configuration Establish Network SettingsTCP/IP configuration methods INI file utilityOption 43 = 01 04 31 41 50 Command Line Interface Recovering from a Lost Password Rack PDU Front Panel FunctionFunction Display Tree Example Display Tree Example Condition Description Load indicator LEDNetwork Status LED 10/100 LEDLog on to the Command Line Interface Command Line InterfaceAbout the Command Line Interface Remote access to the command line interfaceLocal access to the command line interface About the Main ScreenUsing the Command Line Interface IPv4 IPv6 Description OnlyCommand Syntax DescriptionCommand Response Codes Code MessageAbout Network Management Card Command DescriptionsAlarmcount Option Arguments DescriptionClrrst BootOption Argument Description Console Argument Description DateDelete DirExit DnsEventlog FormatNetstat Option Argument DefinitionHelp NtpPrompt PingPortSpeed QuitReboot RadiusSystem ResetToDefSnmp, snmpv3 Tcpip Tcpip6User WebXferINI XferStatusBkLowLoad Device Command DescriptionsNetwork Port Sharing Commands BkNearOverDevLowLoad BkOverLoadBkReading DevReading DevNearOverDevOverLoad Argument DefinitionHumReading HumLowHumMin PhOverLoad PhLowLoadPhNearOver PhReading ProdInfo SensorNameTempReading TempHighTempMax Whoami Logging On to the Web Interface Web InterfaceSupported Web Browsers Error Message Browser Cause of the Error URL address formatsTabs Web Interface FeaturesSymbol Description Device status iconsOther Web interface features Quick LinksGroup Control using Network Port Sharing Network Port Sharing on the Web InterfaceMetered Rack PDU User Guide Overview view Alarm Status viewAbout the Home Tab About the Device Manager Tab Configuring Load ThresholdsDevice Management Viewing the Load Status and Peak LoadConfigure the Name and Location of the Rack PDU Resetting Peak Load and kWhConfigure Temperature and Humidity Sensors EnvironmentEvent log LogsUse the Event and Data Logs Example event log Rack PDU 4 Device low load Data log Path Logs Data optionsParameter Description How to use FTP or SCP to retrieve log files Scp username@hostnameoripaddressdata.txt ./data.txtAuthentication Administration SecuritySetting user access Local UsersRadius Setting Definition RadiusConfiguring a Radius server on Unix with shadow passwords Configure the Radius ServerSummary of the configuration procedure Supported Radius serversInactivity Timeout TCP/IP settings Administration Network FeaturesTCP/IP and Communication Settings Setting DescriptionDhcp response options APC Cookie. Tag 1, Len 4, Data 1APCPort Speed Ping ResponseDNS Query Type Selected Query Question to UseStatus WebOption Description Console Telnet 152.214.12.1145000 telnet 152.214.12.114Snmp SNMPv1 SNMPv3 FTP Server Event Actions Administration NotificationConfiguring event actions Types of notificationMetered Rack PDU User Guide Active, Automatic, Direct Notification Mail notificationSend a test message to a configured recipient Snmp traps Snmp Trap TestSyslog Remote Monitoring ServiceSetting Definition Informational is mapped to Info Set the Date and Time Administration General OptionsIdentification ModeUse an .ini File Daylight savingChange the default temperature scale Event Log and Temperature UnitsReset the Rack PDU Color-code event log textConfigure Links About the Rack PDUUse the Wizard Device IP Configuration WizardCapabilities, Requirements, and Installation Select Locally through the serial port, and click Next Configure or reconfigure the TCP/IP settings locallySelect Remotely over the network, and click Next Contents of the .ini file How to Export Configuration SettingsSummary of the procedure Retrieving and Exporting the .ini FileDetailed procedures Ftp open ipaddress Messages in config.ini Upload Event and Error MessagesEvent and its error messages Errors generated by overridden valuesFirmware File Transfer Methods How to Upgrade FirmwareFile Transfers Benefits of upgrading firmwareUsing the Firmware Upgrade Utility Use FTP or SCP to upgrade one Rack PDUUse Xmodem to upgrade one Rack PDU Using a USB flash drive to upgrade one Rack PDU How to upgrade multiple Rack PDUsUsing the Firmware Upgrade Utility for multiple upgrades Firmware Module Binary File Verify the success or failure of the transfer Verifying Upgrades and UpdatesVerify the version numbers of installed firmware Last Transfer Result codesProblem Solution TroubleshootingRack PDU Access Problems Appendix a List of Supported Commands Network Management Card Command DescriptionsSets manual IPv6 address Device Command Descriptions APC Worldwide Customer Support 990-3429D-001 10/2012