Page History

...

• As a first step check the Agent's log file agent.log and watchdog.log, see JS7 - Log Files and Locations.
  • Warnings and errors can be found from the output qualifiers WARN and ERROR in a log file.
  • Example
    • 2021-10-10T09:53:04,939 WARN js7.base.session.SessionApi - HttpAgentApi(https://apmacwin:4345): HTTP 401 Unauthorized: POST https://apmacwin:4344/controller/api/session => InvalidLogin: Login: unknown user or invalid password
• Due to log rotation log files of previous days are kept in a compressed .tar.gz format on a daily basis, see JS7 - Log Rotation
  • For Unix use the zcat command to directly access compressed log files.
  • For Windows extract the compressed files, for example by using 7-zip.
• Consider that an Agent instance can report problems related to other components such as Controller instances and JOC Cockpit. In this situation check the component's log files.
• If you find a warning or error message that is not clear to you then try to do some research: the Product Knowledge Base and the Change Management System offer a search box, browsers offer access to search engines.
• When you completed analysis of a problem and you are certain that the problem is related to a product defect and not to resources of your IT environment then
  • customers of a commercial license can use the Support Resources including the SOS ticket system.
  • users of the open source license can use Community Resources.
• Should the agent.log file not provide sufficient information for a reproducible problem then consider to increase the debug level, see JS7 - Log Levels and Debug Options.

...

If the problem is related to server resources and if operation of the Agent cannot be continued on the same server then relocation of the Agent instance can be a last means to fight an outage. Relocation includes to copy/move the Agent instance's JS7_AGENT_DATA/state directory to an Agent instance on a new server. This directory holds the Agent instance's journal. To relocate an Agent instance copy the journal files to the new Agent instance. Refer to the JS7 - Relocating How to relocate an Agent article for the steps to apply.

...