Alike A3/V7 Documentation

Welcome to the Alike documentation

Troubleshooting

Log files

Logging is a critical tool to troubleshoot and resolve any issues with your A3 or Alike software. The A3 offers many different logs to review when looking for root causes.

Job Logs

Each job produces a job log that is displayed under Jobs->Job History. This is the first place to go when reviewing a job error. This will typically provide you with the cause of a failure and next steps for follow-up. But occasionally it may refer you to other logs or require additional clarification.

A3 logs

Under Tools->System Logs there is a dropdown in the upper right for three logs: System Log, A3 Log, and Engine Log.

The A3 Log audits job activity. Key Alike functions, such as job scheduling, job processing, storage connectivity, and email all log here. You may be asked by support to upload this log under certain circumstances.

The Engine Log tracks the A3's data management activities, including storing backup data, vaulting backup data, restoring backup data, and deleting backup data. Issues related to data storage and data access will likely be logged here and support may ask for this log to troubleshoot.

The System Log is a log written to by the Linux kernel and OS that can be useful for troubleshooting the A3's interactions with its virtual hardware and hypervisor, including disk and network. If you are looking for a hardware/driver issue, you will likely find it here.

All the above can be accessed from the A3 host console under /home/alike/logs.

However, your A3 host also contains its own system logs under /var/log. In some circumstances, troubleshooting issues on the A3 host itself may require examining these operating-system level logs instead.

Log levels

Alike provides several different logging levels to increase, or decrease the verbosity of your logs. By default, Alike uses "Info", which can be adjusted in the Settings->Logging options. alt text

Also found here is the "Trace logging" option. This will enable alot of detailed entries in your job logs. This is an excellent way to get more information while troubleshooting an issue, but it not recommended normally as it make joblogs very difficult to read.

The Alike UI offers easy access to recent log entries for the A3 operating system, the Data Engine (backend), as well as for any system scripting errors. These can all be found in the Alike UI under "Tools->System Logs"

The Agent logs (ABD and Q-Hybrid) are store in the A3's ADS share \\ads\logs\ folder. These logs are organized by VMID, which can be a bit tricky. To find your VMID, you can look in Alike System Explorer, under that VM's "Alike ID" setting.