Computing and allocating memory

IBM® InfoSphere® Information Governance Catalog coexists with other IBM InfoSphere Information Server product modules and with WebSphere® Application Server. InfoSphere Information Governance Catalog has a memory consumption limit to prevent it from degrading the operation of other product modules.

About this task

The default InfoSphere Information Governance Catalog memory consumption limit of 200 MB is meant for the default WebSphere Application Server maximum heap setting of only 2 GB for the whole suite. For typical operations, you need to increase the maximum heap setting of WebSphere Application Server. You decide how much of this memory to give to InfoSphere Information Governance Catalog.

Internally, the number of KB corresponds to the number of objects that InfoSphere Information Governance Catalog is allowed to temporarily hold in memory at one time, such as during some reporting activities.

Typically, 6 GB for the WebSphere Application Server maximum heap setting and 4000000 maxObjectsInMemory is sufficient.

The RAM size for the WebSphere Application Server must be large enough to allow the operating system and any additional processes to run smoothly. Usually, at least 2 GB more than the WebSphere Application Server maximum heap setting is sufficient. See the following diagram for memory sizing of a typical installation.

1. If needed, change the JVM maximum heap size.

   Option	Description
   WebSphere Application Server Liberty Profile	Follow the instructions in the technote.
   IBM WebSphere Application Server Network Deployment	Open the WebSphere Application Server administrative console. In the left pane, click Servers > Server Types > WebSphere Application Servers. In the Application Servers list, click the name of the server. In the Server Infrastructure section, expand Java and Process Management, and then click Process Definition. In the Additional Properties section, click Java Virtual Machine. In the Maximum Heap Size field, type the maxHeap value. For example, for 6 GB type 6144M. Click Save. Restart WebSphere Application Server for the memory allocation to take effect.

2. In the command shell, go to the installation_directory\ASBServer\bin directory,
   where installation_directory is the directory where InfoSphere Information Server was installed.

   Table 1. Typical installation directory according to operating system type

   Operating system	Installation directory
   Microsoft Windows	C:\IBM\InformationServer
   UNIX	/opt/IBM/InformationServer

3. Run the command to allocate max_objects, which is the maximum number of objects that are allowed to be held simultaneously in memory.

   Table 2. Command to allocate memory according to operating system type

   Operating system	Command
   Microsoft Windows	iisAdmin.bat -set -key com.ibm.iis.gov.vr.setting.maxObjectsInMemory -value max_objects
   UNIX	iisAdmin.sh -set -key com.ibm.iis.gov.vr.setting.maxObjectsInMemory -value max_objects

   Important: The maximum memory allocation for InfoSphere Information Governance Catalog must always be less than the maximum heap size for WebSphere Application Server. Therefore, whenever you reduce the maximum heap size for WebSphere Application Server, you might need to also reduce the memory allocation for InfoSphere Information Governance Catalog. Otherwise, an OutOfMemory condition might occur that stops the operation of WebSphere Application Server and the entire InfoSphere Information Server suite.