Users Guide

Field service debug workflow
In OpenManage Enterprise–Tech Release, you can authorize console debugging by using the Field Service Debug (FSD) option.
By using FSD, you can perform the following tasks:
• Allow enabling and copying of debug logs
• Allow copying of real-time logs
• Allow backing up or restoring of database to VM.
The topics referenced in each task provide detailed instructions. To enable FSD, perform the following tasks:
1. Unblock FSD capability. See Unblocking the FSD capability.
2. Install or grant signed FSD DAT.ini file. See Installing or granting a signed FSD DAT.ini file.
3. Invoke FSD. See Invoking FSD.
4. Disable FSD. See Disabling FSD.
Unblocking the FSD capability
You can unblock the FSD capability through the TUI screen.
1. Navigate to the TUI main menu.
2. On the TUI screen, to use the FSD option, select Enable Field Service Debug (FSD) Mode.
3. To generate a new FSD unblock request, on the FSD Functions screen, select Unblock FSD Capabilities
4. To determine the duration of the debug capabilities being requested, select a start and end date.
5. On the Choose Requested Debug Capabilities screen, select a debug capability from a list of debug capabilities unique to the console.
In the lower-right corner, select Generate.
NOTE: The debug capability that is current supported is, RootShell.
6. On the Download DAT file screen, view the signing instructions and the URL address of the share where the DAT.ini file exists.
7. Use an external client to extract the DAT.ini file from the URL address of the share mentioned in step 6.
NOTE: The download share directory has read-only privileges and supports only one DAT.ini file at a time.
8. Perform either of the following tasks depending on whether you are an external user or an internal Dell EMC user:
• Send the DAT.ini file to a Dell EMC contact for signing if you are an external user.
• Upload the DAT.ini file to appropriate Dell Field Service Debug Authentication Facility (FSDAF) and submit.
9. Wait for a Dell EMC signed and approved DAT.ini file to be returned.
Installing or granting a signed FSD DAT.ini file
Ensure that you have received the DAT.ini file, which is signed and approved by Dell EMC.
NOTE:
After Dell EMC approves the DAT.ini file, you must upload the file to the console appliance that generated the
original unblock command.
1. To upload a signed DAT.ini file, on the FSD Functions screen, select Install/Grant Signed FSD DAT File.
NOTE:
The upload share directory has write-only privileges and supports only one DAT.ini file at a time. The DAT.ini
file size limit is 4 KB.
2. On the Upload signed DAT file screen, follow the instructions about uploading the DAT.ini file to a given file share URL.
3. Use an external client to upload the DAT.ini file to a share location.
4. On the Upload signed DAT file screen, select I have uploaded the FSD DAT file.
If there are no errors during DAT.ini file upload, a message confirming the successful installation of the certificate is displayed. To continue,
click OK.
The DAT.ini file upload can fail because of any of the following reasons:
• The upload share directory has insufficient disk space.
• The uploaded DAT.ini file does not correspond to the previous debug capability request.
• The signature provided by Dell EMC for the DAT.ini file is not valid.
102
Other references and field descriptions