Setting up WebSphere Application Server

The Connector server requires specific property settings on the Java™ virtual machine in which it runs.

Before you begin

The following tasks are done:

About this task

You use the console to set up the application server with specific properties for the connector enterprise application that you are about to deploy.

Procedure

  1. Verify or update the WebSphere Application Server level. For a list of supported versions and fix packs, see Detailed System Requirements for Rational® Connector for SAP Solution Manager.

    To see the latest WebSphere Application Server fix packs and interim fixes to your installation of WebSphere Application Server, see WebSphere Application Server and Java JRE update information.

  2. The Connector server requires several specific settings on the Java vrtual machine in which it runs. To set these properties, in the WebSphere Integrated Solutions Console, click Servers > Server Types > WebSphere application servers > Server1.

    You select the Application Server to which Connector Server is to be deployed. The default is Server1.

  3. Under Server Infrastructure, click Java and Process Management > Process definition.
  4. Under Additional Properties, click Java Virtual Machine.
  5. Add the value 100 to Initial Heap.
  6. Add the value 4098 to Maximum Heap Size.

    Setting heap size in WebSphere Application Server

    More memory is better if your system memory is sufficient and or you expect to process large blueprints.

    Tip: The figure here is only a suggestion; set the value according to your environment. A typical medium-size team can use a value of 4096 MB, providing 4 GB of heap memory for the application server process on a 64-bit computer. It is important to use the same amount for Initial and Maximum heap sizes. If you reduce the initial and maximum heap sizes from 4 GB, you must also change the JVM arguments -Xmx4g and -Xms4g to match the specified heap size.

    It is also important to have more physical memory than is required by all of the processes on the system that is combined to prevent paging or swapping. Paging reduces the performance of the system and affects the performance of the Java memory management system.

    When you increase the Java heap size, ensure that enough unused physical memory is available on the system to cover the increase. If sufficient physical memory is not available, either install more memory or take into account the effect on overall performance that occurs.

  7. Click Apply, and then click Save directly to the master configuration.
  8. One of the custom properties you must add is SAPC_HOME, a system property that specifies where the Java virtual machine can find the required configuration files. You substitute SAPCInstallDir with your Connector server installation directory.
  9. Go back to Java Virtual Machine under Additional Properties and click Custom Properties. Add the following properties by clicking New, entering the name and a value, and then clicking OK.
    • Name: SAPC_HOME Value: SAPCInstallDir\server\conf
    • Name: com.ibm.websphere.webservices.DisableIBMJAXWSEngine Value: true
    • Name: com.ibm.ws.classloader.encodeResourceURLs Value: true
    • If you are connecting to an Oracle database, Name: ORACLE_JDBC_DRIVER_FILE Value: Absolute path to the JDBC driver\ojdbc6.jar
      Important: The path to the JDBC driver must be an absolute path. Do not use URL path (file:///). For more information about Oracle Java Database Connectivity (JDBC) connections, see Setting up an Oracle database.
    • If you are connecting to a SQL Server database, Name: SQLSERVER_JDBC_DRIVER_FILE Value: Absolute path to the JDBC driver\sqljdbc4.jar
      Important: The path to the JDBC driver must be an absolute path. Do not use URL path (file:///). For more information about SQL Server JDBC connections, seeSetting up a Microsoft SQL Server database.
    When you are done, the Java Virtual Machine Custom Properties page can be similar to the following code snippet:

    Resource: SAPC_HOME; Value: C:\Program Files\IBM\SapConnector\server\conf
    Resource: com.ibm.websphere.webservices.DisableIBMJAXWSEngine; Value: true
    Resource: com.ibm.ws.classloader.encodeResourceURLs; Value: true

    Custom properties for the Java virtual machine
  10. Click Save directly to the master configuration.
  11. For changes to take effect, restart the application server.

What to do next

Deploy the connector web application by using the console, see Deploying on WebSphere Application Server.

Feedback