This article describes how to enable debug logging when issues with backup/restore/deploy cannot be resolved through normal troubleshooting procedures.
If you are getting errors with backups/restore/deploy here are some troubleshooting steps to assist.
External Fileserver Required for Production
Most issues reported with backup/restore/deploy are because the default windows internal fileserver is being used in production. This internal file server is designed for QA and Testing. It is highly recommended that customer to setup and use and external file server. (filezilla is one example)
NOTE: the Linux OVA Appliance comes with a built in file server native to the Linux OS. This is considered to be an external file server and may be used for production deployments
- For Windows, You must set up and external file server if you don't already have one setup.
- Once set up, retry the operation to see if using the external servers has resolved the issue. You can associate your file server to the application by going to Configuration management -> File Servers portlet.
- Go to step 2 if still having issues.
- Verify the image from deployment is staged on the the FTP/SFTP.
- Open the shared drive on your fileserver to see if the files are showing up while you try the backup, restore or deploy operation again.
The back up restore or deploy process simply send a command the the target device instructing it what to do. For a backup example, the device receives a command like copy-run-ftp with the file server IP address embedded. the device copies the file to the server and Cruz then pull it off the file server and save to the db.
Problems can be investigated at these points:
- Can Cruz logon the device to issue the commands (if no, check firewalls between the target and Cruz, check credentials associated to the device)
- Was the file copied to the file server? (if no, check firewalls between the target and file server. Try manually logging into the device and issue the copy command.)
- Was Cruz able to retrieve the file from the file server (if no, check firewalls between the file server and Cruz
- If the issue cannot be resolved continue:
Enable Debugging and Provide output to Support
Troubleshooting device deploy/backup/restore
-
Stop App/Med Server
-
cd $OWARE_USER_ROOT/owareapps/installprops/lib/installed.properties
-
vi installed.properties and add the following to the end of the file.
- Turn on the following debug categories
installed.properties File
ENABLE Debug
com.dorado.mediation.cli=true
com.dorado.redcell.filexferapi=true
com.dorado.redcell.netrestore.deploy=true
DIABLE Debug com.dorado.mediation.cli=false
com.dorado.redcell.filexferapi=false
com.dorado.redcell.netrestore.deploy=false
-
Restart App/Med Server
Recreate the Issue -Deploy/Backup/Restore
Now that the debug is enable and the server is backup and running
- Re-Deploy on the device to generated the error and acputre the debug in the server.log filel
- Reverse the Enable Debug process by replacing =true to =False > Restart App/Med Server
- Send the server.log file to support for analysis (generated a new ticket i you already don'g have one: tsc@doradosoftware.com)
Server.log Location
cmd> cd $OWARE_ROOT/jboss-5.1/server/oware/log
Windows Default Path:
C:\Program Files\Dell EMC\OpenManage\Network Manager\oware\jboss-5.1\server\oware\log
Linux Default Path:
/opt/VAroot/dellemc/openmanage/networkmanager/oware/jboss-5.1/server/oware/log