Configuring the Component Build Service

After the deployment of the Component Build Service follows the configuration.

Prerequisites

The CBS has been deployed successfully on a SAP J2EE Engine (release 6.40). For the user management, the User Management Engine (UME) is used.

The first steps that should be done after CBS deployment are:

...

       1.      Check the basic CBS service settings.

       2.      Create a user that has administrator rights on CBS.

       3.      Check if CBS is accessible.

Initial Steps after Deployment

After the CBS deployment you have to make sure that the CBS service is running.

...

       1.      To check the service status of the CBS, start the Visual Administrator using an administrator user.

                            a.      In case that CBS is running on a J2EE cluster, then the properties mentioned have to be checked for each server node where CBS is running.

Note

The fact that each server where CBS is installed has its own set of CBS properties, is advantageous as this allows configuring CBS in accordance to the underlying hardware.

If you are running CBS on a J2EE cluster, then several server nodes must be considered. For simplicity, Server <node> is used as placeholder for the various server nodes in the course of this section. 

                            b.      In case that CBS service is not running, start the service.

                                                  i.       Go to the node Server <node> ® Services ® Component Build Service.

                                                ii.       Start the service.

       2.      Choose tab strip Properties to check to following settings:

CBS Settings

Key	Meaning	Proposed Value
BUILD_TOOL_JDK_HOME	1.4.2 JDK installation directory Example:  C:\ j2sdk1.4.2_01	Check 1.4.2 JDK installation.
JDK_HOME_PATHS	Semicolon separated list of JDK home installation directories. Example 1: JDK1.4.2_HOME=C:\jdk1.4.2 Example 2: In case more than one JDKs need to be supported: JDK1.3.1_HOME=C:\jdk1.3.1;JDK1.4.2_HOME=C:\jdk1.4.2	Check 1.4.2 JDK installation.
rootFolder	CBS working root directory	Default can be taken.
idleStart	When the value is ‘true’, then the service does not process any requests.  It is as good as being in the stopped state.    Default value is ’true’.	Up to number of CPUs
threadPoolSize	Number of requests that can be processed in parallel. It is not recommended to set the value greater than the number of CPUs.	Up to number of CPUs

 

¡        The value of key rootFolder denotes the directory under which CBS syncs files and builds them. The default value  ./temp/CBS for this key means the CBS root directory is located underneath the installation directory of the SAP Web AS 6.40 J2EE Engine. You can change the value of key rootFolder. For example, you can set the value to C:\cbs.

¡        With regard to key JDK_HOME_PATHS, one or more JDK root directories can be specified as value. If 2 or more JDKs need to be supported, the entries of such a list are separated by semicolon. Therefore, make sure that the JDK root itself doesn’t contain a semicolon. Otherwise, the JDK installation path cannot be determined correctly.

On Windows platforms a path length limit of 256 characters exists. In case that the root folder of the CBS working directory is quite long, this can lead to a situation where the file path exceeds the 256-character limit. As a consequence, CBS may not work correctly if relevant files cannot be created due to the violation of the 256-character limit.

¡        In case that the value of key idleStart is set to ’true’, CBS will not process any requests.  This effect could be desired in some cases. Usually the whole NWDI is deployed. Assuming that only DTR should run on the target machine, a running CBS would unnecessarily consume computing power. It is recommended to set idleStart to ’true’ in case that CBS should not run on the target machine. However, if you want to run CBS on the target machine, you have to set idleStart to ‘false’.

¡        The appropriate value for key threadPoolSize depends on the used hardware.

       3.         Save the new settings.

This will lead to a restart of service Component Build Service.

The CBS service parameters described here represent an extract of all service parameters. For more information about complete description of all service parameters, see CBS Service Properties.