Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This wiki details the various hardware and software requirements that need to be met to apply the Precise product offerings to your systems.

...

  • For installation on Windows, the user must have Local administration privileges.

Anchor
Additionalrequirementspersupportedtechnology
Additionalrequirementspersupportedtechnology
Additional requirements per supported technology

The following topics describe the additional requirements per supported technology:

Oracle

The additional requirements for Oracle are:

  • The Precise for Oracle agent reads the Oracle SGA directly. To do so, the user must be in the same group as the Oracle user to have access to the Oracle shared memory.
    • UNIX. For UNIX servers:
      1. Create a Precise user on every monitored server.
      2. Add the Precise user to the same group as the Oracle software owner (e.g. dba or oinstall). Your DBA group should be the primary group of the Precise user.
    • Windows. For Windows servers:
      1. Create a domain user, who is then granted local administrator permissions as required on the monitored servers.
      2. Add the Precise user to the ora_dba group. On monitored Oracle servers, add the Precise user to the same group as the Oracle user – typically ora_dba.
  • Make sure you have an Oracle DBA user name and password. The user should also have SYSDBA privileges.
  • If you are installing on a Sun Solaris operating system, verify that the /proc file system is available.
  • On UNIX servers, verify that the file system where you plan to install the software is mounted with the SETUID option.
  • Verify that the shared library path variable (LD_LIBRARY_PATH, SHLIB_PATH, or LIB_PATH, depending on the operating system) is not set in the Precise user environment.
  • The Init.ora parameter timed_statistics should be set to TRUE.
Info

During the Oracle AppTier installation, the installer creates a schema in the Oracle database. To do so, it is required to specify an Oracle user with sysdba privileges. This user is used only during the installation. Precise products do not use or save the DBA user name or password for future use.

During the installation, a Super-user (root) privilege is required on Linux and all UNIX operating systems.

 Web

The additional requirements for Web are:

  • 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 1-7 GENERAL collection on UNIX and Windows

    Web ServerFile or Directory
    iPlanetsitename/config
    sitename/config/server.xml
    Apache

    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.xml

    WebSphere

    WS root/properties/version/platform.websphere and WS root/properties/version/WAS.product (only for UNIX)
    Node directory and all sub-directories, such as: .../cells/cell1/nodes/node1
    Node serverindex.xml and server.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-directories server.xml file (typically under: tomcat root/conf)

    Sun ONE

    Configuration directory (typically: sunone root/domains/domain1/config) and all sub-directories domain.xml file (typically under: sunone root/domains/domain1/config)

  • Permissions needed for STATIC instrumentation collection on UNIX and Windows:

    Table 1-8 Permissions for STATIC instrumentation collection on UNIX and Windows

    Web ServerFile 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

  1. Go to Start>Control Panel>Programs>Programs and Features.
  2. On the left Side Bar select Turn Windows features on or off.
  3. Go to Roles>Web Server(IIS), click Add Role Services.
  4. Select IIS6 Metabase Compatibility under IIS 6 Management Compatibility.
  5. Select ISAPI filters under Application Development.
  6. Click Next and follow instructions on screen.

To enable IIS6 Metabase Compatibility on Windows Vista

  1. Go to Start>Control Panel>Programs>Programs and Features.
  2. On the left Side Bar select Turn Windows features on or off.
  3. Wait for the Windows Features dialog box to open and fill, then expand "Internet Information Services".
  4. Select the IIS 6 Metabase Compatibility service under IIS 6 Management Compatibility.
  5. Click OK.

To import the Web transport to the monitored SAP system

  1. If it is the first Web instance in the Precise Environment:
    1. On the Precise FocalPoint server, go to the \products\i3FP\distribution source\installer\ folder
    2. Extract the files with the following path name from the PSWW_FP_Shared_ALL.zip file: products\www\install\sap\abap
  2. Copy the Precise for Web transport files to the SAP System:
    1. Copy the K900112.WS4 file that is located in <i3_root>\products\www\install\SAP\abap\cofiles\ to the appropriated trans\cofiles folder on the SAP system.
    2. Copy the R900112.WS4 file from <i3_root>\products\www\install\SAP\abap\data\ to the appropriated trans\data folder on the SAP system.
  3. 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)

For information regarding the SAP JCo, see Installing the SAP Java Connector (JCo).

Info

Precise for Web only supports SAP JCo version 2.1.9. Precise currently does not support SAP JCo version 3.x.

Verify that you download the corresponding JCo bit version (32 or 64 bit) for the operating system that the Precise for Web FocalPoint is installed on.

To download the SAP JCo

  1. Open the following URL in a browser window. http://service.sap.com/connectors
  2. Enter your SAP Service Marketplace user name and password, and click OK.
  3. In the tree view, go to Connectors>SAP Java Connector>Tools and Services.
  4. 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.

Installing the SAP Java Connector (JCo)

