Welcome

Welcome to CA User Activity Reporting Module. This document contains information about operating system support, enhancements, known issues, and information about contacting CA Technical Support.

Upgrading to CA User Activity Reporting Module Version 12.5 through Subscription

To upgrade CA User Activity Reporting Module to version r12.5, first upgrade to version r12.5 of the Log Manager product, then update all other CA User Activity Reporting Module modules, such as Content, Integration and Agent modules. You perform all upgrade tasks through Subscription.

Important! Upgrade the management CA User Activity Reporting Module server before you install any new CA User Activity Reporting Module servers in your network. Doing so allows the new servers to register properly.

To upgrade to CA User Activity Reporting Module version r12.5

Upgrade to Log Manager version r12.5.
1. Click the Administration tab, Services subtab, expand Subscription Module, and select your CA User Activity Reporting Module management server. By default, this server is the first you installed in your CA User Activity Reporting Module environment.
2. Click the global/local button to switch to local service configuration.
3. In the RSS feed URL field, type:
  http://securityupdates.ca.com/CA-ELM/r12.5/RSSFeed_PreUpgrade.xml
4. In the Modules to Download list, use the arrows to move the Log Manager module from Available to Selected.
5. Verify that all other required values are configured for the selected server.
6. Click Update Now.
  When the update is complete, a self-monitoring event appears, indicating that the Log Manager update has been installed. iGateway automatically restarts and your CA User Activity Reporting Module Log Manager session closes. The iGateway restart takes approximately 5 minutes.
7. Log in to CA User Activity Reporting Module. In the upper right corner of the Log Manager browser window, click About and confirm that the version number indicates the new version of CA User Activity Reporting Module.
  Note: The upgraded CA User Activity Reporting Module r12.5 user interface lists both Subscription Module and Subscription Service under the Administration tab, Services subtab. Subscription Module reflects the interface and functionality previous to the r12.5 update, and is present to help ensure proper communication between all CA User Activity Reporting Module servers during the upgrade to r12.5. Once you have upgraded the Log Manager product on a given CA User Activity Reporting Module server to version r12.5, use only Subscription Service to perform all further subscriptions tasks and configuration changes.
8. In a federated environment, repeat this process for all CA User Activity Reporting Module servers in your environment, in the following order:
  - Upgrade all subscription proxies to the new version of Log Manager
  - Upgrade all subscription clients to the new version of Log Manager
Update all other CA User Activity Reporting Module modules.
1. Click the Administration tab, click the Services subtab, expand Subscription Service, and select your CA User Activity Reporting Module management server. By default, this server is the first you installed in your CA User Activity Reporting Module environment.
  Important! After you perform Step 1, the upgraded CA User Activity Reporting Module r12.5 user interface lists both Subscription Module and Subscription Service. Use only Subscription Service, and not Subscription Module, to perform all further subscriptions tasks, including the following steps. Subscription Module is present only to help ensure proper communication between all CA User Activity Reporting Module servers during the upgrade to r12.5; do not use it to perform subscription functions post-upgrade.
2. Click the Administration tab, and click the global/local button to switch to local service configuration.
3. In the RSS feed URL field, type:
  http://securityupdates.ca.com/CA-ELM/r12.5/RSSFeed.xml
4. Click Browse, select all CA User Activity Reporting Module modules, and click OK. CA User Activity Reporting Module modules can include Content, Integration, Operating System and Agent updates.
5. Verify that all other required values are configured for the selected server.
6. Click Update Now.
  When update is complete, a self-monitoring event appears, indicating that the selected updates have been installed.
7. If an Operating System module was among the updates installed, reboot the CA User Activity Reporting Module server.
8. In a federated environment, repeat this process for all CA User Activity Reporting Module servers in your environment, in the following order:
  - Update all subscription proxies with all current CA User Activity Reporting Module modules
  - Update all subscription clients with all current CA User Activity Reporting Module modules
If Agent or Connector modules were among the updates, install updated agents and connectors.
1. Click the Administration tab, click the Log Collection subtab, and select Agent Explorer.
2. Determine whether to apply subscription updates at the agent explorer level, the agent group level, or the agent level. Select the desired level and click the Subscription button.
3. Apply updates to agents.
4. Click the Subscription button again.
5. Apply updates to connectors.
Reregister third-party and other CA Technologies products, like CA Access Control, that display CA User Activity Reporting Module reports in their native interfaces using the Open API calls.
Completing this step updates the certificates that changed in this release.

Note: Review the Release Notes for any Known Issues related to subscription upgrades. If you are upgrading from a release earlier than 12.5, you may experience issues requiring a manual installation of the pre-12.5 upgrade package.

