OpenMake Meister

Changing the Configuration

 

Additional features can be installed and configured by using the Preference pages.  The defaults will enable most users to execute without issues.  The configuration would be changed when the following occur:

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

Enabling the PostgreSQL Database

Location of Java Runtime 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 Knowledgebase Server

Location of Perl has changed

Knowledgebase Server URL has changed

Debug needs to be enabled

 

Perform the following to change the configuration:

 

Table SI-4  Opening the Preference Pages

Step

Action

1

Launch DDS

2

Go to, Window > Preferences

3

Expand the Openmake item and select Machine

 

The Machine Preference page is defined as follows:

 

 

 

Table SI-5  Machine Preference Page

Field

Description

Host Name

The host name of the machine that is running Meister, Knowledgebase Server or Remote Agent.  Client machines will connect the Knowledgebase Server or Remote Agent using this name.

Global Install Directory

This is the location of the install.

JRE Directory

This is the location of the Java Runtime Environment that the Knowledgebase and Remote Agents will run under.

This machine runs as a…

Knowledgebase Server – enables the Knowledgebase Server to be installed

 

Remote Agent – enables the Remote Agent to be installed

 

 

 

Table SI-6  KB Server Tab

Field

Description

Installation Directory

Directory in which the Knowledgebase Server is installed.

KB Server Port

Port number that the Knowledgebase Server will listen for client on.

Build Manager Server Port Number

Port number that the Knowledgebase 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 Knowledgebase

Server Format

Type of Application Server used for the Knowledgebase Server.  Keep set to Standard.

Service Name

Name of the Windows Service

Server Start Command Prefix

Command used to start the server

Server Stop Command Prefix

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 Knowledgebase Server

Update the KB Server Service

This button will update the Windows Service in the Windows Registry

 

 

 

 

Table SI-7  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 Knowledgebase Server

Email Display Name

The display name for email sent by the Knowledgebase Server

 

 

 

Table SI-8 KB Security Tab

Field

Description

Uses HTTP Auth

Check this if the Knowledgebase Server will use a separate URL to validate user IDs that access the Knowledgebase 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 Knowledgebase 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 Knowledgebase 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 Knowledgebase with the LDAP Server

LDAP Admin Group

The Distinct Name for the Group associated with Admin Privileges on Openmake.

 

 

 

 

 

Table SI-9 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 Knowledgebase Server

KB Port

The port number the Knowledgebase 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.

RBS Service Name

Name of the Windows Service

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

Update the RBS Server Service

This button will update the Windows Service in the Windows Registry

 

 

 

Table SI-10 Client Tab

Field

Description                                                                             

Installation Directory

Directory in which the Client is installed.

PATH

Path statement for the machine.  Must contain the <install root>\client\bin directory.

OPENMAKE_SERVER

The URL of the Knowledgebase Server. 

https://<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

JAVA_HOME

The default value of the JAVA_HOME environment variable that workflows will use. This may be left blank. Any value here can be overridden by setting JAVA_HOME in the configuration section of individual workflows and activities.

Java Version

Version of Java found in the Path

 

 

 

*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