Download (Trial does not expire)
Purpose
The purpose of this page is to introduce the Landscape Analysis Utility (LAU) for Afaria, a free of charge tool which will be maintained with enhancements and corrections for the foreseeable future. LAU is a Java based tool to be used by support engineers, consultants, and mobility product administrators. It is designed for supporting many aspects of the products and simplifies the process of reporting on the product and landscape configuration, and performing root cause analysis tasks.
Overview
When a support engineer receives a new incident, first thing the engineer needs is an overview of how the product has been implemented in customer's environment. A considerable time sync is required to get the information, and usually repeated multiple times for details. This process usually leads to unorganized information and key pieces of information missing and ultimately longer incident processing time. Mobility customers need a simple and portable approach to gather, organize and analyze environment information. LAU is a standalone application, which can gather information from multiple servers in an environment; including settings, registry, and logs; and generate a report which a customer can view and also send to support engineer for quick analysis.
Requirements
This section helps you prepare your mobility product landscape. The configuration which need to be added:
What? | Where? | Why? |
---|---|---|
OS: Windows | Server and Client (usually laptop where you are running LAU) | LAU only supports Windows OS. Support for Linux and Mac will come in future |
JRE 1.7 or higher | Client | LAU is a Java application |
Afaria SP7 or higher | Server | Contact support to use LAU with older version of Afaria |
Chrome 42 or IE 10 or higher | Client | Some functions of report require Chrome or IE |
SAP Host Agent | Each server node | Metrics and configurations are collected using the SAP Host Agent |
SAP Host Agent
The Host Agent is a service that has a very lightweight performance footprint and provides a secure communication channel between LAU and your server nodes.
- If you already have the Solution Manager Diagnostic Agent 7.x on your server nodes, then you don't need to install the SAP Host Agent as it is already included as part of the Diagnostic Agent
- If you have never installed the SAP Host Agent in your environment, you will need to complete this step
- The SAP Host Agent is not required on the client (usually laptop) where you are running LAU
How to install the SAP Host Agent
In the following procedure, we assume you are using Windows operating system. The steps are similar for other operating systems. For other OS, visit: Installing SAP Host Agent Manually
- Browse to the Software Download Center
- Click Search for Software on the right side of the page and search for "SAP Host Agent"
- Click on SAP Host Agent 7.21 then select the operating system of your server nodes. DownloadSAP HOST AGENT 7.21 SP03.
- Next, return to the Software Download Center and click Search for Software
- Search for "SAPCAR" then click on SAPCAR 7.21. Click on the operating system for host where you will be installing the SAP Host Agent, then download the latest version of SAPCAR 7.21
- Copy the SAP Host Agent and SAPCAR media to a temp folder on your server nodes.
- On your server node, open a command prompt (use Run as administrator option) then browse to the temp directory where you copied the SAP Host Agent and SAPCAR
- Extract the contents of SAPHOSTAGENT*.SAR using command:
SAPCAR*.exe -xvf SAPHOSTAGENT*.SAR - Install the SAP Host Agent using the command:
saphostexec.exe -install
When prompted, set a strong password (upper/lower case letters and numbers) for the new sapadm account. - Confirm in your Control Panel --> Services that the host agent is installed
SSL is required for LAU.
The following steps are to generate and configure Host Agent to use self-signed SSL certificate. We assume that you are using default naming for the server Personal Security Environment. For details, visit: SSL Configuration for the SAP Host Agent - On your server node where Host Agent is installed, open a command prompt (use Run as administrator option) then browse to Host Agent install directory
cd "%PROGRAMFILES%\SAP\hostctrl\exe" - Create a subdirectory named sec and set the SECUDIR environment variable to refer to the new directory using the following commands:
mkdir sec
set SECUDIR=%PROGRAMFILES%\SAP\hostctrl\exe\sec - Create the server Personal Security Environment (PSE), the server certificate therein with common name of the computer name. Replace ‘PASSWORD’ in the command with the password used when installing Host Agent:
sapgenpse get_pse -p SAPSSLS.pse -noreq -x PASSWORD "CN=%COMPUTERNAME%" - Confirm PSE has been created in %PROGRAMFILES%\SAP\hostctrl\exe\sec directory
- Grant the SAP Host Agent access to the server PSE. Replace ‘PASSWORD’ in the command with the password used when installing Host Agent:
sapgenpse seclogin -p SAPSSLS.pse -x PASSWORD -O sapadm - Verify the server certificate chain. Replace ‘PASSWORD’ in the command with the password used when installing Host Agent:
sapgenpse get_my_name -p SAPSSLS.pse -x PASSWORD -v - Restart Host Agent:
saphostexec.exe -restart - Verity Host Agent is listening on port 1129
netstat -o -n -a | findstr 0.0.0.0:1129 - Repeat Host Agent install and SSL configuration for each server node (NOTE: if for example Afaria server and Provisioning server are installed on the same host then you only need one Host Agent running for that host)
Running LAU for first time
Now that Host Agent is installed on all server nodes. We are ready to run LAU for first time. This can be done from any machine with Java Runtime 1.7 or higher; usually ran from laptop not from server.
- Download latest version of LAU from SAP Store (Trial does not expire)
- Unzip the zip file.
- Copy the folder operations.d to the directory %PROGRAMFILES%\SAP\saphostctrl\exe on each server node in your landscape (this is the location where the SAP Host Agent is installed)
- Return to laptop
- Launch LandscapeAnalysisUtility.jar using Java Runtime. This can be done by double clicking the file or from command prompt using command:
java -jar LandscapeAnalysisUtility.jar - Click ‘No’ to continue without importing configuration
- Fill in best contact information for support engineers to reach out and any additional information necessary.
- Click ‘Next’
- Click ‘Add’
- Fill out server address, mobility product service account, server type and number of days of logs to gather. Then click ‘Save’.
- Repeat steps 9-10 to add all remaining servers in your landscape.
- Click ‘Collect Information’
- Wait for collection process to complete. It could take up to 10-12 minutes depending on number of servers in the environment and the amount of logs being retrieved.
- After collection has completed, click ‘Export’ to export all configuration for reuse later. This includes contact information, server addresses, login information, log settings, etc. You will be asked to enter a password for encrypting configuration file, this password can be anything and does not have to be service account password.
- After exporting configuration, click ‘Save’ to generates an analysis report from the information collected and save to a specific location. This report can be sent to support engineer to help troubleshoot issues. The report can be viewed in a browser by opening ‘Report\index.html’ file.
- Click ‘Finish’ to exit.