Downloading log files for troubleshooting

[EcoStruxureIT]

If you get a critical error message, search for the error message in the documentation and community. If you do not find instructions for solving this particular issue, you can ask a question in the forum.

The log files can be helpful when troubleshooting why the error occurred. Collecting the files may take a few minutes.

Troubleshooting

1. Take a screenshot of the application and error message.
2. If the error occurred in the DCO desktop client, write down the installation details (version, build, and serial number). You can access this information in the application Help > About StruxureWare Data Center Operation.
3. Write down (in steps) what you were doing before the message appeared.
4. Download the relevant log files as described below.
5. Post a question in the forum or send this information to technical support, including:
   
   1. Error description
   2. Description of what you were doing when the message appeared
   3. Pasting relevant lines from the log files (Caution: Do not share confidential information in the community!) 
6. If the community does not help you solve your issue, contact technical support. However, ensure you include the full log archive downloaded from Webmin for quicker, more efficient assistance.

Downloading server log files

You can collect server log files from the web client Download log Files Page (Administration > Download log Files).

Downloading desktop client log files

You can collect client log files from

• The desktop client menu Help > Download client log files
• The Data Center Operation installation folder, default location:
  • Windows: C:\Users\[Username]\.isxo\[Version]\Operations\application.log
  • OS X and Linux: ~/.isxo/[Version]/Operations/application.log

Downloading Disaster Recovery log files

Note that if your setup includes a Disaster Recovery node, you must download the log files separately through the Webmin interface on that server.

Downloading ITO log files

ITO log files are included with the DCO server log files. Alternatively, you can download them separately from the ITO:

1. In a browser, go to https://<ito-server-ip>:8090/.
2. Logon as the server user.
   Don't remember the credentials?
3. Select System settings.
4. In the pop-up dialog box, Support tab, click Download...
5. Save the support.zip file containing the console log files.

How to download log files when the HTTPD Apache web server is down 

If the Apache (HTTPD) service is unavailable, it is not possible to obtain log files via Webmin. Log files can be obtained via a console or SSL session:

1. Log into the Operation server via console or SSH.
2. Type the command cd /
3. Type the command sudo su 
4. Enter the password. This password is the same one used to access console/SSL.
5. Type the command Platform.pm collect-log-files / tmp
   This will create a log.tar.gz file located in the / tmp directory.
6. Once the process is completed, FTP/SFTP the log file from the server to your computer.