Producing Diagnostic Log Files

Wikis > Producing Diagnostic Log Files

Producing an ArcaOS install log (successful install)

An install log is not the same as a TestLog log file. If you need to produce a TestLog Log file, see the Producing a TestLog log file section.

This section applies if you need an install log and the install completed successfully. If the install aborted and did not complete, please see the next section “Producing an ArcaOS install log (failed install)”.

Go to \sys\install on your boot disk and look for a file named inst_*.zip where ‘*’ is a numeric date string (like ‘20170515’). For example

inst_20170515.zip

Attach the file you found to your ticket.

Producing an ArcaOS install log (failed install)

An install log is not the same as a TestLog log file. If you need to produce a TestLog Log file, see the Producing a TestLog log file section.

This section applies if you need an install log and the install did not complete. If the install completed successfully, please see the previous section “Producing an ArcaOS install log (successful install)”.

Go to \sys\install on your boot disk and look for a file named

inst_abend.zip

and attach that file to your ticket.

Producing an ArcaOS install log (hung install)

An install log is not the same as a TestLog log file. If you need to produce a TestLog Log file, see the Producing a TestLog log file section.

This section applies if you need an install log and the install hung part way through and never finished and never failed. If the install completed successfully, or failed, please see one the previous “Producing an ArcaOS install log” sections.

Note: The script for this feature only exists in ArcaOS 5.0.2 or later. If you have ArcaOS 5.0.1 or earlier you can the script here.

  1. Reboot your system back into the installer using your install media.
  2. Click on System Management.
  3. If you had to do a hard reset, or power off to regain control of your system, you might need to run chkdsk on the target volume. If so, do that now.
  4. Click on Command Prompts and open a Command Line (CMD)
  5. Type
    MkSupZip
  6. Answer any questions the script asks.
  7. The script will zip up all the required files and announce the file name that was created. Attach the created file to your ticket.

Producing a TestLog log file

A TestLog log file is not the same as an install log. If you need an install log, see the previous sections.

Always make sure you have the latest TestLog program. Get the latest version from here. Open an OS/2 command window and type the requested testlog command. If no specific testlog command was specified use “testlog generic” as shown in the example below:

testlog generic

The TestLog program will prompt for a description of the problem. Type a brief comment describing your particular problem and press enter. This comment is included inside the log to help the developer when viewing the log file. A log file will be generated and the name of the log file will be displayed. Attach that log file to your ticket. Do not rename or zip the log file.

Producing a TestLog log file when booted from the ArcaOS DVD

  1. Boot your ArcaOS DVD using the specific options specified by the developer. If nothing was specified use all the defaults. Wait until the installer GUI is displayed.
  2. Click “System Management”
  3. Click “Command Prompts->Command Line (CMD)”.
  4. Type this command:
    testlog generic
  5. The TestLog program will prompt for a description of the problem. Type a brief comment describing your particular problem and press enter. This comment is included inside the log file to help the developer when viewing the log file.
  6. A log file will be generated and the name of the log file will be displayed. Attach that log file to your ticket. Do not zip the log file.

There are two options for getting this log file attached to your ticket.

  1. Copy the log file to a USB stick and use a different system to attach it to your ticket.
  2. Use the web browser on the DVD to attach the log file to your ticket. Simply click “Tools->Web Browser” and go to mantis.arcanoae.com, log in and access your ticket. This will only work if the system is working well enough that the network is working.