• Apia ALL.ALL.ALL

If problems appear when trying to carry out a migration in Apia, the first step to follow is to verify the Logs of the Apache Tomcat and Apia in search of exceptos of type java.lang.OutOfMemoryError.

If there is a register of this exception in the Log, the steps detailed hereunder must be followed.

Scene presentation:
- Apache Tomcat 5.5 installed as a service of Windows.
- JDK 1.5.
- Windows 2003 with the ports 8080 and 8500 opened.
- Key of the register corresponding to the register:
[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Procrun 2.0\NameContext]

1 - Add in the key [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Procrun 2.0\NameContext\Parameters\Java] inside the value Options:
-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port="8500"
-Dcom.sun.management.jmxremote.authenticate="false"
-Dcom.sun.management.jmxremote.ssl="false"
Restart the Apache Tomcat's service so that it takes the changes.

Note: the port of the JmxRemote can be defined with any free port in the server.

2 - Start from a machine with access to the server, the jconsole.exe avaiable in the folder bin of the jsdk1.5. To connect the console to the agent enter the ip of the server and the port (8500).

In the section "Memory" there is a graphic in real time of use of memory.
The user must verify both the Heap memory (Heap Memory Usage) and the Non-Heap (PS Perm Gen).

3 - Execute the migration and verify the values reached in the memory's utilization in a way to establish the new values in the register (see point 4).

Entrance in the Log: java.lang.OutOfMemoryError: PermGen space error
Values to add in the register:
-XX:PermSize=64m
-XX:MaxPermSize=256m

Entrance in the Log: java.lang.OutOfMemoryError: Java heap space error
Values to add in the register:
-Xms256m
-Xmx512m

Note: the values are given as an example. They must adjust to the values monitored by the jconsole.

4 - Add in the key [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Procrun 2.0\NameContext\Parameters\Java] inside the Value Options the values indicated in point 3.

Restart the Apache Tomcat's service so that it takes the changes.

5 - Execute from step 3 until achieving values which allow the correct execution of the migration.

6 - Once the migration has been executed successfully, reestablish the values by default.

Note: it is suggested the use of the jconsole to adjust the values by default, so that they allow a correct use of the system without overassigning resources of the server.

[ AFC00137 ]		Cloning of data in memory
[ AFC00263 ]		Load of cubes in the server´s memory
[ ATI00185 ]		High consumption of memory on the part of the IE
[ AFC00224 ]		Schedulers which load in memory Apia's cubes
[ AFC00226 ]		Load in memory of cubes through a Scheduler generated when confirming the design of the entity
[ AHF00134 ]		When is it advisable to delete the work directory of Apache Tomcat
[ AHF00143 ]		Solution for the error "Unable to compile class for JSP" al utilizar Tomcat 5.5.9 and JDK 5.0
[ ATI00103 ]		Apia's migration tool
[ AFC00354 ]		Migration of hierarchical structure
[ ADF00003 ]		Apia's 2.2 Installation handbook