This file contains information on installing and using the current release of ChangeMan Builder for Professional.
NOTE:
This release of Serena ChangeMan Builder for Professional includes new features available in the standalone web client.
See the Serena ChangeMan Builder for Professional User's Guide for a further discussion of these features.
This release of Serena ChangeMan Builder for Professional includes several important patches, for both Windows and UNIX platforms. Check the following directory on the installation CD for the latest patches, each of which includes a Readme file:
<CD>\cmnbuilder\patches
For installation instructions in general, see the Serena ChangeMan Builder Installation Guide, and also consult the Installation section of the Serena ChangeMan Builder for Professional User's Guide for installation details specific to Serena ChangeMan Builder as used with Serena ChangeMan Professional.
In addition to the Readme files included with each patch, you can find additional documentation for ChangeMan Builder at the following locations:
If you are upgrading from a Merant Build installation, a section in the Installation chapter of the ChangeMan Builder for Professional User's Guide addresses special issues that you may encounter.
ChangeMan Builder is supported on the following Windows operating systems:
ChangeMan Builder is supported on the following UNIX operating systems:
Notes on Supported Platforms:
Java must be installed before ChangeMan Builder is installed. You must use a compatible Java Runtime Environment and Java Plug-in:
Perl must be installed before ChangeMan Builder is installed. ChangeMan Builder supports Perl 5.6.0 and 5.6.1. (ActivePerl from ActiveState recommended.)
Not including the disk space required for Java and Perl, the recommended amounts of disk space and RAM are:
UNIX and Windows | |||
---|---|---|---|
Disk Space | Memory | ||
Knowledge Base Server | 100 MB | 512 MB | |
Standalone Web Client | 5 MB | 50 MB | |
Command-line Client | 50 MB | 64 MB | |
Remote Build Server | 130 MB | 512 MB |
Web browsers supported are:
For all servers, you must have administrative security access to the hardware.
For the command-line client, you must have permission to create directories and files.
Serena ChangeMan Builder has been tested with Perl 5.6 and 5.6.1, but not with Perl 5.8. ChangeMan Builder is not guaranteed to work with Perl 5.8.
On all platforms, the integrated web client displays a list of build machines that includes "My Computer". This is incorrect. Local builds are not available from the integrated web client. You should not select "My Computer" as a build machine from the integrated web client.
On all platforms, you must install Java and set the JAVA_HOME environment variable before attempting to install ChangeMan Builder.
If you have multiple Java installations on your machine, you can run the installer from the command line and specify a particular Java directory to use:
install.exe LAX_VM <java_path>\java.exe
If you make a change to a custom option, the change may not get saved unless you also make a change to a dependency. As a workaround, you can define a new dependency, then delete it, and then save the build job. The changes to custom options will then be saved.
When defining custom options, use the mouse to move between fields. The TAB key is not enabled for this page. This will be fixed in a subsequent release.
If you wish to delete a custom option and the Delete button is not enabled, click on the name of the associated build task first. This will enable the button.
In the standalone web client, cut-and-paste is not available from the menus, but is available using Ctrl-C and Ctrl-V.
If you are running on Windows XP, you must have version 1.4.1_02 or later of Sun's JRE, or the Clipboard functions will not work in the standalone web client.
The Merant CB build type needed to use ChangeMan Builder with Merant Configuration Builder was inadvertently left out of the release. The build type has been included in the Patches directory on the install CD. See the Readme that accompanies the patch for installation instructions.
If you are running a build job from within the Version Manager integration, you should add instructions to the beginning of each Java build job to set the value of JAVA_HOME. (On UNIX, you must also export the value of the variable.)
You should do this because Version Manager installs its own Java runtime environment (JRE 1.4.1_05), and sets JAVA_HOME to point there. If your work depends on a particular JRE version, you can guarantee the usage of that version by setting this variable.
To set the value of JAVA_HOME in a build job, edit the Build Commands field on the Submission dialog box. For example:
Windows: set JAVA_HOME=<location of JRE>
UNIX: set JAVA_HOME=<location of JRE>;export JAVA_HOME
Be sure to set JAVA_HOME before the build commands that refer to bldmake and om.
When you select Build from the Actions menu (or from the context menu or toolbar), there is a delay while ChangeMan Builder loads the initial dialog box.
If you are using the version of Serena ChangeMan Builder that is integrated with Version Manager, any remote build server that you define must also use the Version Manager integration. This means that the remote build server machine must have Version Manager installed on it.
On the remote build server machine, run the regular local install for Version Manager, and select only Desktop Client for the installation. This will install PCLI and the Version Manager integration.
Note also that the Version Manager instance installed on the remote build server must have a named license. This license will be included when you purchase the Serena ChangeMan Builder remote build server license. This Version Manager named license must be assigned to the user ID that is used for the Serena ChangeMan Builder remote build server.
NOTE Serena does not recommend this procedure, as it can cause the Knowledge Base server (KB server) to run less efficiently than it would otherwise. However, the procedure will work and is preferred by some customers who have only one build machine.
On all platforms, if you wish to install a remote build server on the same machine that contains the Knowledge Base server, you must install the InstallRBSonKBS patch.
See the instructions included with the patch, on the install CD:
<CD>\cmnbuilder\patches\InstallRBSonKBS
In the integrated web client, ChangeMan Builder may incorrectly parse the contents of the Build Commands field, if you have added commands to it. Specifically, if you add a string containing "om" (lower-case only), Builder may incorrectly interpret this as part of the om command. You may see truncated commands as a result, and the build job may fail to execute.
If the offending string is part of a directory path, you can try using a different directory path as a workaround.
On Windows remote build servers only, you must install the RBS_Licensing patch in order to resolve a problem with consuming remote build server licenses. This patch should be applied only to a remote build server.
See the instructions included with the patch, on the install CD:
<CD>\cmnbuilder\patches\RBS_Licensing
Normally, after a build job is executed, a build log appears in a browser window. If the user who requests the build has logged in originally with a mixed-case user ID, the build log may not display.
To solve this problem:
<install directory>\ChangeMan\Builder\tomcat\webapps\openmake.ear\openmake.war\logs
During the installation of the Serena ChangeMan Builder Knowledge Base server, you are asked to select a Java runtime executable. In the dialog provided for selecting this item, you may see jview.exe selected by default, but you should NOT select jview.exe. If you do, the install of a needed Serena ChangeMan Builder service (the "Openmake" service) may fail. Instead, use the Search button on the dialog to locate the Sun JRE executable. You should have previously installed version 1.4.1_02 or later of the Sun JRE.
In the standalone web client, the footprinting feature displays a header referring to Dimensions. This is incorrect and will be fixed in the next release.
The ChangeMan Builder installer does not specifically call out SuSE 9.0, but you can still install the ChangeMan Builder client on that platform.
To install ChangeMan Builder on SuSE 9.0:
On AIX, a KnowledgeBase Server or Remote Build Server may fail to connect to the License Server. When this happens, you will see an "unknown host" error.
The solution is to add a value for the NSORDER variable in the startup and shutdown scripts for the servers:
Because Serena ChangeMan Builder offers an integration with Version Manager, the Version Manager Readme describes a procedure addressing an issue with the Serena ChangeMan Builder integration on Solaris. This procedure appears in the Version Manager Readme under the title "Serena ChangeMan Builder Integration on Solaris".
However, this procedure is now unnecessary, because of a patch included on this CD (and described in a subsequent section).
If you have already performed the steps described in the Version Manager Readme procedure, Serena ChangeMan Builder will still work. However, if you wish to use Version Manager in non-setuid mode, you should perform the following steps to reverse the procedure described in the Version Manager Readme.
You will now be able to run Version Manager in non-setuid mode.
On Solaris, build jobs may fail with a link error. The GNU_Footprinting patch addresses this problem.
See the instructions included with the patch, on the install CD:
<CD>\cmnbuilder\patches\GNU_Footprinting
On UNIX and Linux, the default Bulid Directory value in the Version Manager integration is $home/Builder. The $home environment variable needs to be $HOME.
You can change the $home environment variable in the Build Parameters dialog.
On UNIX platforms, a build directory path that contains a space can cause a PCLI error.
This can occur in two ways:
In the first case, you will see a message
indicating that the directory does not exist, or that the
specified substitution is not valid for the command.
For example:
/usr/serena/vm/solaris/bin/pvcsvmdmn: /home/pvcs/my: does not exist
In the second case, you will see a message indicating that the bldmake VM integration completed with errors, and then a message indicating that the PCLI command banner could not be found.
To fix either instance of this problem, modify the pvcsvmdmn script identified in the error message by changing the line:
cd ${EXEDIR}
to
cd "${EXEDIR}"
This will resolve the problem.
For a list of other PCLI issues in this release, refer to the Version Manager readme.
Adobe Acrobat may remember the last index that was used for a full-text search. This can cause Acrobat to search the index of the current document and of a previous document, resulting in duplication of search results. To avoid this, make sure that only the index for the current document is selected (see the install guide for details on selecting a search index).
The Version Manager help, which includes ChangeMan Builder help topics, will not launch on Internet Explorer if IE is using Sun's 1.4.0x JRE. Use 1.3x or 1.4.1x instead.
If you resize the Netscape browser window, the TOC pane of the help may not resize correctly. To reload the TOC into the resized pane, click the Hide Navigation link, then click the Show Navigation link.
When viewing the online help on Windows XP using Microsoft IE 6.0 with Sun's JVM, the navigation pane in the online help comes up blank. You can work around this by disabling Sun's VM and using the Microsoft VM to view the help.