More information:

How to Register a Product with CA User Activity Reporting Module

Apply Subscription Updates to Agents and Connectors

Upgrading to CA User Activity Reporting Module Version 12.5 through Offline Subscription

To upgrade CA User Activity Reporting Module to version r12.5 using offline subscription, you must first download the offline upgrade file package from the CA Technologies FTP site and manually copy it to all offline proxies. You can then upgrade all servers to version r12.5 of the Log Manager product. You must then repeat this process to update all other CA User Activity Reporting Module modules, such as Content, Integration and Agent modules as well.

Note: The following instructions assume that your entire CA User Activity Reporting Module environment is offline, rather than a mixed environment where some servers are online while others are offline. While it is possible to implement a mixed subscription architecture, it is considered best practice to design either an entirely online or entirely offline subscription architecture.

Important! Upgrade the management server before you upgrade or install any new CA User Activity Reporting Module servers in your network. Doing so allows the servers to register properly.

The process to upgrade to CA User Activity Reporting Module Version 12.5 through offline subscription is as follows.

Download and install the pre-12.5 offline upgrade file package from the CA Technologies FTP site.
Upgrade all subscription proxies to Log Manager version r12.5.
Upgrade all subscription clients to Log Manager version r12.5.
Download and install the 12.5 offline upgrade file package from the CA Technologies FTP site.
Update all proxies with all other CA User Activity Reporting Module version r12.5 modules.
Update all clients with all other CA User Activity Reporting Module version r12.5 modules.
If Agent or Connector modules were among the updates, install updated agents and connectors.

After completing the upgrade process, reregister third-party and other CA Technologies products, like CA Access Control, that display CA User Activity Reporting Module reports in their native interfaces using the Open API calls. Completing this step updates the certificates that changed in this release.

Note: Review the Release Notes for any Known Issues related to subscription upgrades. If you are upgrading from a release earlier than 12.5., you may experience issues requiring a manual installation of the pre-12.5 upgrade package.

More information

How to Register a Product with CA User Activity Reporting Module

Apply Subscription Updates to Agents and Connectors

Update Proxies and Clients With CA User Activity Reporting Module Modules

Install Updated Agents and Connectors

Upgrade Log Manager Application on All Proxies and Clients

Upgrade subscription proxies, then subscription clients to CA User Activity Reporting Module r12.5.

To upgrade subscription proxies and clients to r12.5

Upgrade all subscription proxies to Log Manager version r12.5.
1. Log in to a system in your CA User Activity Reporting Module environment.
2. Click the Administration tab, Services subtab, expand Subscription Module, and select your CA User Activity Reporting Module management server. By default, this is the first server you installed in your CA User Activity Reporting Module environment.
3. In the Modules to Download list, use the arrows to move the Log Manager module from Available to Selected. Remove any other modules from the Selected list.
4. If Offline Subscription Proxy is cleared, select it.
5. Verify that all other required values are configured for the selected server.
6. Click Save.
7. Click Update Now.
  When update is complete, a self-monitoring event appears, indicating that the Log Manager update has been installed. iGateway automatically restarts and your CA User Activity Reporting Module Log Manager session closes.
8. Log in to CA User Activity Reporting Module. In the upper right corner of the Log Manager browser window, click About and confirm that the version number indicates the new version of CA User Activity Reporting Module.
  Note: The upgraded CA User Activity Reporting Module r12.5 user interface lists both Subscription Module and Subscription Service under the Administration tab, Services subtab. Subscription Module reflects the interface and functionality previous to the r12.5 update, and is present to help ensure proper communication between all CA User Activity Reporting Module servers during the upgrade to r12.5. Once you have upgraded the Log Manager product on a given CA User Activity Reporting Module server to version r12.5, use only Subscription Service to perform all further subscriptions tasks and configuration changes.
9. In an environment with multiple subscription proxies, copy the offline update .tar file to each proxy in your environment, untar the file according to the instructions in the Download and Install the Pre-12.5 Offline Upgrade Package topic, and repeat this process for all proxies.
Upgrade all subscription clients to Log Manager version r12.5.
1. Click the Administration tab, Services subtab, expand Subscription Module, and select a subscription client.
  Note: Offline subscription clients automatically receive all modules that are manually installed on their offline proxy. The contents of the proxy server control which updates the subscription client receives. Modules selected at the local level for an offline client have no effect.
2. Verify that all other required values are configured for the selected server. If you change any settings, click Save.
3. Click Update Now.
  When update is complete, a self-monitoring event appears, indicating that the Log Manager update has been installed.
