![]() |
OpenMake Meister |
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:
o Knowledgebase Server or Remote Agent will not start due to a TCP/IP Port Conflict
o Enabling the PostgreSQL Database
o Location of Java Runtime 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 Knowledgebase Server
o Location of Perl has changed
o Knowledgebase Server URL has changed
o 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. 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 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