Additional features can be installed and configured by using the Meister Preference pages. The defaults will enable most users to execute without issues. The configuration would be changed when the following occur:
o Knowledge Base Server or Remote Agent will not start due to a TCP/IP Port Conflict
o Enabling the PostgreSQL database
o Location of Java Runtime to launch the GUI has changed
o Host name of the machine is incorrect or needs to be a fully qualified domain name
o Email communication needs to be configured
o Enabling LDAP or http Authentication to the Knowledge Base Server
o Location of Perl has changed
o Knowledge Base Server URL has changed
o Debug needs to be enabled
o The JAVA_HOME of the default Java compiler has changed
Perform the following to change the configuration:
Table SI-8 Opening the Meister Preference Pages
|
Step |
Action |
|
1 |
Launch Meister |
|
2 |
Go to, Window - Preferences |
|
3 |
Expand the Openmake item and select Machine |
The Machine Preference page is defined as follows:
Table SI-9 Machine Preference Page
|
Field |
Description |
|
Host Name |
The host name of the machine that is running Meister, Knowledge Base Server or Remote Agent. Client machines will connect the Knowledge Base Server or Remote Agent using this name |
|
Global Install Directory |
This is the location of the Meister install |
|
JRE Directory |
This is the location of the Java Runtime Environment that the Knowledge Base and Remote Agent will run under. This is not related to any Java compiler used for builds. |
|
This machine runs a… |
Knowledge Base Server – enables the Knowledge Base Server to be installed
Remote Agent – enables the Remote Agent to be installed
Client - enables the Command Line Client to be installed |
Table SI-10 KB Server Tab
|
Field |
Description |
|
Installation Directory |
Directory in which the Knowledge Base Server is installed |
|
KB Server Port |
Port number that the Knowledge Base Server will listen for client on |
|
Build Manager Server Port Number |
Port number that the Knowledge Base Server will listen on for the Workflow Monitors |
|
Database Driver |
This is used for the PostgreSQL database. The value is defaulted to and should be org.PostgreSQL.Driver |
|
Database Name |
This is used for the PostgreSQL database. The value is defaulted to and should be: jdbc:PostgreSQL:postgres |
|
Database UserID |
This is used for the PostgreSQL database. The value should be set to a user id that has a security setting with the ability to create and replace objects in the database. |
|
Database Password |
This is used for the User ID defined to the PostgreSQL database. |
|
Run in Debug Mode |
Turn on debugging for the Knowledge Base |
|
Server Format |
Type of Application Server used for the Knowledge Base Server. Keep set to Standard |
|
Server Start Command |
Command used to start the server |
|
Server Stop Command |
Command used to stop the server |
|
Restart the KB Server |
This button will issue a Stop Command and then a Start Command to restart the Knowledge Base Server |
Table SI-11 Email Tab
|
Field |
Description |
|
Email Server |
Name of the SMTP server to use for sending outgoing emails |
|
Email Port |
Port for the SMTP server, defaults to 25 |
|
Uses Login |
Check this if the SMTP server requires a login to send email |
|
Email Login |
Login user ID for the SMTP server |
|
Uses Password |
Check this if the SMTP server requires a password for the login |
|
Email Password |
Password for the SMTP user ID |
|
Uses SSL |
Check this if the SMTP server requires an SSL connection |
|
Return Email Address |
Reply To: email address for email sent by the Knowledge Base Server |
|
Email Display Address |
The display name for email sent by the Knowledge Base Server |
Table SI-12 KB Security Tab
|
Field |
Description |
|
Uses HTTP Auth |
Check this if the Knowledge Base Server will use a separate URL to validate user IDs that access the Knowledge Base Server via a Web Browser |
|
HTTP Auth Dir |
Openmake Http Authentication Directory - This is the directory that will hold the index.shtml file and applet libraries once the Knowledge Base Server has been initialized. o The directory must be located on the machine running Tomcat o The directory must be able to be secured using standard HTTP authentication mechanisms
|
|
Use LDAP |
Check this if the Knowledge Base Server will interact with an LDAP Server to manage Users and Groups |
|
LDAP URL |
URL to connect to the LDAP Server |
|
LDAP Auth Type |
Authentication Type the is required by the LDAP Server Values are: simple, heavy, or none |
|
LDAP ID |
Distinguished Name of the user with write privileges for the Openmake group on your LDAP server |
|
LDAP Password |
Password for the LDAP ID defined above |
|
LDAP Sync |
Interval to sync the Knowledge Base with the LDAP Server |
|
LDAP Admin Group |
The Distinct Name for the Group associated with Admin Privileges on Openmake. |
Table SI-13 Remote Agent Tab
|
Field |
Description |
|
Installation Directory |
Directory in which the Remote Agent is installed. |
|
Remote Agent Port |
Port number on which the Remote Agent will listen for remote builds. |
|
Run in Debug Mode |
Turn on the Remote Agent debug output |
|
KB Server |
The host name of the Knowledge Base Server |
|
KB Port |
The port number the Knowledge Base Server is listening on |
|
Host Alias |
Alternate name for the Remote Agent |
|
Local Mode |
True or False. True for running scheduled builds on local machine. False if running Remote Builds. Requires an updated license. |
|
Server Start Command Prefix |
Command used to start the server |
|
Server Stop Command Prefix |
Command used to stop the server |
|
Restart the RBS |
This button will issue a Stop Command and then a Start Command to restart the Remote Agent |
Table SI-14 Client Tab
|
Field |
Description |
|
Installation Directory |
Directory in which the client is installed. This path will normally end with “client” |
|
OPENMAKE_HOME |
Will resolve to <installation directory>\bin and will be included in the path when executing workflows. |
|
OPENMAKE_SERVER |
The URL of the Knowledge Base Server. http://<KB Server Host Name>:<KB Server Port>/openmake |
|
Perl Version |
Version of Perl found in the PATH |
|
PERLLIB |
The PERLLIB environment variable. Must contain <install root>\client\perl\lib. This directory is where Openmake.pm resides. |
|
JAVA_HOME |
Path to the Java Development Kit home directory of the default Java compiler to use in builds. This is the directory above, but not including, the “bin” folder. This may be left blank. Any value here can be overridden by setting JAVA_HOME in the configuration section of individual workflows and activities. Note that you must have a valid value for JAVA_HOME defined in order to do Java builds. |
|
Java Version |
Version of Java found in the Path |
|
REFDIR Environment variable |
Directory to where the sample applications are installed. |
Note: After making any changes to the Machine Preferences click “Apply” or “OK” and then restart the application.
These values from the Machine configuration are stored in the following files:
%APPDATA%\openmake\omenvironment.properties – for Windows
$HOME/.openmake/omenvironemt.properies – for Unix
<install root>/client/buildserver/rbs_startup.xml
<install root>/client/buildserver/rbs.ini
<install root>/kbserver/kbs.ini
<install root>/kbserver/tomcat/webapps/openmake.ear/openmake.war/WEB-INF/web.xml