As of SAP Solution Manager 7.10 SP10 and the releases of SAP Netweaver JAVA 7.30 SP08, 7.31 SP04 and higher, the Portal Activity Reporting configuration is done automatically during the Managed System Configuration. This WIKI page provides information about the configuration and troubleshooting of Portal Activity Reporting in the SAP Solution Manager.
Obs: For SAP Netweaver Java 7.50 Systems on SAP Solution Manager 7.1, please implement the SAP Note 2487737 - Netweaver 7.5 support for activitty 'Register ADC Collector' in solman_setup in order to proceed with the Managed System Configuration of activity "Register ADC Collector" and then assign the Extractor Templates for the System in SAP Solution Manager as described in the KBA:
The SAP Solution Manager Root Cause Analysis applications provides the possibility to have Portal Activity Reporting information in the Workload Analysis for the SAP Netweaver portal systems. To offer this feature the SAP Solution Manager collects the information from the files generated by Portal Activity Data Collector (ADC) through the Diagnostics Agents. Basically, the Portal ADC is configured to generate files containing the portal activity information, then a extractor is scheduled hourly in the SAP Solution Manager to collect this information and store it in the Solman. The extractor trigger the data collection through the Diagnostics Agents installed in the SAP Portal servers. The following picture provides an overview about the architecture:
As of SAP Solution Manager 7.10 SP10 and the releases of SAP Netweaver JAV 7.30 SP08, 7.31 SP04 and higher, the Portal Activity Reporting setup in Solution Manager was fully automated. It is not required to perform the Portal Activity Data Collector configuration manually as it was in the past. The mentioned SAP Portal systems releases provided a 'hidden' ADC configuration that is configured remotely by the SP Solution Manager system to generate the required Portal Activity Reporting files. This hidden ADC configuration is independent of the standard Portal ADC, this means that it is still possible to use the standard Portal ADC to generate custom ADC files as usual no matter if the configuration of the Portal Activity Reporting in the SAP Solution Manager is enabled.
1) Run activity 'Register ADC Collector' in the Managed System Configuration
To perform the configuration of Portal Activity Reporting for the mentioned releases of SAP Solution Manager and Portal system execute the automatic 'Register ADC Collector' in the Managed System Configuration for the target system. The activity 'Register ADC Collector' is available in step Finalize Configuration, the following picture describes where the activity can be found:
The activity 'Register ADC Collector' will configure the Active Data Collector of the Portal system to generate the Portal Activity files with the correct format used by the SAP Solution Manager, the activity will also activate the Extractor 'WORKLOAD ANALYSIS (PORTAL ACTIVITY REPORTING)' which will trigger the data collection in the Diagnostics Agents.
NOTE: The activity 'Register ADC Collector' is shown for the SAP Portal systems which have the Software Component Version EP APPLICATION EXTENSIONS correctly defined in the LMDB. In case the activity '' is not shown in the Managed System Configuration, ensure that the target system indeed has the Software Component Version EP APPLICATION EXTENSIONS and that this component is defined the LMDB.
2) Use activity WebDynpro to ensure that the configuration is correct
The Portal Activity Reporting will work correctly when the Portal Activity files are generated in the correct place and format expected by the Diagnostics Agents that will collect the information. To get details about the configuration and ensure that it is correct, click in the 'Start Web Dynpro' link of the activity 'Register ADC Collector'. This link will open a WebDynpro where it is possible to check whether the configuration in the Portal and SMDAgents are correct. In case the configuration in the Portal system is not compliance with the one expected by the Diagnostics Agents the WebDynpro will indicate the issue, for example if the folder name is incorrect the following message will be shown:
- ADC collector is currently registered on <SID >with these parameters. BUT the Diagnostics Agent is configured with a different folder name: portalActivityTraces. Please unregister ADC collector and register again
The following picture describes the Webdynpro with the error message:
In case the message above is shown in the WebDynpro, then use click on button 'Unregister ADC Collector' and then click on 'Register ADC Collector'. These steps will configure the Portal ADC correctly and the WebDynpro will show message:
- The ADC collector has been successfully registered
The following picture describes the WebDynpro with a successful configuration:
HINT: Ensure that the field 'Close Files Hourly' is select, otherwise Portal Activity Reporting data in the Solman might have a delay depending on the load of the Portal system.
3) Check Portal Activity Information in the Workload Analysis
After finish and ensure that the Portal Activity Reporting configuration is correct in the SAP Solution Manager system, then after one or two hours the Portal Activity Reporting data will be available in the Workload Analysis for the Portal system:
- Transaction SM_WORKCENTER
- Root Cause Analysis Workcenter
- End-to-End Analysis
- Select target system
- Start Workload Analysis
- Go to tab Enterprise Portal
- Go to tab Portal Activity Reporting
In order to have a stable amount of data in the Portal servers, the housekeeping of the files generated by the Portal Active Data Collector is performed in the following ways, by default the housekeeping are active, the housekeeping of the files will be performed in the condition that is met firstly:
Portal ADC Housekeeping
The Portal ADC application has its own housekeeping feature to keep the stable the size of the ADC Reporting files in the system's servers. The configuration of the Portal ADC housekeeping is done configuring the property 'Max Storage Allocation (KB)' in the Portal ADC configuration. This property can be modified in the WebDynpro of the activity 'Register ADC Collector' as shown in section above. By default the automatic configuration shown in the above section configures the Portal ADC with a Max Storage Allocation parameter of 102400 (~100MB).
Diagnostics Agents Housekeeping
Diagnostics Agents of the Portal system are also configured to perform the housekeeping of the Portal ADC files, however as the Portal systems that support the automatic configuration explained in this WIKI also have their own housekeeping feature the diagnostic agent housekeeping is still active but no longer needed and can be deactivated if required.
By default the Diagnostics Agents are configured to delete all ADC files older than 72 hours, the configuration of the housekeeping performed by the Diagnostics Agents can be changed/disabled as follows:
- Acess the Agent Admin UI (http://<solman_host>:<java_http_port>/smd/AgentAdmin)
- Go to Applications Configuration tab
- Select agent application 'com.sap.smd.agent.application.portalactivityreport' (left pane)
- Select the target Diagnostics Agents in 'Scope' (DO NOT USE GLOBAL)
The properties 'smd.padc.cleanup' and 'smd.padc.file_max_age_in_hours' can be modified to change the behavior of the housekeeping performed by the Diagnostics Agents, these properties can be configured as follows:
|smd.padc.cleanup||Enable or Disable the ADC files housekeeping performed by the Diagnostics Agents|
true = ADC Housekeeping enabled in Diagnosics Agents
false = ADC Housekeeping disabled
|smd.padc.file_max_age_in_hours||Maximum age for the Portal ADC files, that is, the Diagnostics Agents will delete all ADC Files with an age higher than the number of hours specified in this parmetes.||File age in number of hours.|
In case of problems to display the Portal Activity Reporting data in the Workload Analysis for the Managed System, use the following troubleshooting steps:
1) Check if WORKLOAD ANALYSIS (PORTAL ACTIVITY REPORTING) is active and running fine
The data collection is triggered by the extractor called WORKLOAD ANALYSIS (PORTAL ACTIVITY REPORTING), ensure that this extractor is active and running without errors. Use the steps below to find the extractor in the Extractor Framework, then check columns 'Active' and 'Last Execution' to get details about the extractor. When the extractor is selected its logs are shown in the bottom of the page.
- Transaction SM_WORKCENTER;
- SAP Solution Manager Administration;
- Extractor Framework;
- Find extractor WORKLOAD ANALYSIS (PORTAL ACTIVITY REPORTING) of the target portal system;
2) Check if Portal Activity Reporting files are being generated correctly
The Porta Activity Reporting data is collected from the files which are generated by the Activity Data Collector of the Portal system. The activity 'Register ADC Collector' configures the Portal ADC to generate the files in the following location:
Go to the location above in the Portal System operating system and check there are files called portalActivity_*_*.txt are being generated, these are the files where the information is collected from.
Check SMDAgent OS user permissions (UNIX Systems)
If the portal system runs on a UNIX server, ensure that the SMDagent OS user permissions are correctly configured as described in note 1163751. The SMDAgent OS user must have at least read permissions to access the Portal Activity Reporting files in the location shown above.
In case the portalActivity_*_*.txt files are not being generated in the Portal System, then proceed to step 3 below.
3) Check number of Additional Collectors in the Portal System
4) Check hidden ADC Configuration in the Portal system directly
In case it is required to double check the hidden ADC configuration directly in the Portal System, it is possible to find it using the following steps:
- Access the Portal Administration page (http://<portal_host>:<java_http_port>/irj/portal)
- Go to PCD Tools
- Click on 'Browse Info' in node 'com.sap.portal.system'
- Click on 'Browse Info' in node 'Activity_Data_Collector'
- Click on 'Browser INfo' in node 'Additional_ADC_Colletors'
- Click on 'AllProps' in node 'PADC'
The following picture describes how to reach the hidden ADC configuration;
The picture below shows the properties configured in the hidden ADC collector.
Ensure that the properties values in the hidden ADC collectors are according to the properties shown in the Setup WebDynpro.