OpenMake® Meister® 7.2 User Guide Pre-requisite Checklist Use of this Guide Meister's Benefits Centralized Control and Workflow Management Enhanced Continuous Integration Support Workflow Activity Dependency Chaining Build Best Practices and Reuse Multi-Language and Multi-Platform Builds Distributed and Parallel Builds On-demand Build Knowledge Meister Insight's Build Forensics Ecosystem Automation Meister Components Meister Eclipse Rich Client Platform GUI Management Control Console Postgresql Database Local Knowledge Base Server Community Developed Knowledge Base Server Remote Build Servers Continuous Integration Server Workflow Process Automation Activity Plug-Ins Meister Insight Next Steps Build and Workflow Procedures and Usage Workflow Automation Continuous Integration Builds and Build Loops Distributed, Multi-language and Multi-platform Builds and Workflows On-Demand Builds and Workflows Contact Support Purchased Support and Evaluations Non Purchased Support Setup and Installation Installation Checklist Performing the Install Launching the Install Installing the Command Line Client Installing a Knowledge Base Server Knowledge Base Server as a Windows Service Installing a Remote Build Server Build Server as a Windows Service Enabling the PostgreSQL Database Enabling a Secure Login Changing the Configuration Switching to the Community Knowledge Base Requesting and Installing a New License Installing Meister as an Eclipse Plug-in Installing and Setting up the Eclipse Target Generation Plug-In Configuring the Eclipse Target Generation Plug-in Adding new Build Service Mappings Setting Default Build Project Properties Configuration Within .NET 2003 .NET 2003 External Tool - omNET: TGT Generation .NET 2003 External Tool - omNET: Build Configuring the Visual Studio 2005 and 2008 Add-in Prerequisites Performing the Configuration Accessing the Management Control Console Uninstalling Meister Testing Your Installation Testing Your Installation with Workflows The "Copy Example - Windows" Workflow The "System Info-Windows" Workflow The "Hello World - Windows" Workflow The "Metalworks ANT Build" Workflow Testing the Installation with Meister Build Services The "MetalWorks with Build Audit" Workflow Developing Workflows What You Can Do with a Workflow Workflow Monitor Setting Up Your Workflow Executing Workflows on a UNIX Platform Setting Up Environment Variables Creating Activities Configuring Activities Setting Up Dependencies Between Activities Setting Up E-Mail Notifications Executing and Monitoring Your Workflow Using the Workflow Editor Overview Tab Screen General Information Field Execute Settings Field Data Field Adding Variables and Scripts Activities Tab Screen Activity Information Field Command Field Configure Machine/Activity Environment Fields Dependencies Field Machine Details Field Saving Workflows Running Workflows omcmdline.jar options Building inside the Eclipse Plug-In Building inside of Microsoft .Net 2003 Building inside of Microsoft .Net 2005 and 2008 Activity Plug-ins Pre-Defined Activity Plug-ins AccuRev Borland StarTeam CA CVS Emma IBM Rational OpenMake Meister OpenMake Mojo Microsoft MKS Integrity Notification Perforce Serena SourceForge Subversion Creating Activity Plug-ins Configuring Your Build Project Projects and Dependency Directories First Found Dependency Naming a Project Adding and Deleting Projects Naming a Project's Dependency Directories List Adding a New Dependency Directory List Name Adding Directories to your Dependency Directory List The REFDIR Variable Eclipse Plug-in Dependency Directories .NET and "Project" Dependency Directories Reusable Dependency Directories Ordering Dependency Directories Using Dependency Directory Lists for a Life Cycle Process Life Cycle Example Using Dependency Directory Lists for a Version Label Process Recommended Dependency Directory Setup Purchased 3rd Party Libraries Pre-Defined Compiler Dependency Directories Reusable Source Code Best Practices Using Build Services Build Service Attributes Creating Your Build Service Reviewing Pre-Defined Build Services Creating Your Custom Build Services Overview Attributes Detail Attributes Build Options Build Task Build Rules Wild Cards in Build Rules Phony Targets Using Build Methods How Build Methods are Executed Using Available Build Methods Ant and Java Build Methods Borland Build Methods Microsoft Build Methods IBM Rational and WebSphere Build Methods IBM AIX Build Methods HP Build Methods Microfocus Cobol Build Methods Oracle Build Methods Sun Solaris and Sybase Build Methods Weblogic Build Methods Other Build Methods z/OS Build Methods Writing Customized Build Methods Using the Build Method Editor Using Variables Variable Definitions Reusable Functions Openmake.pm FirstFoundInPath FirstFoundInPath ( $MyFile, $MyUserPath ) GetAnt unique Exclude( $pattern, @inlist ) GetCompiler, get_compiler FindFlag( $flagString, @possibleFlags ) GetFlag( $flagString, @possibleFlags ); GetExcludes( $Defines ) mkfulldir ( $Path ) CopyLocal( $FullPathDeps, $RelDeps, $toDir ) CopyExcludeLocal( $TargetDeps, $RelDeps, $toDir, @excludeExtensions ) ReadPackagesFile ( $TargetDeps) GetPackages ( @FileList ) GetPackageDeps ( $TargetDeps) GetClassPath ( $TargetDeps ) GetClasses ( $TargetDeps ) GetLocalClassPath ( $HOME_ENV ) GetSubTaskDeps ( $TargetDeps, $TargetRelDeps, $wanted_dir, $sub_task_ext ) GetAntIncludeXML ( @items ) WriteAntXML GenerateBillofMat( $BillofMat, $BillofMatRpt, $TargetFile ) GenerateFootPrint($FootPrint,$TargetFile,$FPSource,$FPObject,$CompilerFound,$FPCompilerArguments ) ExitScript( $RC, @doomedFiles ) Reusable Objects Openmake::File new(), new($FileName) set($FileName) getExt(), getE() getQuoted() getEscaped() getEscapedQuoted() getJEscaped() getJEscapedQuoted() setFile($FileName) getFile(), getFE() getF() getPFE() getDPF() getDPFE(), get() getAbsolute() getRelative() Openmake::FileList new, new( @list_of_files ) getExtension() getExt( @ExtensionList ) getExtList( @ExtensionList) getExtQuoted( @ExtensionList ) getExtQuotedList getAbsolute, getAbsolute($anchor_dir) getAbsoluteList, getAbsoluteList($anchor_dir) getQuotedAbsolute, getQuotedAbsolute( $anchor_dir ) Openmake::Log omLogger Openmake::SearchPath CleanSearchPath(@list_of_directories) new(@list_of_directories), new($string_of_directories) newFromScalar($string_of_directories) set(), set(@list_of_directories) setFromScalar(), setFromScalar($string_of_directories) get() getList() getString($PreText,$PostText) count() getQuoted() getQuotedList() getEscapedList() getEscapedQuotedList(), getQuotedEscapedList() getJEscapedList(), getJavaEscapedList() getJEscapedQuotedList(), getJavacEscapedQuotedList() push($dir) pop() mkdirs() unshift($dir) shift() Openmake::Path new(), new($full_path_string) get(), getDP() setVolume( $drive ), setDrive( $drive ) getVolume(), getDrive(), getD() setPath ( $path_string ) set( $path_string ) getPath(), getP() getQuoted() getEscaped() getEscapedQuoted() getJavacEscaped(), getJEscaped() getQuotedJavacEscaped(), getJEscapedQuoted() getEscapedPath() getPerlFileEscaped(), getPerlified() getAnchor() setAnchor(), setAnchor( $full_path_string ) getRelative() getQuotedRelative() isRelative() isAbsolute() getAbsolute() getQuotedAbsolute() CleanPath() Openmake::Snapshot LeftSnapshotOnly($after_snapshot, $before_snapshot) new(), new($directory, $file_extension) get() Openmake::BuildOption new($DebugFlags|$ReleaseFlags) update( $hashref) getBuildTasks getOptionGroups( $build_task) getBuildTaskFiles( $BuildTask, $OptionGroup, $all) getBuildTaskOption( $option_name, $build_task, $option_group) getBuildTaskOptions( $build_task, $option_group) Sample Build Method - The Visual Studio Compiler Section I: Initialization (Lines 1 - 18) Section II: Constructing the Compiler Step (Lines 19 - 34) Section III: Executing and Logging the Step (Lines 35 - 43) Performing Continuous Integration Builds Setup of the Continuous Integration Server Enhancing Your Continuous Integration with Meister Improving Continuous Integration using Build Avoidance Using Continuous Integration Build Scripts Creating and Managing Targets Defining Targets Converting from Ant Build Scripts Adding Targets to Your Project Editing Targets Versioning Targets Copying Targets Target Overview Attributes Target Detail Attributes Target Directories and Project Dependency Directories Wildcards and File Dependencies Matching on * and ? Matching on ** Includes and Excludes Wild Card and Directory Dependencies Defining Targets for Java IDEs and Developer Tools Java Targets Java Targets and Ant Creating a Java War Target Defining J2EE Deployment Descriptor Targets Creating Continuous Integration Build Script for Eclipse Based Targets Defining Targets for the Microsoft Visual Studio and .Net IDEs Guidelines for Using the Microsoft Add-In Creating Continuous Integration Build Scripts for the Microsoft IDE Microsoft Visual Studio 6.x C/C++ Targets Microsoft 6.x Visual Basic Targets Microsoft .NET 2003 Targets Microsoft Visual Studio 2005 Targets Microsoft Visual Studio 2008 Targets Using Meister Activity Plug-ins Generating Build Scripts bldmake options Option -c -f -m -mo -n -o -ob -oh -os -ov -s -v -? Executing Builds om Options -a or clean all -b -c -d -e -f -g -i -j -l -ob -oh -os -ov -ox -o -rp -rc -s -t -w -x -v -? clean <var>=<Var value> OM Debugging Options Release or Debug Standardizing Environment Variables for Your Build Environment Variables Needed for Java Builds Use of multiple JAVA Compilers Modifying the Input or Output File Locations with Ant for Java Builds Errors and Warnings OM WARNING 343: ERROR 9: ERROR 10: ERROR 11: ERROR 11: ERROR 12: ERROR 15: ERROR 19: ERROR 29: ERROR 30: ERROR 37: ERROR 38: ERROR 40: ERROR 43: ERROR 49: ERROR 52: ERROR 53: ERROR 53: ERROR 54: ERROR 55: ERROR 56: ERROR 57: ERROR 58: ERROR 60: ERROR 65: ERROR 70: ERROR 71: ERROR 72: ERROR 73: ERROR 160: ERROR 161: ERROR 400: ERROR 401: ERROR 404: ERROR 404: ERROR 404: ERROR 405: ERROR 406: ERROR 406: ERROR 406: ERROR 408: ERROR 407: ERROR 501: ERROR 538: bldmake WARNING 10: ERROR 11: ERROR 42: ERROR 43: ERROR 44: ERROR 45: ERROR 48: ERROR 49: ERROR 50: ERROR 55: ERROR 56: ERROR 57: ERROR 58: ERROR 58: ERROR 60: ERROR 130: ERROR 131: ERROR 132: ERROR 133: ERROR 134: ERROR 390: ERROR 391: ERROR 392: ERROR 401: ERROR 404: ERROR 404: ERROR 404: ERROR 405: ERROR 406: ERROR 406: ERROR 406: ERROR 407: ERROR 408: omcmdline.jar Using Remote Build Servers Remote Build Server Logs Distributing Builds and Workflows across multiple Remote Build Servers Setting up Workflow Activities to run on Remote Build Servers Running Remote Workflows From the Command Line and External Tools Defining Multi-Platform or Cross Language Builds Managing Users and Groups Groups Default Administrator Group Administrator Group Access Privileges Default User Group User Group Access Privileges Creating Groups Managing Group Privileges Custom Access Privileges Managing Dependency Directory Privilege Managing Build Service Privilege Managing Public Workflow Privileges Managing Users with OM Admin Adding Users Adding or Removing Users from Groups Determining User Group Assignments Users Assigned to Multiple Groups Deleting Users Tracking Users Managing, Adding, and Deleting Users with LDAP Enabling and Modifying LDAP Configurations Using ompw The Management Control Console Executing on Demand Workflows from the Management Control Console Viewing Logs and Reports from the Management Control Console Reports and Logs Client Report Explorer Using the Management Control Console to Review Reports Standard Reports Public and Private Workflow Logs Viewing Reports and Graphs Workflow Summary Workflow Graph Workflow Activity Report Workflow History Report Pubic or Private Bill of Materials Public or Private Build Differences Users by Groups Defined User Privileges Report Build Services Options Dependency Directory Usage by Project Meister Insight Activating Meister Insight Build Audits with Build Forensics Footprinting - Embedding the DNA Impact Analysis with Dependency Discovery OPENMAKE® SOFTWARE LICENSE AGREEMENT