Changing the Configuration

 

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:

Knowledge Base Server or Remote Agent will not start due to a TCP/IP Port Conflict

Enabling the PostgreSQL database

Location of Java Runtime to launch the GUI has changed

Host name of the machine is incorrect or needs to be a fully qualified domain name

Email communication needs to be configured

Enabling LDAP or http Authentication to the Knowledge Base Server

Location of Perl has changed

Knowledge Base Server URL has changed

Debug needs to be enabled

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.

The directory must be located on the machine running Tomcat

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