A Missing instance.properties File
The values of the instance.properties file (/usr/sap/<SID>/<instance name>/j2ee/cluster/instance.properties) are stored in the database and are synchronized to the file during the startup process. The export of the instance.properties file is handled in the bootstrap section of the startup framework. However, the bootstrap process apart from using the bootstrap.properties file (for example, to connect to the database), also uses the instance.properties file for some additional parameters (such as, the path to the JVM). Therefore, in case of a missing instance.properties file, the bootstrap will not be able to start. Thus, you will not be able to start the whole J2EE Engine unless you recover the instance.properties file with the parameters, which the bootstrap needs.
The instance.properties file is divided into sections. Each section describes a Java program. The format of one line in the property file is:
<section>.<property name> = <property value>
The parameters from the instance.properties file, which the bootstrap uses, are stored in one section called bootstrap.*. These properties and their descriptions are:
Property Name |
Description |
ClassPath |
The class path of the Java program. |
JavaParameters |
Contains additional Java parameters. This string is passed to the loaded Java VM. Execute Java without arguments to get help for the valid Java parameters and options. |
JavaPath |
The path to the JDK installation directory. The same as the value of the JAVA_HOME environment variable. |
MainClass |
The main class of the Java program. |
MaxHeapSize |
The heap size of the loaded Java VM. The value is in MB (megabytes). |
Name |
The name of the Java program (for example, bootstrap). |
Parameters |
Program arguments used to start the bootstrap process. |
RootPath |
The root path of the Java program. |
Type |
The type of the Java program. The possible values are: unknown, bootstrap, dispatcher, server, sdm. |
Example
The following is an example of an instance.properties file containing the minimal properties needed by the bootstrap to start and to recover the whole instance.properties file:
bootstrap.ClassPath=./bootstrap/launcher.jar bootstrap.JavaParameters=-Djco.jarm=1 bootstrap.JavaPath=C:/j2sdk1.4.2_07 bootstrap.MainClass=com.sap.engine.offline.OfflineToolStart bootstrap.MaxHeapSize=128 bootstrap.Name=bootstrap bootstrap.Parameters=com.sap.engine.bootstrap.Bootstrap ./bootstrap ID0098278 bootstrap.RootPath=C:/usr/sap/J2E/JC00/j2ee/cluster bootstrap.Type=bootstrap |