Serena ChangeMan Builder for Professional
Version 6.3.1 Readme File

This file contains information on installing and using the current release of ChangeMan Builder for Professional.

NOTE:


Table of Contents

What's New in ChangeMan Builder for Professional?

System Requirements

Known Issues (All Platforms)

Known Windows Issues

Known UNIX Issues

Known PCLI Issues

Documentation Issues



What's New in Serena ChangeMan Builder for Professional?

New Features

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.

Important Patch Updates

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.

Where to Find Documentation

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.


Requirements

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.

To TOC


Known Issues (All Platforms)

Only Perl 5.6, 5.6.1 Supported

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.

"My Computer" Incorrectly Listed in Integrated Web Client

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.

Install Fails if JAVA_HOME Not Set Properly

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

In Standalone Web Client: Changes to Custom Options Are Not Saved

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.

In Standalone Web Client: Use Mouse to Move Between Fields

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.

In Standalone Web Client: Click on Build Task to Enable Delete Button for Custom Options

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 Standalone Web Client: Cut-and-Paste Not Available From Menus

In the standalone web client, cut-and-paste is not available from the menus, but is available using Ctrl-C and Ctrl-V.

In Standalone Web Client on WinXP: Cut, Copy, and Paste Require JRE 1.4.1_02

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.

For Configuration Builder: Merant CB Build Type Missing

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.

In VM Integration: Set JAVA_HOME at Start of Build Job

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:

Be sure to set JAVA_HOME before the build commands that refer to bldmake and om.

In VM Integration: Delay When Selecting ChangeMan Builder Action

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.

Using Remote Build Server with VM Integration Requires Version Manager

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.

Patch Required for Installing Remote Build Server on Same Machine as Knowledge Base 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 Integrated Web Client: Commands Added to Build Commands Field May Be Truncated

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.

Known Windows Issues

Install Patch for Remote Build Servers

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

Build Log Fails to Display

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:

  1. On the KnowledgeBase server machine, navigate to the following directory:

    <install directory>\ChangeMan\Builder\tomcat\webapps\openmake.ear\openmake.war\logs

  2. Rename any subdirectory found here that is in mixed-case.

Use Sun's JRE, Not jview.exe

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 Standalone Web Client: Footprinting Header Wrong

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.

To TOC


Known UNIX Issues

SuSE: Installation Procedure for SuSE 9.0

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:

  1. Before attempting to install Builder on SuSE 9.0, be sure that the compat libraries are installed.

  2. During the Builder client install, after you enter the hostname and port, the installer shows you a panel with three check boxes:
  3. Select Program Files and Example Files.

  4. Do not select the check box that mentions SuSE 7.3 and 8.0.

  5. Proceed with the rest of the installation.

AIX: Knowledge Base Server or Remote Build Server Cannot Connect to License Server

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:

  1. The Knowledge Base server will have to be restarted, so have users log off.


  2. Locate the startup and shutdown scripts for the Knowledge Base server and for any remote build servers:

    <install directory>/serena/changeman/builder/Start_Knowledge_Base_Server
    <install directory>/serena/changeman/builder/Stop_Knowledge_Base_Server
    <install directory>/serena/changeman/builder/Start_Build_Server
    <install directory>/serena/changeman/builder/Stop_Build_Server

  3. In each case, add the following statements to the startup/shutdown script:

    NSORDER=local,nis,bind,local
    export NSORDER


  4. Restart the Knowledge Base server and any remote build servers.

Solaris: Procedure in Version Manager Readme No Longer Necessary

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.

  1. Open the following file in a text editor:

    <install_location>/vm/solaris/bin/vmprofile

  2. Remove the # character at the beginning of the following line (line 41):

    #Add2LibPath "/apps/pvcs/vm/common/lib/solaris" PRE

  3. Save the file.

  4. Open the following file in a text editor:

    <install_location>/vm/solaris/bin/pvcsvmdmn

  5. Find the following line (line 257):

    LD_LIBRARY_PATH=/usr/lib/lwp:${threadslib}:${jrelibs}:${LD_LIBRARY_PATH}:/usr/lib:/usr/ucblib:/usr/lib/secure

  6. Just after lwp:, add this text to the line:

    ${classroot}/${osDir}:

    So the modified line looks like:

    LD_LIBRARY_PATH=/usr/lib/lwp:${classroot}/${osDir}:${threadslib}:${jrelibs}:${LD_LIBRARY_PATH}:/usr/lib:/usr/ucblib:/usr/lib/secure

  7. Save the file.

You will now be able to run Version Manager in non-setuid mode.

Solaris: Install GNU Footprinting Patch to Avoid Link Failure

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

UNIX and Linux: Change $home to $HOME

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.

To TOC


Known PCLI Issues

Spaces in Build Directory Path Can Cause PCLI Error

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.

Other PCLI Issues Listed in Version Manager Readme

For a list of other PCLI issues in this release, refer to the Version Manager readme.

To TOC


Documentation Issues

Adobe Acrobat Full-Text Search Gives Duplicate Results

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).

Help Does Not Work on Internet Explorer Using Sun's 1.4.0x JRE

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.

Help TOC Does Not Resize in Netscape

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.

Help Navigation Pane Invisible with Sun's JVM

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.


To TOC