HMC Manual Reference Pages - CPDUMP (1)

NAME

cpdump - copy dumps

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

cpdump -r {ftp | sftp | usb | remoterepo}
-f "file1 file2 ...fileN"
[-h host-name] [-u user-ID] [--passwd password] [-k SSH-private-key]
[-d directory] [--help]

DESCRIPTION

cpdump copies managed system dumps and managed frame dumps from the Hardware Management Console (HMC) to a remote site or a USB data storage device.
Use the lsdump command to list the managed system dumps and managed frame dumps that reside on the HMC.

OPTIONS

-r The storage location to where the dumps will be copied. Valid values are ftp for a remote FTP site, sftp for a remote secure FTP (SFTP) site, usb for a USB data storage device, and remoterepo for the remote call home repository.
When copying dumps to a USB data storage device, the device must be inserted into a USB port on the HMC and the device must be mounted with the mount command before running this command. The lsmediadev command can be used to display the mount points for the removable media devices on the HMC.

-f The file name of the dump to be copied. If multiple dumps are to be copied, the file names must be separated by blanks and enclosed in double quotes.

-h The host name or IP address of the remote FTP or SFTP site.
This option is required when copying dumps to a remote FTP or SFTP site. Otherwise, this option is not valid.

-u The user ID to use to log in to the remote FTP or SFTP site.
This option is required when copying dumps to a remote FTP or SFTP site. Otherwise, this option is not valid.

--passwd The password to use to log in to the remote FTP or SFTP site.
If this option is omitted and the dumps are being copied to a remote FTP site, you will be prompted to enter the password. If both this option and the -k option are omitted and the dumps are being copied to a remote SFTP site, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive.
This option is only valid when copying dumps to a remote FTP or SFTP site.

-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 and the dumps are being copied to a remote SFTP site, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive.
This option is only valid when copying dumps to a remote SFTP site.

-d When copying dumps to a remote FTP or SFTP site, specify the directory on the FTP or SFTP server to where the dumps will be copied. If this option is omitted, the dumps will be copied to the home directory of the user.
When copying dumps to a USB data storage device, specify the directory on the USB device to where the dumps will be copied.
This option is only valid when copying dumps to a remote FTP or SFTP site or a USB data storage device.

--help Display the help text for this command and exit.

EXAMPLES

Copy a dump file to a remote FTP site:
cpdump -r ftp -f "FSPDUMP.100072A.01000019.20040629205455"
-h ftpserver -u ftpuser --passwd ftppassword -d /tmp/dumpfiles/
Copy a dump file to a remote SFTP site and use SSH keys for authentication:
cpdump -r sftp -f "SYSDUMP.10860AC.3A000003.20190619143200"
-h 9.3.123.25 -u sftpuser -k /home/hmcuser/keys/id_rsa
-d /home/sftpuser/images
Copy dump files to a USB flash drive:
lsmediadev (to obtain mount points)
mount /media/sdb1
cpdump -r usb -f "FSPDUMP.100072A.01000019.20040629205455
SYSDUMP.100072A.01000019.20040630183112" -d /media/sdb1
Call home a dump:
cpdump -r remoterepo -f "FSPDUMP.13295AX.6A000002.20190528200553"

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

HMC Manual Reference Pages - CPDUMP (1)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

ENVIRONMENT

BUGS

AUTHOR

SEE ALSO

-r	The storage location to where the dumps will be copied. Valid values are ftp for a remote FTP site, sftp for a remote secure FTP (SFTP) site, usb for a USB data storage device, and remoterepo for the remote call home repository. When copying dumps to a USB data storage device, the device must be inserted into a USB port on the HMC and the device must be mounted with the mount command before running this command. The lsmediadev command can be used to display the mount points for the removable media devices on the HMC.
-f	The file name of the dump to be copied. If multiple dumps are to be copied, the file names must be separated by blanks and enclosed in double quotes.
-h	The host name or IP address of the remote FTP or SFTP site. This option is required when copying dumps to a remote FTP or SFTP site. Otherwise, this option is not valid.
-u	The user ID to use to log in to the remote FTP or SFTP site. This option is required when copying dumps to a remote FTP or SFTP site. Otherwise, this option is not valid.
--passwd	The password to use to log in to the remote FTP or SFTP site. If this option is omitted and the dumps are being copied to a remote FTP site, you will be prompted to enter the password. If both this option and the -k option are omitted and the dumps are being copied to a remote SFTP site, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. This option is only valid when copying dumps to a remote FTP or SFTP site.
-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 and the dumps are being copied to a remote SFTP site, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. This option is only valid when copying dumps to a remote SFTP site.
-d	When copying dumps to a remote FTP or SFTP site, specify the directory on the FTP or SFTP server to where the dumps will be copied. If this option is omitted, the dumps will be copied to the home directory of the user. When copying dumps to a USB data storage device, specify the directory on the USB device to where the dumps will be copied. This option is only valid when copying dumps to a remote FTP or SFTP site or a USB data storage device.
--help	Display the help text for this command and exit.