Troubleshooting archiving startup issues
When you observe issues related to startup of the Archiving Operation, follow the appropriate logging and troubleshooting steps to either resolve the problem or create a BMC Support case.
Symptoms
- Increase in size and record count of the Primary regular form.
- Large number of records present on the Primary regular form.
- No increase in the record count of the Archive form over a long period of time.
- Increase in response time from a database query.
- Decrease in the system performance.
Scope
Your system has a large amount of records that have not been archived, but should have been.
Resolution
These symptoms are caused by the following major root causes:
- The server group mechanism is facing issues and the Archiving Operation never starts.
- The archiving policy is being skipped while other policies are working as needed.
The following table describes several tasks that can be reviewed to ensure that the Archiving Operation is working correctly:
Step | Task | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
1 | Review the Archiving setting in the Server Group. | Cause: Archiving is disabled if the default setting in Centralized Configuration (CCS) is changed to T (True). Resolution: Check whether the archiving is enabled by ensuring that the following setting in CCS is set to F (False): com.bmc.arsys.server.shared > Disable-Archive-Global To allow Archiving Operation to continue, change the "Disable-Archive-Global" setting to F. Refer the following table for information on the settings in CCS:
To learn more about CCS settings, see the topic Centralized Configuration in the AR System documentation. | |||||||||
2 | Review the Run Every Interval setting for archiving. | Cause: The Run Every Interval setting has been modified from a default value of 24 hours to an unusually large value, which causes Archiving to run so far in the future that it seems like it isn’t working. Resolution: From the AR System Archive Manager Console, change the Run Every Interval setting to a value within the range of 12 to 24 hours. The default value is 24 hours. | |||||||||
3 | Review the Archive Policies. | Cause: If the Archive policy is disabled, the archiving process for a group of records does not start. The Archive policy might get disabled after a data backup/restore, a recent change, or a brief alteration during a routine maintenance operation. Resolution:
| |||||||||
4 | Review the qualification of the Archive policy. | Cause: Each policy has a qualification. The policy evaluates each record based on the qualification in the parent form. For example, the Incident Management Archive Policy is defined through the HPD:Help Desk form, which has a qualification that has the operators as Status and Do Not Archive, in addition to the Create Date field, which is the default for all Archive Policies. All three fields have to meet the defined criteria. The policy must not have qualifications that are too restrictive such as ................ Resolution:
| |||||||||
5 | Review the associations of the Archive policy. | Cause: If the group of records in question are children records, and the parent records are being processed, you should check whether the association objects are configured correctly. Resolution:
| |||||||||
6 | Review the server rankings. | Cause: To configure the Remedy ITSM, in the AR System Server Group Operation Ranking form, the AR Administrator ranks the servers from 1 to n to determine the sequence of operations on the servers. Archiving will not work if no server is ranked for archiving. To check whether any servers are ranked for archiving, navigate to the AR System Server Group Operation Ranking form, and run the query Operation = Archive. If the search results do not produce any records, or if the records that appear in the search results do not have a rank configured, the server is not ranked for archiving. You can also check the server rankings via the Current Operation Owner application in the Remedy Management Console. Resolution:
| |||||||||
7 | Check that the Server Group Coordinator is working. | Cause: In certain busy environments, the server that is acting as the Server Group Coordinator might start having issues causing the server group operations to not process correctly. This issue might manifest with other symptoms from other server group operations, like Escalations or Approvals, and can cause the Server Group Coordinator server to become non-responsive. Resolution: Restart the AR System server that is acting as the Server Group Coordinator. For more information about troubleshooting and a hotfix for this issue, see the knowledge article KA000219708 in BMC Communities. | |||||||||
8 | Check that the server ranked for Archiving is running. | Cause: The server ranked for Archiving Operations is not running. If a server ranked greater than 1 is performing the Archiving Operation, the server ranked 1 might have an issue. Confirm that an issue exists by performing either of the following actions:
Resolution: This error is usually caused when the server ranked 1 is facing any issues. Check and troubleshoot the server ranked 1 for all the issues by analyzing the armonitor.log file. Also enable the Server Group log for each system, and analyze the logs. |