We are always there to provide help and assistance to our customers that are experiencing issues using the product. In order to help us identify, analyse the root cause and resolve the issue as quickly as possible there is key information we need to collect from you. Attached is a document which lists the information we would like to get. It would be very much appreciated if you could provide this information when you open a new case.
Recommendation: There are various logs been generated by our product each having rolling up index and file size. Beside all logs there are some important logs for which we recommed our customer to retain the large number of those file to protect overwriting of content
Note: - The value against each can be dependent on the disk space in an environment. Services restart is not required post these changes.
- Number for MaxBackupIndex value should be set to a large number in case of large environments, especially for Management and Execution servers. In preferred scenario a trade-off can be done between file-size and MaxBackupIndex.
For example in large environments with around 100+ agents connecting to a single NES the MaxBackupIndex can be set to value of 200 or higher default file size of 5MB or it can be set to 100 with file size 10 MB.
- We recommend to derive and evaluate most feasible numbers for file size and MaxBackupIndex to provide logs coverage of 24 hours duration.
Component | File Location | Important Log Files | Modification to increase log file number |
---|
Management Server | \webapps\datamanagement\WEB-INF\log4j.properties | <Install Directory>/logs/nolio_dm_all.log | log4j.appender.RegularDM.MaxBackupIndex=30 |
Execution Server | \webapps\execution\WEB-INF\log4j.properties | - <Install Directory>/logs/nimi.log
- <Install Directory>/logs/Nolio_exec_all.log
- <Install Directory>logs/execution.log
| - log4j.appender.RegularExecution.MaxBackupIndex=20
- log4j.appender.ExecutionFileAppender.MaxBackupIndex=20
- log4j.appender.NimiFileAppender.MaxBackupIndex=30
|
Agent | \conf\log4j.properties | - <Install Directory>/logs/nimi.log
- <Install Directory>/logs/nolio_all.log
- <Install Directory>/logs/nolio_action_exe.log
| - log4j.appender.Regular.MaxBackupIndex=15
- log4j.appender.NimiFileAppender.MaxBackupIndex=30
- log4j.appender.ActionsAppender.MaxBackupIndex=15
|
Retrieval/Repository Agents ** | \conf\log4j.properties | - <Install Directory>/logs/nimi.log
- <Install Directory>/logs/nolio_all.log
- <Install Directory>/logs/nolio_action_exe.log
| - log4j.appender.Regular.MaxBackupIndex=20
- log4j.appender.NimiFileAppender.MaxBackupIndex=20
- log4j.appender.ActionsAppender.MaxBackupIndex=30
|
** Retrieval or Repository agents: In product terminology retrieval or repository agents are referring to agents which are responsible for fulfilling request to downlaod and distribute artifacts to the requesting agents.
Which log files we need for detail investigation of cases are mentioned below
Note: - All the below information need to be collected when issue is seen most preferably prior to restart of NAC or any other services.
- Collection and sharing of specific log file is quick and can help in many cases to trouble shoot issue, but in some cases we may need whole set of logs to root cause an issue. So as a best practice we recommend to collect all logs from specific component before it get overwritten.
- We always recommend to collect logs via out of box product feature to collect logs. For quick recall collecting logs via ASAP: Go to Administration tab-> Agent management console ->rigth click on specific agent -> Collect logs. (feature of log collection is available to my best from
4.1 version onward). Refer to KB on how to do it!
- In some cases where customer maintain large number of log retention we request them to manually collect the logs, as this utility will zip all logs folder irrespective of time-frame. In such scenario it can cause an overhead in collecting logs in GB's.
·
Component | Good to have |
---|
Management Server | All logs |
Execution Server(If mulitiple Execution servers we need logs from all impacted) | All logs |
Agent (If multiple Agents we need logs from all impacted agents) | All logs |
UI | All logs |
Additional Information : JMX
Beside logs sometimes we need additional infomration from JMX console of product. Please find details of where you can collect those information.
See Also
Nolio Official KB: What log files are created and where can I find them?
Nolio Official KB: Where are the log files stored? What do they do?
Footnotes
- Release Automation formerly known as Nolio
- Management Server formerly known as Nolio Automation Center (NAC)
- Execution Server formerly known as Nolio Execution Server (NES)
- Agent/s formerly known as Nolio Agent (NAG)