4. Repeat this process for all clients in your environment.
  Note: Instead of manually updating each client, you can also set a global subscription schedule to begin an update after confirming that all proxies have been upgraded to version r12.5.

Download and Install the Pre-12.5 Offline Upgrade Package

Begin the upgrade by downloading and installing the pre-12.5 offline file package.

To download and install the pre-12.5 offline upgrade file package from the CA Technologies FTP site

On a system with Internet or FTP access, navigate to the FTP offline subscription site:
ftp://ftp.ca.com/pub/elm/connectors/ftp/outgoing/pub/elm/ELM_Offline_Subscription

The directory index displays a folder for each CA User Activity Reporting Module release.
Select the 12.5.xx_Offline_Subscription folder, and the Pre_12.5_Upgrade folder.
Download the pre-12.5 offline subscription update package. The file name follows the following format:
subscription_12_5_xx_yy.tar
Using physical media such as a disk, or using scp, manually copy the .tar file to the following path on your offline proxy:
/opt/CA/LogManager/data
Log into the default subscription proxy through ssh as the caelmadmin user.
Switch to root.
Navigate to the following path:
/opt/CA/LogManager/data
Stop iGateway.
Rename the existing subscription directory under /data to subscription.bak. For example, rename it to mydir/data/subscription.bak.
Untar the tar file using the following command:
```
tar -xvf subscription_12_<x_x_x>.tar
```
This creates a subscription folder and extracts the 12.5 upgrade modules. Correct ownership and permissions are automatically set.
Restart iGateway.

Download and Install the 12.5 Offline Upgrade Package

After upgrading all proxies and clients to Log Manager version 12.5, download and install the 12.5 offline upgrade file package from the CA Technologies FTP site.

To download and install the 12.5 offline upgrade file package

On a system with Internet or FTP access, navigate to the FTP offline subscription site:
ftp://ftp.ca.com/pub/elm/connectors/ftp/outgoing/pub/elm/ELM_Offline_Subscription

The directory index displays a folder for each CA User Activity Reporting Module release.
Select the 12.5.xx_Offline_Subscription folder.
Download the offline subscription update package. The file name follows the following format:
subscription_postupgrade_12_5_xx_yy.zip
Using physical media such as a disk, or using scp, manually copy the .zip file to the following file path on your offline proxy:
/opt/CA/LogManager/data/subscription/offline

Update Proxies and Clients With CA User Activity Reporting Module Modules

After upgrading all servers to Log Manager version 12.5, and installing the 12.5 offline upgrade file package, update subscription proxies, and then subscription clients with all additional CA User Activity Reporting Module modules.

To update proxies and clients with all additional modules

Update all proxies with all other CA User Activity Reporting Module version r12.5 modules.
1. Log in to a system in your CA User Activity Reporting Module environment.
2. Click the Administration tab, Services subtab, expand Subscription Service and select your CA User Activity Reporting Module management server.
  The Subscription Service Configuration for the selected CA User Activity Reporting Module server appears.
3. Click the Administration tab.
4. In the File drop-down, select the offline update .zip file you copied to the server, and click Browse.
  The Modules Available for Download dialog appears.
5. Select the modules you want to download. Modules can include Content, Integration, Operating System and Agent updates.
6. Click Save.
7. Click Update Now.
  When update is complete, a self-monitoring event appears, indicating that the selected updates have been installed.
8. In an environment with multiple subscription proxies, copy the offline update .zip file to each proxy in your environment, and repeat this process for all proxies.
Update all clients with all other CA User Activity Reporting Module version r12.5 modules.
1. Click the Administration tab, Services subtab, expand Subscription Module, and select a subscription client.
  Note: Offline subscription clients automatically receive all modules that are manually installed on their offline proxy. The contents of the proxy server control which updates the subscription client receives. Modules selected at the local level for an offline client have no effect.
2. Verify that all other required values are configured for the selected server. If you change any settings, click Save.
3. Click Update Now.
4. When update is complete, a self-monitoring event appears, indicating that all updates have been installed.
5. Repeat this process for all clients in your environment.
  Note: Instead of manually updating each client, you can also set a global subscription schedule to begin an update after confirming that all proxies have been updated with the selected r12.5 modules.

Install Updated Agents and Connectors

If Agent or Connector modules were among the 12.5 update modules, install updated agents and connectors.

To install updated agents and connectors

Click the Administration tab, click the Log Collection subtab, and select Agent Explorer.
Determine whether to apply subscription updates at the agent explorer level, the agent group level, or the agent level. Select the desired level and click the Subscription button.
Apply updates to agents.
Click the Subscription button again.
Apply updates to connectors.