Creating a dump file

If an error occurs during configuration restore and you are requested to obtain dump log files from customer support, if regular operation for obtaining dump files is not possible, perform the procedure below to obtain the dump files.

Note:

Verify that the following commands for the normal operations to create, confirm creating, and download a dump file cannot be used before performing this procedure.

Create a dump file.

CLI: dump_file_create_file
Confirm that a dump file is created.

CLI: dump_status_show
Download a dump file.

CLI: dump_file_download

Perform the following procedure for all storage nodes.

[On the controller node] Connect to the storage node over SSH.
```
$ ssh -i <passphrase-of-private-key> -o UserKnownHostsFile=/dev/null \
-o StrictHostKeyChecking=no \
hitachi_rescue_person@<IPaddress-of-storage-node>
```
Note:
The target private key files are the ones that you obtained in step 4 of Collecting information required for restore and that do not include ".pub" in their file names. When you created the key files as shown in the execution example of step 4, key files sample_ed25519 and sample_ed25519.pub exist, and sample_ed25519 serves as a private key file.

Run the command for creating a dump file.

$ sudo python3 /usr/local/lib/hsds/dump/hsds_maint_dump.py create '{"includeStorageControllerLog":true, "label":"restore_failed", "mode":"All"}'

Run the command for confirming that the dump file is created.
```
$ sudo python3 /usr/local/lib/hsds/dump/hsds_maint_dump.py show_status
```
If the result is "{" status ":" Created ", ...}", creating a dump file is complete. The dump file is created in /tmp/hsds_dump.

Note:
If "status: Creating" is shown, creating a dump file is in progress. Wait for about one minute, and then retry running the command for confirming that a dump file is created.

If "status: Failed" is shown, a dump cannot be collected. In that case, the error log will be output in /tmp/hsds_dump, and then collect the log.
Transfer the dump file to a location in which you can contact the customer support by using the scp command.