Info

If Precise for Web FocalPoint is not yet installed (no Web instances in the Precise system) then perform all the following sections while considering the "Precise for Web FocalPoint server" as the server you are going to install it on. Of course - some directories will not exist, so you will need to create them by yourself (e.g.<i3_root>\products\www\bin).

To install the SAP JCo

  1. Unzip the contents of the downloaded file to a directory of your choice on the Precise for Precise for Web FocalPoint server.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. Maintain the SAP communication ports the services file in
    • Windows. %windir%\system32\drivers\etc\services
    • UNIX. /etc/services
  7. Replace the following <SID> and <instance-number> with the values from your environment:
    sapms<SID> 36<instance-number>/tcp
    sapgw<SID> 33<instance-number>/tcp
    sapdp<SID> 32<instance-number>/tcp
    e.g. for a SAP system with the SID = PRD and Instance Number 01:
    sapmsPRD 3601/tcp # SAP Message Server
    sapgwPRD 3301/tcp # SAP Gateway sapdpPRD
    3201/tcp # SAP Dispatcher

J2EE

The additional requirements for J2EE are:

  • If the J2EE Collector is hosted on an AIX server, make sure that the user limits for the Precise user are unlimited for data.
  • The user of the application server (regardless of the application server type) must have the following file system permissions:

    Table 1-9 File system permissions

    DirectoryPermissionsJustification

    <i3_root>/logs

    Read/write

    Write log file, log file rotation

    <i3_root>/products/j2ee

    Read/write

    Various configuration files, status files

    <i3_root>/infra/cluster

    Read/write

    Cluster installation management files

  • When Precise for J2EE monitors WebSphere, the privileges of the Precise for J2EE user must be the same as those needed to run the WebSphere administration server.

Microsoft .NET

The additional requirements for Microsoft .NET is:

  • Create a Microsoft .NET login name with system administrator privileges and a password.
  • The user running the .NET application (regardless of the application type) must have full control privileges for the <precise_root> folder.

SQL Server

The additional requirements for SQL Server are:

  • Create a Microsoft SQL Server login name with system administrator privileges and a password (optional for the SQL Server AppTier; 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 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.

 Sybase

The additional requirements for Sybase are:

  • Make sure you have access to an existing Sybase user name with the system administrator privileges.
  • Make sure to install the Sybase PC Open Client of one the supported versions.

    Table 1-10 Supported Open Client and related ODBC versions

    Open ClientODBC version

    12.5.1 ESD #2

    Sybase Adaptive Server Enterprise ODBC driver version 4.20.00.67

    12.5.1 ESD 15

    Adaptive Server Enterprise version 12.05.01.529

    15.x

    Adaptive Server Enterprise version 15.0.0.152

  • Make sure that the following components are installed:
    • Embedded SQL/C
    • Monitor Client Library
    • ODBC driver
  • To enable monitoring of the Sybase AppTier, you need to adjust the Adaptive Server Enterprise (ASE) configuration parameters

The following table specifies the parameter values for ASE version 12.5.0.3 and higher:

Table 1-11 Parameter values

ParameterValue

max SQL text monitored

16384

enable monitoring

1

SQL batch capture

1

wait event timing

1

SQL text pipe active

0

plain text pipe active

0

statement pipe active

0

errorlog pipe active

0

deadlock pipe active

0

process wait events

0

object lockwait timing

0

statement statistics active

0

per object statistics active

0

Info

The value given for the event buffer per engine parameter in the table is a minimum value. You may also use a higher value if required.

  • Make sure that the user used to monitor the Sybase instance is a member of the mon_role and sa_role server roles

    Info

    To grant the mon_role server role, run the following command: grant role mon_role to user name. For example, if you connect as system administrator, run the command as: grant role mon_role to sa.

  • The following tables must be activated:
    • monProcessSQLText
    • monProcess

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

  • Make sure that the master.sysservers table includes the following entry: sp_addserver logical name,'local',physical name where: logical name is the name used to address the server on your system and physical name is the name of the instance as it appears in the interface file. This file is usually located in the sybase root dir/ini/sql.ini directory or the sybase root dir/interfaces directory.

    Info

    The entry points to the Sybase instance as the local server (srvclass=0). If this entry does not exist, add it to the table.

  • To function properly, the Statistics workspace requires that you comply with the following requirements:
    • Run the sp_sysmon system stored procedure with the noclear option set only. For example: sp_sysmon "00:01:00", noclear.
  • 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

To check which PC Open Client and ODBC driver versions are installed

  1. Open the command prompt and run the following command: "%SYBASE%%SYBASE_OCS%\bin\isql" -v (PC Open Client version.)
  2. Click Setting > Control Panel > Administrative Tools > Data Sources(ODBC). (ODBC driver version.)

 

 

Precise. Performance intelligence from click to storage. Learn more > >