Page History
...
Before installing the Precise framework or agents, refer to the most recent Precise Support Matrix at Precise Support Matrix to make sure that the relevant operating systems and technologies are supported.
Supported databases for Precise framework
The Precise framework uses two different database instances for the PMDB database. Ensure that the correct PMDB database instance is available before installing the Precise framework.
The SQL Server PMDB instance supports the following database technologies:
- SQL Server
- Sybase
The Oracle PMDB instance supports the following database technologies:
- Oracle
- DB2 LUW
Hardware requirements for Precise framework
...
Component / Feature | Requirement |
---|---|
Operating system | One of the following:
|
Memory | At least 1 GB |
Display | At least 24-bit color palette and SVGA (1024 x 768) resolution |
...
Info |
---|
Enable the TCP ports that are marked as 'external' in the above table, if your environment is firewall-protected. See Advanced Adding Serversadding servers for information on how to change ports, if this port range is already in use. If you changed the ports on the previous version, they will not be changed after the upgrade. Make sure that the port of the NetBios is opened, if you want to monitor SQL Server instances remotely and you have a firewall between the local and remote servers. |
...
Info |
---|
See the SmartLink Transaction Tracking section in the Installing Precise Installation GuideComponents. |
PMDB requirements
The following table describes the requirements for the PMDB based on the installed platform:
...
Before you install a Web AppTier, you need to grant special file and directory permissions (including all sub-directories) to the UNIX or Windows user that you intend to use during the installation.
Info The permissions in the general collection table are not needed for the ongoing operation, only for installation.
Auto-detected values will be shown. If this user does not have these permissions during installation you will not see these auto-detected values and you will have to supply them manually.
The Operating System user that runs the Web Server or Web Application should have full control privileges for the
<i3_root>
directory (for example: NETWORK SERVICE for IIS6)..Info For the installation of a Web AppTier, you will need a user with Web administrator privileges.
- Permissions that are required for the GENERAL collection on UNIX and Windows.
Table 7 GENERAL collection on UNIX and Windows
Web Server File or Directory iPlanet sitename/config
sitename/config/server.xmlApache Configuration directories (typically:
apache root/conf
) and sub-directories configuration files (typically:httpd.conf
)WebLogic Server installation directory (
WL root
)WL root/site name
WL root/site name/config.xmlWebSphere WS root/properties/version/platform.websphere
andWS root/properties/version/WAS.product
(only for UNIX)
Node directory and all sub-directories, such as:.../cells/cell1/nodes/node1
Nodeserverindex.xml
andserver.xml
files such as.../cells/cell1/nodes/node1/serverindex.xml
and.../cells/cell1/nodes/node1/servers/server1/server.xml
Oracle Applications Server (only for UNIX) OC root/inventory/ContentsXML/configtools.xml
Oracle Applications Server - OPMN Configuration directory (typically:
oracle as root/opmn/conf
) and all sub-directories Configuration files (typically:oracle as root/opmn/conf/opmn.xml
)Oracle Applications Server - Apache Configuration directory (typically:
oracle as root/Apache/conf
) and all sub-directories Configuration files (typically:oracle as root/Apache/conf/*.conf
)Tomcat Configuration directory (typically:
tomcat root/conf
) and all sub-directoriesserver.xml
file (typically under:tomcat root/conf
)Sun ONE Configuration directory (typically:
sunone root/domains/domain1/config
) and all sub-directoriesdomain.xml
file (typically under:sunone root/domains/domain1/config
) - Permissions needed for STATIC instrumentation collection on UNIX and Windows:
Table 8 Permissions for STATIC instrumentation collection on UNIX and Windows
Web Server File or Directory iPlanet, Apache 1.3 Web application pages directory and sub-directories
Page files in the Web application pages directory (such as .html files, .htm files, and so on) - To install a Precise for Web instance on IIS7.x, the " IIS6 Metabase Compatibility " service and ISAPI filters must be installed.
- If you are going to install SAP WAS ABAP, the following prerequisites are needed:
- The import of the Precise for Web transport to the monitored SAP system.
- The download of the SAP Java Connector (JCo).
The installation of SAP Java Connector (JCo) on the server on which Precise for Web FocalPoint is installed.
Info Before installing SAP WAS ABAP, check whether Precise supports your version of SAP WAS ABAP in the Precise Support Matrix that can be found on the Precise Customer Portal.
Precise for Web does not provide the following features for the supported SAP WAS ABAP versions:
- application user collection
- server-side monitoring
- client-side monitoring of new browsers, such as IE8, Chrome, and Firefox 3
To enable IIS6 Metabase Compatibility on Windows 2008
- Go to Start > Control Panel > Programs > Programs and Features.
- On the left Side Bar, select Turn Windows features on or off.
- Go to Roles > Web Server (IIS), and then click Add Role Services.
- Select IIS6 Metabase Compatibility under IIS 6 Management Compatibility.
- Select ISAPI filters under Application Development.
- Click Next, and the follow the instructions on screen.
To enable IIS6 Metabase Compatibility on Windows Vista
- Go to Start > Control Panel > Programs > Programs and Features.
- On the left Side Bar select Turn Windows features on or off.
- Wait for the Windows Features dialog box to open and fill, then expand "Internet Information Services".
- Select the IIS 6 Metabase Compatibility service under IIS 6 Management Compatibility.
- Click OK.
To import the Web transport to the monitored SAP system
import the Web transport to the monitored SAP system
- If it is the first Web instance in the Precise Environment:
- On the Precise FocalPoint server,
- On the Precise FocalPoint server, go to the \
products\i3FP\distribution source\installer\
folder folder - Extract the files with the following path name from the
PSWW_FP_Shared_ALL.zip
file:products\www\install\sap\abap
- Copy the Precise for Web transport files to the SAP System:
- Copy the
K900112.WS4
file that is located in<i3_root>\products\www\install\SAP\abap\cofiles\
to the appropriatedtrans\cofiles
folder on the SAP system. - Copy the
R900112.WS4
file from<i3_root>\products\www\install\SAP\abap\data\
to the appropriatedtrans\data
folder on the SAP system.
- Copy the
- Import the transport from the SAP GUI. During the import, choose the following options:
- Leave Transport Request in Queue for Later Import
- Import Transport Request Again
- Overwrite Originals
- Overwrite Objects in Unconfirmed Repairs
Downloading the SAP Java Connector (JCo)
...
- Open the following URL in a browser window. : http://service.sap.com/connectors
- Enter your SAP Service Marketplace user name and password, and then click OK.
- In the tree view, go to Connectors>SAP Java Connector>Tools Connectors > SAP Java Connector > Tools and Services.
- Review the JCo Release notes for the available versions and choose one that is relevant for the operating system of the i³ for Precise for Web FocalPoint server. Note that the JCo may require other prerequisite software as described in the release notes. Use the JCo version as described in the note above.
...
Info |
---|
If Precise for Web FocalPoint is not yet installed (no Web instances in the Precise system), then perform all of the following sections while considering the " Precise for Web FocalPoint server " as the server on which you are going to install it on. Of course - . Note that some directories will do not exist, so you will need to must create them by yourself (e.g. |
...
- Unzip the contents of the downloaded file to a directory of your choice on the Precise for Precise for Web FocalPoint server.
- From the directory to which you unzipped the downloaded file, copy the
.JAR
file(s) to<i3_root>\java\3rd_party
directory on your Precise for Web FocalPoint server. - If the Precise for Web FocalPoint is installed on Windows, copy the
.DLL
files from the directory to which you unzipped the downloaded file to<i3_root>\products\www\bin
directory on your Precise for Web FocalPoint server.
If the Precise for Web FocalPoint is installed on UNIX/Linux, copy the.SO
files from the directory to which you unzipped the downloaded file to:<i3_root>\products\www\bin
directory on your Precise for Web FocalPoint server. - Make sure the gateway port between the Precise for Web FocalPoint and the SAP Application Server is open in both directions. The gateway port is 33xx, where xx has to be replaced by the instance number of the SAP Application Server.
- Maintain the SAP communication ports the services file in:
Windows. Windows%windir%\system32\drivers\etc\services
UNIX. UNIX/etc/services
- Replace the following <SID> and <instance-number> with the values from your environment:
sapms<SID> sapms<SID> 36<instance-number>/tcp
sapgw<SID> sapgw<SID> 33<instance-number>/tcp
sapdp<SID> sapdp<SID> 32<instance-number>/tcp
e.g. for a SAP system with the SID = PRD and Instance Number 01:sapmsPRD sapmsPRD 3601/tcp # SAP Message Server
sapgwPRD sapgwPRD 3301/tcp # SAP Gateway sapdpPRD
3201 3201/tcp # SAP Dispatcher
J2EE
...
- Create a Microsoft SQL Server login name with system administrator privileges and a password (. Note that this step is optional for the SQL Server AppTier; you . You may use the Microsoft Windows authentication option instead).
- If you want to use the Recommend/What-If feature in Precise for SQL Server with SQL Server 2005 and SQL Server 2008, make sure to install the SQL Server Client tool on both the Precise for SQL Server FocalPoint and Collector servers.
- When running in remote sampling mode, you are required to must provide the Windows user for login into the remote server. This user should have the sysadmin privilege on the remote server, otherwise the installation will fail.
- For the Precise for SQL Server FocalPoint, you need a user for logging in with the server administration privileges.
- When the PMDB is installed using Windows authentication, you need to provide a user that can connect both to the PMDB and to the monitored instance.
SybaseSybase
The additional requirements for Sybase are:
...
For instructions on how to activate these tables, see Sybase's book Performance Tuning: Monitoring and Analyzing at http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.dc20022_1251/html/monitoring/monitoring61.htm
...
- Open the command prompt and run the following command:
"%SYBASE%%SYBASE_OCS%\bin\isql" -v
(PC Open Client version.) - Click Setting > Control Panel > Administrative Tools > Data Sources (ODBC). (ODBC driver version.)
DB2
...
- Refer to the Precise Support Matrix for information on supported DB2 versions and FixPak levels
- Precise software components are installed on each monitored DB2 server. You require create a dedicated Precise OS user to be created on each monitored server. The name "precise" is used as an example.
Windows. Windows On Windows, generally a domain user is created, who is then granted local administrator permissions as required on monitored servers.
UNIX. For UNIX For UNIX servers, you need to must create a Precise user on every monitored server.
For monitored DB2 servers, create the Precise user as follows:- Non-null password, not containing special characters, and has a maximum length of 15 characters
- Connected to the
DB2 SYSADM
group (as reported by theDB2 GET DBM CFG
command) - Login shell is
ksh
, with "dot" (.) in the Path variable - The shared library path (
LD_LIBRARY, SHLIB_PATH, LIB_PATH
) is not set in this user's environment
For monitoring purposes, the Precise user must have the
DBADM
andSYSMON
privileges orSYSADM
privilegesInfo The Precise for DB2 AppTier installation creates a schema in either an existing or new tablespace. If you prefer to create a new tablespace, the user must also have
DBADM
andSYSCTRL
privileges orSYSADM
privileges.- When monitoring DB2 on HP, make sure the database default charset isn't roman8 (CP1051)
- Close the Services window in the Control Panel if you are installing on a Windows server
SAP
Define the fields that Precise for SAP will retrieve for organization and user areas. By default, Precise
...
for SAP retrieves the Department field for organization and the Building field for user area.
The additional requirements for Precise for Storage SAP are:
...
- Precise for
...
- Database Specific
- Precise for SQL Server. Precise Collector can be installed remotely while the EMC Solution Enabler Daemon must be installed on the monitored server.
- Oracle and DB2 (on UNIX/Linux platforms). The user ROOT is required for the installation.
- DB2 only. The Precise users (of the Listener) must be in the OS group of DB2 adm. For example, db2adm1.
- EMC - CLARiiON
- If CLARiiON is the attached storage media, the storage agent of Precise for Oracle or Precise for SQL Server needs to be able to run and gather storage array metrics from the CLARiiON on a periodic basis, and therefore Statistics Logging must be enabled via the CLARiiON software Navisphere.
To enable Statistics Logging in CLARiiON
- Open Navisphere (Typically this will require a user with Storage Administrator rights and the URL of the Navisphere software.)
- Right-click the APM storage System and select Properties.
- On the General tab, select Statistics Logging.
- Click Apply.
- Click OK.
- Click File > Save and Exit.
SAP
Define the fields that Precise for SAP will retrieve for organization and user areas. By default, Precise for SAP retrieves the Department field for organization and the Building field for user area.
The additional requirements for SAP are:
- Precise for SAP function modules are installed on the monitored SAP system (For more information, see the Precise Installation Guide.)
- You need to have SAP user account with the authorization profile Z_PRECISE (For more information, see the Precise Installation Guide.)
- The SAP Java Connector (JCo) version 2.1.9 is installed on the Precise for SAP FocalPoint server
- To install Precise for SAP BW, the SAP BW technical content needs to be enabled (For more information, see the Precise Installation Guide.)
Siebel
The additional requirement for Siebel is:
- A userid capable of executing the
SrvrMgr
utility. You can either use an existing user with administrator privileges or have your Siebel administrator create a special Siebel client for Precise.
PeopleSoft
The additional requirement for PeopleSoft is:
- Verify that the PeopleSoft Applications server can be brought down for a short window of time (approximately 15 minutes) to set the database monitoring parameter to TRUE:
EnableDBMonitoring=1
.
Oracle Apps
The additional requirements for Oracle Apps are:
FORMS LISTENER MODE. The relevant port number is defined by the FORMS_PORT environment variable in the
adfrmctl.sh
script found in the Oracle Applications installation directoryInfo If the Precise Insight Savvy for OA is to be deployed, the Forms server must be a UNIX server and must have the Precise Listener and Insight Savvy for Network agents installed to monitor the Forms Tier of Oracle Applications.
- FORMS SERVLET MODE. If the Precise Insight Savvy for OA is to be deployed, the Forms server must be a UNIX server and must have the Precise Listener and Precise for J2EE agents installed to monitor the Forms Tier of Oracle Applications
- Access to the Oracle Database with a userid having
sysdba
privileges - Must be able to run command: GRANT EXECUTE ON DBMS_PIPE TO <COLLECTOR_SCHEMA_USER>
- Verify that the Oracle Applications server can be brought down for a short window of time (approximately 30 minutes)
- To make the required modifications:
- No users can be logged on to the Oracle Applications server
- No batch jobs or reports can be running on the Oracle Applications server
- The Concurrent Manager must be shut down
- Verify that you can change the
CUSTOM.pll
andCUSTOM.plx
forms library
Insight Savvy for OS and Network
The additional requirements for Insight Savvy for OS and Network are:
- On UNIX, verify the file system where you will install the software is mounted with the
SETUID
option and no security monitoring system (for example CA Etrust) is blockingsetuid
- Verify you have access to use a userid
root
, this is required for installation action items
Insight Savvy for MQ
The additional requirements for Insight Savvy for MQ are:
- The MQ home directory:
- Windows. Check the registry path: SOFTWARE\IBM\MQSeries\CurrentVersion\WorkPath
- UNIX. Usually
/var/mqm
.
- The MQ lib directory:
- Windows. Check the registry path: SOFTWARE\IBM\MQSeries\CurrentVersion\Configuration\ ClientExitPath\ExitsDefaultPath
- UNIX. Usually
/var/mqm/exits
- Ensure that you have a valid MQ user name and password
Insight Savvy for Tuxedo
The additional requirement for Insight Savvy for Tuxedo is:
- On UNIX operating systems you will need Super-user (root) privileges (only for the installation) If the automatic detection does not work, the following procedures can be performed:
To obtain the Tuxedo version number
- Log on as the Tuxedo operator.
- Run the following command:
tmadmin -v
To obtain the Tuxedo domain ID
- Look for the
BBL
process on the server. - Use the name following the
DOM
option. - Alternatively, look for the
UBBCONFIG
file or a file containingUBB
in its name. - Use the value of the
DOMAINID
variable in the RESOURCES section.
If you are not sure what the Tuxedo domain ID is, you can use the UNIX user name running the BBL
process on the server, or simply use an arbitrary name. In upgrade mode, this is the name of the Tuxedo domain you want to upgrade. Via the auto-detection mechanism, invalid characters for Precise may appear. This should be changed manually.
To obtain the path of the Tuxedo installation
directory
- Log on as the Tuxedo operator.
- Check the value of the
TUXDIR
environment variable. - Alternatively, locate the Tuxedo bin directory where the BBL program is located. The Tuxedo installation directory is immediately above it.
To find the Tuxedo configuration file
- Log on as the Tuxedo operator.
- Check the value of the
TUXCONFIG
environment variable.
This is a binary file. Do not confuse it with the textual UBBCONFIG
file. In a PeopleSoft installation, the name of the Tuxedo configuration file is usually PSTUXCFG
. This file is located in the PeopleSoft installation directory/appserv/PeopleSoft Domain
directory. For example: /home/hrprd/hrprd831/appserv/HR_PRD831/PSTUXCFG
Info |
---|
Refer to the Precise Support Matrix for supported versions. |
Custom Apps and Tuxedo
The additional requirements for Custom Apps and Tuxedo are:
...
Table 12 Prerequisites
...
J2EE
...
Restart of the monitored application server after installing the v9.0 upgrade patch on its server.
...
Permission to use the operating system user of the Web/application server.
...
Web
...
Restart of the monitored application server after installing the v9.0 upgrade patch on its server.
...
Permission to use the operating system user of the Web/application server.
- SAP function modules are installed on the monitored SAP system (For more information, see the Installing Precise Components.)
- You need to have SAP user account with the authorization profile Z_PRECISE (For more information, see the Installing Precise Components.)
- The SAP Java Connector (JCo) version 2.1.9 is installed on the Precise for SAP FocalPoint server
- To install Precise for SAP BW, the SAP BW technical content needs to be enabled (For more information, see the Installing Precise Components.)
PeopleSoft
The additional requirement for PeopleSoft is:
- Verify that the PeopleSoft Applications server can be brought down for a short window of time (approximately 15 minutes) to set the database monitoring parameter to TRUE:
EnableDBMonitoring=1
.
Oracle Apps
The additional requirements for Oracle Apps are:
FORMS LISTENER MODE. The relevant port number is defined by the FORMS_PORT environment variable in the
adfrmctl.sh
script found in the Oracle Applications installation directoryInfo If the Precise Insight Savvy for OA is to be deployed, the Forms server must be a UNIX server and must have the Precise Listener and Insight Savvy for Network agents installed to monitor the Forms Tier of Oracle Applications.
- FORMS SERVLET MODE. If the Precise Insight Savvy for OA is to be deployed, the Forms server must be a UNIX server and must have the Precise Listener and Precise for J2EE agents installed to monitor the Forms Tier of Oracle Applications
- Access to the Oracle Database with a userid having
sysdba
privileges - Must be able to run command: GRANT EXECUTE ON DBMS_PIPE TO <COLLECTOR_SCHEMA_USER>
- Verify that the Oracle Applications server can be brought down for a short window of time (approximately 30 minutes)
- To make the required modifications:
- No users can be logged on to the Oracle Applications server
- No batch jobs or reports can be running on the Oracle Applications server
- The Concurrent Manager must be shut down
- Verify that you can change the
CUSTOM.pll
andCUSTOM.plx
forms library
Insight Savvy for OS and Network
The additional requirements for Insight Savvy for OS and Network are:
- On UNIX, verify the file system where you will install the software is mounted with the
SETUID
option and no security monitoring system (for example CA Etrust) is blockingsetuid
- Verify you have access to use a userid
root
, this is required for installation action items
Insight Savvy for Tuxedo
The additional requirement for Insight Savvy for Tuxedo is:
- On UNIX operating systems you will need Super-user (root) privileges (only for the installation) If the automatic detection does not work, the following procedures can be performed:
To obtain the Tuxedo version number
- Log on as the Tuxedo operator.
- Run the following command:
tmadmin -v
To obtain the Tuxedo domain ID
- Look for the
BBL
process on the server. - Use the name following the
DOM
option. - Alternatively, look for the
UBBCONFIG
file or a file containingUBB
in its name. - Use the value of the
DOMAINID
variable in the RESOURCES section.
If you are not sure what the Tuxedo domain ID is, you can use the UNIX user name running the BBL
process on the server, or simply use an arbitrary name. In upgrade mode, this is the name of the Tuxedo domain you want to upgrade. Via the auto-detection mechanism, invalid characters for Precise may appear. This should be changed manually.
To obtain the path of the Tuxedo installation
directory
- Log on as the Tuxedo operator.
- Check the value of the
TUXDIR
environment variable. - Alternatively, locate the Tuxedo bin directory where the BBL program is located. The Tuxedo installation directory is immediately above it.
To find the Tuxedo configuration file
- Log on as the Tuxedo operator.
- Check the value of the
TUXCONFIG
environment variable.
This is a binary file. Do not confuse it with the textual UBBCONFIG
file. In a PeopleSoft installation, the name of the Tuxedo configuration file is usually PSTUXCFG
. This file is located in the PeopleSoft installation directory/appserv/PeopleSoft Domain
directory. For example: /home/hrprd/hrprd831/appserv/HR_PRD831/PSTUXCFG
Info |
---|
Refer to the Precise Support Matrix for supported versions. |
Custom Apps and Tuxedo
The additional requirements for Custom Apps and Tuxedo are:
- When performing an upgrade:
Table 12 Prerequisites
Application Needed Downtime Permissions J2EE
Restart of the monitored application server after installing the upgrade patch on its server.
Permission to use the operating system user of the Web/application server.
Web
Restart of the monitored application server after installing the upgrade patch on its server.
Permission to use the operating system user of the Web/application server.
Tuxedo
If the CORBA Interceptor DLL has been deployed, the Tuxedo domain will need to be shut down for the duration of the upgrade on the Tuxedo server.
- When performing an installation:
Table 13 Prerequisites
Application Needed Downtime Permissions Manual actions J2EE
Restart of the monitored application server after installing the agent for it.
The Web/application server operating system user must have permission to read/write from the Precise installation directory (a.k.a. the <i3_root> directory) and all of its sub folders.
It is therefore highly recommended that the Precise operating system user shares the same group as the Web/application server operating system user.
Web Restart of the monitored application server after installing the agent for it.
The Web/application server operating system user must have permission to read/write from the Precise installation directory (a.k.a. the <i3_root> directory) and all of its sub folders.
It is therefore highly recommended that the Precise operating system user shares the same group as the Web/application server operating system user.
To be performed using the operating system user of the Web/application server at the end of the the installation process, before terminating the downtime:
- Editing the Web/application server configuration files (e.g.
server.xml
,httpd.conf
, etc.) - For monitoring a J2EE application the additional actions will also be required:
- Editing the application server startup script for adding Precise classes to the JVM classpath.
- Editing the Web descriptor (
web.xml
inside WAR or EAR) of the application.
- Editing the Web/application server configuration files (e.g.
...
Tuxedo
...
If the CORBA Interceptor DLL has been deployed, the Tuxedo domain will need to be shut down for the duration of the upgrade on the Tuxedo server.
...
Table 13 Prerequisites
...
J2EE
...
Restart of the monitored application server after installing the v9.0 agent for it.
...
The Web/application server operating system user must have permission to read/write from the Precise installation directory (a.k.a. the <i3_root> directory) and all of its sub folders.
It is therefore highly recommended that the Precise operating system user shares the same group as the Web/application server operating system user.
...
Restart of the monitored application server after installing the v9.0 agent for it.
...
The Web/application server operating system user must have permission to read/write from the Precise installation directory (a.k.a. the <i3_root> directory) and all of its sub folders.
It is therefore highly recommended that the Precise operating system user shares the same group as the Web/application server operating system user.
To be performed using the operating system user of the Web/application server at the end of the the installation process, before terminating the downtime:
...