To send collected VIOS debug data to a remote server:
lpardbg -o s -f file -r {ftp | sftp}
-h host-name -u user-ID
[--passwd password] [-k SSH-private-key]
[-d directory] [-c IBM-case-number] [--help]
To remove collected VIOS debug data from the HMC hard disk:
lpardbg -o r -f file [--help]
| -o |
The operation to perform. Valid values are c to collect debug data and send it to a remote server or save it on the HMC hard disk, s to send debug data that was already collected to a remote server, and r to remove collected debug data files from the HMC hard disk.
Debug data files that are successfully sent to a remote server are automatically removed from the HMC hard disk. |
| -t | The type of partitions from which to collect debug data. The only valid value is vios to collect debug data from Virtual I/O Servers. |
| -m | The name of the managed system which has the VIOSs from which to collect debug data. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name. |
| -p |
The name of one or more VIOSs from which to collect debug data. Multiple VIOS names must be comma separated.
You can either use this option to specify the names of the VIOSs from which to collect debug data, the --id option to specify the IDs of the VIOSs from which to collect debug data, or the --all option to collect debug data from all VIOSs on the managed-system. The -p, --id, and --all options are mutually exclusive. |
| --id |
The ID of one or more VIOSs from which to collect debug data. Multiple VIOS IDs must be comma separated.
You can either use this option to specify the IDs of the VIOSs from which to collect debug data, the -p option to specify the names of the VIOSs from which to collect debug data, or the --all option to collect debug data from all VIOSs on the managed-system. The --id, -p, and --all options are mutually exclusive. |
| --all |
Specify this option to collect debug data from all VIOSs on the managed-system.
You can either use this option, the -p option to specify the names of the VIOSs from which to collect debug data, or the --id option to specify the IDs of the VIOSs from which to collect debug data. The --all, -p, and --id options are mutually exclusive. |
| -r |
The remote location where the debug data will be sent. Valid values are ftp for a FTP server and sftp for a secure FTP (SFTP) server.
If this option is omitted when -o c is specified, the collected debug data will only be saved on the HMC hard disk. |
| -h | The host name or IP address of the remote server. |
| -u | The user ID to use to log in to the remote server. |
| --passwd |
The password to use to log in to the remote server.
If this option is omitted when sending debug data to a remote FTP server, you will be prompted to enter the password. If both this option and the -k option are omitted when sending debug data to a remote SFTP server, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. |
| -k |
The name of the file that contains the SSH private key. If the file name is not fully qualified, the file must exist in the user’s home directory on the HMC.
Use the ssh-keygen command to generate the public and private SSH key pair. The ssh-keygen command is not allowed to write to the .ssh directory in the user’s home directory on the HMC, so when you run the command on the HMC, you must specify both the directory and the file name for the private key. If you generate a key with a passphrase, you will be prompted to enter the passphrase when you run any HMC command that uses the key. If both this option and the --passwd option are omitted when sending debug data to a remote SFTP server, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. This option is only valid when sending debug data to a remote SFTP server. |
| -d | The name of the directory on the remote server where the debug data files will be written. If this option is not specified, the files will be written to the user’s home directory. |
| -f | The name of one or more debug data files to send or remove. Multiple file names must be comma separated. |
| -c |
The IBM case number to include with the debug data files when sending the debug data to IBM support.
This option is only valid when sending debug data to a remote SFTP server. |
| --help | Display the help text for this command and exit. |
lpardbg -o c -t vios -m sys1 -p vios1,vios2 -r sftp -h sftpserver
-u sftpuser --passwd password -c TS123456789
Collect and send debug data from all VIOSs on the managed system to a remote SFTP server using SSH keys for authentication:
lpardbg -o c -t vios -m 9119-MME*1234567 --all -r sftp -h sftpserver
-u sftpuser -k /home/hmcuser/keys/id_rsa
Send debug data files to a remote FTP server (you will be prompted to enter the password):
lpardbg -o s -f 1_9119-MME*1234567_2022-04-28T16:26:58.297Z -r ftp
-h ftpserver -u ftpuser
Remove debug data files from the HMC hard disk:
lpardbg -o r -f 1_9119-MME*1234567_2022-04-28T16:26:58.297Z,
2_9119-MME*1234567_2022-04-28T16:26:58.297Z
| None | |
| None | |
| Linux | LPARDBG (1) | May 2022 |