CA Software Change Manager 521 Readme - CA Technologies
{{search ? 'Close':'Search'}}

CA Software Change Manager 5.2.1

Last Updated: May 19, 2004

1.0 Welcome

2.0 Operating System Support
2.1 Windows
2.2 UNIX
2.3 Linux
2.4 z/OS

3.0 System Requirements
3.1 Windows
3.2 UNIX and Linux
3.3 SuSE Linux s/390
3.4 z/OS
3.5 WebSphere Studio Integration (WSAD Integration)
3.6 TestDirector Integration
3.7 Version Control Integration (VCI)

4.0 Installation Considerations

5.0 General Considerations

6.0 Known Issues
6.1 Access Control
6.2 Agent Modes
6.3 Check In and Check Out
6.4 Command Line
6.5 Form Management
6.6 Graphical User Interface
6.7 Harweb
6.8 Installation
6.9 Illegal Characters
6.10 Linux
6.11 Password Policy
6.12 Security Concerns
6.13 Version Control Interface (VCI)
6.14 WebSphere Studio Integration (WSAD Integration)

7.0 Language Certifications

8.0 Contacting Technical Support


1.0 Welcome

Welcome to AllFusion Harvest Change Manager 5.2.1 (hereafter called Harvest). This readme file contains installation considerations, operating system support, known issues, and instructions for contacting Computer Associates Technical Support.

This readme covers all standard and optional components for Harvest 5.2.1:

  • The Harvest server, client, and agent

  • The Harvest SDK components: the Harvest SDK (HSDK), the Java Harvest SDK (JHSDK), and the Component Object Model SDK (COM SDK). In previous Harvest releases, SDK components were sold separately.

  • CA Software Change Manager Web Interface (hereafter called Harweb)

  • CA Software Change Manager WebSphere Studio Integration (hereafter called WebSphere Studio Integration) also called WSAD Integration

  • CA Software Change Manager TestDirector Integration (hereafter called TestDirector Integration)

  • CA Software Change Manager Version Control Interface (hereafter called VCI)

    Note: For information about CA Software Change Manager Custom Reports, see the readme file (readme_samplereports.html or readme_samplereports.txt) on the AllFusion Change Manager 5.2.1 Custom Reports CD.


    2.0 Operating System Support

    This section lists the operating systems supported by Harvest 5.2.1 components. Computer Associates supports these operating systems for the duration of their life cycle (as determined by their manufacturer) or until Computer Associates announces that we are dropping support. For the latest information about supported operating systems, see our web site, https://support.ca.com.


    2.1 Windows

    This section lists the Windows operating systems supported by Harvest 5.2.1 components.

    The Harvest server, Harvest client, Harweb, WebSphere Studio Integration (WSAD Integration), Version Control Interface (VCI), and TestDirector Client require one of the following operating systems:

  • Windows 2000 Server

  • Windows 2000 Advanced Server

  • Windows Server 2003 Enterprise

  • Windows XP Professional

    TestDirector server requires one of the following:

  • Windows 2000 Server

  • Windows Server 2003 Enterprise

    Harweb requires an operating system that supports one of the following web browsers:

  • Microsoft Internet Explorer 5.5 or 6.0

  • Mozilla 1.4


    2.2 UNIX

    This section lists the UNIX operating systems supported by Harvest 5.2.1 components.

    The Harvest server on UNIX requires one of the following:

  • Sun Solaris 2.7, 2.8, or 2.9

  • HP-UX 11.00 or 11.11 (11i)

  • IBM AIX 4.3.3, 5.1, or 5.2

    Harweb on UNIX requires one of the following:

  • Sun Solaris 2.7, 2.8, or 2.9

  • IBM AIX 4.3.3, 5.1, or 5.2

  • HP-UX 11.00 or 11.11

    The HSDK on Sun Solaris runs on Solaris 2.6, 2.7, or 2.8 systems.

    Note: If you are using Solaris 2.8 and the Sun Workshop compiler 5 and Forte 6, you must do the following:

  • Set the flag -compat=4 in the compile stream.

  • In the cacheckin.h and cacheckout.h files, you must replace the following statement:
     #if defined(__hpux) 

    with this statement:
     #if defined(__hpux) || ( __SUNPRO_CC >= 0x500 ) 

    The HSDK on AIX requires AIX 4.3.3 and IBM CXX compiler 3.6.6.

    The HSDK on HP-UX requires HP-UX 11.00 and HP aCC compiler A.03.25 or higher.


    2.3 Linux

    This section lists the Linux operating systems supported by Harvest 5.2.1 components.

    The Harvest server on Linux requires one of the following:

  • Red Hat Advanced Server 3.0. To work properly with Harvest, Red Hat Advanced Server 3.0 requires that you install the latest applicable ODBC311 patch available from Computer Associates Technical Support at https://support.ca.com.

  • Red Hat Linux AS 3.0

  • SuSe SLES-7.0 (s390)

    On UNIX and Linux, the Harvest command line utilities serve as the Harvest clients. The Harvest command line utilities require one of the operating systems listed above for the Harvest server.

    Harweb on Linux requires Red Hat Linux AS 3.0

    The HSDK requires Red Hat Linux AS 3.0


    2.4 z/OS

    At publication time, the Harvest 5.2.1 components for z/OS (the MVS agent and the USS agent) are not available. As soon as these components are completed, their installation requirements and other related information will be posted on https://support.ca.com.


    3.0 System Requirements

    This section describes the system requirements for the Harvest components supported on each operating system.


    3.1 Windows

    This section describes the system requirements for the Harvest components on Windows.

    Server

    The Harvest server on Windows requires the following hardware and software:

  • An Intel Pentium processor (Pentium III recommended).

  • 110 MB of disk space for temporary use during the installation process.

  • At least 70 MB of disk space for the Harvest product files.

  • Approximately 210 MB of disk space for the Oracle tablespaces.

  • The Harvest tablespaces require a minimum 150 MB of disk space (50 MB each for HarvestMeta, HarvestIndex, and HarvestBlob). This is the installation default. You may need to increase the size of the tablespaces based on your estimates, as follows: HarvestIndex tablespace requires approximately 600 KB and HarvestMeta tablespace requires approximately 100 KB per 1000 versions checked in. Harvest BLOB size depends directly on file size.

  • At least 128 MB of RAM. Each Harvest server process requires 15 MB of RAM.

  • Oracle 8.1.7, 9.0.1 EE, 9.2.0 EE, or 9.2.0 SE.

  • If you want to install the Harvest server with a remote database, you must do the following:

  • Ensure that the Harvest server has Oracle Server or Client Administrator installed.

  • Define an Oracle service name on the local machine, using an Oracle utility provided by the Oracle Server or Client Administrator.

    Client, Installed Locally, Not Shared

    When the Harvest client on Windows is installed locally and is not shared, it requires the following hardware and software:

  • An Intel Pentium processor (Pentium III recommended).

  • At least 60 MB of disk space for the Harvest product files.

  • At least 128 MB of RAM.

  • Network connection to a UNIX or Windows Harvest server using the TCP/IP protocol.

  • 110 MB of disk space for temporary use during the installation process.

    HSDK

    On Windows, the HSDK is installed automatically whenever you install any Harvest component, except Database and Documentation, from the Harvest product CD on a supported Windows platform. Therefore, if you meet the installation requirements for any of those components, you also meet the installation requirements for the HSDK.

    Harweb

    Harweb requires 65 MB of disk space.

    Harweb requires one of the following servlet engines. For instructions to install each of these servlet engines, see the Technical Notes in the Technotes directory on the Harweb installation CD.

  • Apache Tomcat 4.0.6 to 4.1.24. Tomcat is available for free. For details, see the Apache web site, http://jakarta.apache.org.

    At publication time, the following restriction exists: If you are using Harweb hosted in IBM WebSphere Studio and you require Tomcat, you must use Tomcat 4.0.6. For any updates to this restriction that may occur after publication, see Computer Associates Technical Support at https://support.ca.com.

  • Sun One Web Server Enterprise Edition 6.0 or 6.1. These editions are fully J2EE-compliant. These editions provide web server and servlet support for Harweb. For details, see the Sun web site, http://www.sun.com.

    At publication time, Harweb does not support the following servlet engines. As soon as Harweb supports these servlet engines, installation requirements and related information will be posted on https://support.ca.com.

  • IBM WebSphere Application Server 5.0 or 5.1

  • Macromedia JRun 3.1

    The Harweb machine requires the following to be installed locally:

  • The Harvest client

  • Java 2 SDK Standard Edition (J2SE) 1.3.1 or 1.4

    Harweb requires one of the following web browsers:

  • Microsoft Internet Explorer 5.5 or 6.0

  • Mozilla 1.4


    3.2 UNIX and Linux

    This section describes the system requirements for the Harvest components on UNIX and Linux.

    All Clients

    On UNIX and Linux, the Harvest command line utilities serve as the Harvest clients. The Harvest client (command line utility) requires 15 MB of disk space.

    All Servers

    The Harvest server requires the following hardware and software requirements on all supported UNIX and Linux operating systems. In addition to these requirements, you must meet the specific requirements for your operating system—those requirements are listed later in this section.

  • A minimum 128 MB of main memory.

  • 15 MB of virtual memory for each Harvest server process.

  • Oracle 8.1.7, 9.0.1 EE, 9.2.0 EE, or 9.2.0 SE.

  • If the Oracle database resides on a different machine than the Harvest server, SQL*Net is required.

  • Approximately 210 MB for the Oracle tablespaces.

    Note: The Harvest installation includes the following Computer Associates shared components: CA Licensing (Lic98), CAI/PT ODBC, Enterprise Communicator (PEC), and Computer Associates Cryptographic Engine (CACE). A root user account is required to install CA Licensing (Lic98). The other Computer Associates shared components can be installed to a user-specified location, which may not require a root account.

    Sun Solaris Servers

    The Harvest server on Sun Solaris requires approximately 100 MB of disk space for the Harvest product files, Lic98, CACE, PEC, and CAI/PT ODBC.

    IBM AIX Servers

    The Harvest server on IBM AIX requires approximately 200 MB of disk space for the Harvest product files, Lic98, CACE, PEC, and CAI/PT ODBC.

    HP-UX Servers

    The Harvest server on HP-UX requires approximately 200 MB of disk space for the Harvest product files, Lic98, CACE, PEC, and CAI/PT ODBC.

    Linux for x86 Servers

    The Harvest server on Linux for x86 requires approximately 150 MB of disk space for the Harvest product files, Lic98, CACE, PEC, and CAI/PT ODBC.

    The UNIX installation program for Linux is designed for the bash shell, not the ksh shell. If your site has installed the ksh shell and linked it to /bin/sh, you must modify the installation scripts (any files which end with .sh or .SH) to specify the new location of the bash shell, such as /bin/bash.

    Harweb

    Harweb requires 60 MB of disk space.

    Harweb requires one of the following servlet engines. For instructions to install Harweb and each of these servlet engines, see the Technical Notes in the Technotes directory on the Harweb installation CD.

  • Macromedia JRun 3.1. This servlet and JSP engine can be plugged into a commercial web server such as Apache or Sun One Web Server. For further information, see the Macromedia web site, http://macromedia.com.

  • Apache Tomcat 4.0.6 to 4.1.24. Tomcat is available for free. For details, see the Apache web site, http://jakarta.apache.org.

    At publication time, Harweb does not support the following servlet engines. As soon as Harweb supports these servlet engines, installation requirements and related information will be posted on https://support.ca.com.

  • IBM WebSphere Application Server 5.0 or 5.1

  • Macromedia JRun 3.1

    The Harweb machine requires the following to be installed locally:

  • The Harvest client (command line utility)

  • Java 2 SDK Standard Edition (J2SE) 1.3.1 or 1.4

  • Mozilla 1.4 web browser


    3.3 SuSE Linux s/390

    Agent

    The Harvest agent on SuSE Linux s/390 requires the following hardware and software:

  • SuSe SLES-7.0 (s390)

  • Approximately 45 MB of disk space for the Harvest product files and CA Cryptographic Engine (CACE)

    Client

    The Harvest client (command line utility) requires 30 MB of disk space.


    3.4 z/OS

    At publication time, the Harvest 5.2.1 components for z/OS (the MVS agent and the USS agent) are not available. As soon as these components are completed, their installation requirements and other related information will be posted on https://support.ca.com.


    3.5 WebSphere Studio Integration (WSAD Integration)

    Before you install WebSphere Studio Integration (WSAD Integration), ensure that one of the following is installed:

  • IBM WebSphere Studio Application Developer 5.0 or 5.1.x Enterprise Edition

  • IBM WebSphere Studio Application Developer 5.0 Integration Edition

  • IBM WebSphere Studio Site Developer 5.0 or 5.1.x Enterprise Edition

  • IBM Eclipse 2.1.2

    To operate correctly, WebSphere Studio Integration requires that the Harvest client is installed locally and has access to Harweb.

    WebSphere Studio Integration 5.1 is supplied on the Harvest 5.2.1 installation CD. WebSphere Studio Integration 5.1 supports both IBM WebSphere Studio 5.0 and IBM WebSphere Studio 5.1. WebSphere Studio Integration 5.1 requires that one of these versions of IBM WebSphere Studio is already installed on your machine. The WebSphere Studio Integration 5.1 installation is specially customized to match the version of IBM WebSphere Studio already installed.

    Therefore, if you are using IBM WebSphere Studio 5.0 and you want to upgrade to IBM WebSphere Studio 5.1, you must perform that upgrade before you install WebSphere Studio Integration 5.1. Otherwise, you must uninstall and reinstall WebSphere Studio Integration 5.1 after you upgrade to IBM WebSphere Studio 5.1.

    After installing WebSphere Studio Integration 5.1, you must recreate your workspace.


    3.6 TestDirector Integration

    Before installing TestDirector Integration, ensure that the following components are installed:

  • The Harvest TestDirector Integration option must be installed on the Mercury TestDirector server machine. The third party prep plug-in must be installed and enabled; for details, see the Mercury TestDirector Version Control Add-in Guide.

  • Mercury TestDirector 7.6 SP3 with third party version control plug-in build number 7.6.2.500.

  • TestDirector 8.0 with third party version control plug-in.

  • The TestDirector Integration third party prep plug-in and the Harvest integration require the Java JRE 1.4.0 or greater. When using TestDirector or Harvest TestDirector Integration, you must have the Java JRE active in the path prior to installation.


    3.7 Version Control Integration (VCI)

    Before installing Version Control Integration (VCI), ensure that the following components are installed:

  • IBM VisualAge 3.5.3 or 4.0

    The versions require an external version control patch from IBM.

  • One of the following certified tools for supporting the Microsoft Common Source Code Control (SCC) Interface:

  • Visual C++ 6.0 Enterprise Edition

  • Visual Basic 6.0 Enterprise Edition

    Note: In order for Visual Basic to work, you must install Visual Source Safe (VSS) because Visual Basic is not a native SCC client. Microsoft does not configure Visual Basic for SCC by default. When you install Visual Basic and choose to install Source Safe, Microsoft creates a vb.ini file in your c:winntsystem32 directory. This file sets a flag to support SCC. This configuration is specific to Visual Basic but not to Harvest. For instructions to enable SCC capabilities in Visual Basic, see the SCC help in Visual Basic.

  • Visual Studio .NET Framework 1.0

  • Visual Studio .NET 2003 Framework 1.1

  • Sybase PowerBuilder 8.0.3 and 9.0

  • Visual Cafe 4.5.1 Enterprise Edition

  • Rational Rose 2001a.04.00

  • TogetherSoft (formerly WebGain) Visual Café Enterprise Edition 4.5.1

    Before using the VCI, complete the setup tasks in the Version Control Interface User Guide.


    4.0 Installation Considerations

    For instructions to install Harvest 5.2.1, see the Harvest Install Guide in the Doc directory on the Harvest installation CD.

    On Windows computers, the Harvest installation may display Internal Error 2343 and abort. The most likely cause of this error is that a version of Harvest earlier than 5.2.1 is already installed. Uninstall the earlier version, using the Add/Remove Programs option from the Windows Control Panel. Then try installing Harvest 5.2.1 again.

    The custom installation for the Harvest client includes options to install WebSphere Studio Integration, TestDirector Integration, and WebSphere Studio Integration (WSAD Integration); however, the Harvest installation program enables only the option or options that apply to your site.

    The operating system requirements for the Harvest components on all platforms include the requirements for the applicable Computer Associates shared components such as Enterprise Communicator (PEC), CA Licensing (Lic98), Computer Associates Cryptographic Engine (CACE), and CAI/PT ODBC.

    While installing Harvest on Linux systems, if you are using Linux Red Hat 9, you must set the environment variable LD_ASSUME_KERNEL=2.4.1. If you do not set this variable, the Harvest executable files will not start. For instructions, see the Harvest Install Guide.

    On UNIX and Linux, if you are re-installing Harvest 5.2.1, to keep the existing Harvest 5.2.1 database created by the first installation, you must use installation option [2] - Upgrade Harvest. If you select option 2, you are prompted to enter the Oracle user name that owns Harvest tables. If you enter the name of the existing database user at this prompt, the installation program proceeds successfully.

    On UNIX and Linux, log on as the harvest user (not the root user) to install the Computer Associates Cryptographic Engine (CACE). For details, see the Installation section of the Known Issues in this readme file.

    Harweb

    Harweb is a standard component of Harvest 5.2.1. Harweb is supplied on its own CD, separate from the Harvest installation CD. There is one Harvest CD-ROM for Windows and another for UNIX. For instructions to install Harweb, see the following documents:

  • The CA Software Change Manager Web Interface Install Guide in the Doc directory on the Harweb CD-ROM.

  • The Technical Notes in the Technotes directory on the Harweb installation CD. Each technical note provides instructions on installing Harweb on a specific web server.

    Harweb uses the Harvest server's database and requires a remote Harvest agent machine.

    WebSphere Studio Integration (WSAD Integration)

    WebSphere Studio Integration (WSAD Integration) is an optional component of Harvest client installation. For instructions to install WebSphere Studio Integration, see the Harvest Install Guide in the Doc directory on the Harvest installation CD.

    For other important installation considerations, see WebSphere Studio Integration (WSAD Integration) in System Requirements in this readme file.

    TestDirector Integration

    Mercury TestDirector Integration is an optional component on the Harvest 5.2.1 client custom installation. For instructions to install TestDirector Integration, see the Harvest Install Guide in the Doc directory on the Harvest installation CD.

    WARNING! If the Harvest client on the TestDirector server machine is uninstalled and reinstalled in another location after TestDirector data has been checked in to the Harvest repository, the TestDirector interface will be unable to check out the files, because of the change of location of the file htdvcElement.dtd. If the Harvest installation is moved, a copy of htdvcElement.dtd must remain in its original location.


    5.0 General Considerations

    For a list and brief description of new and changed features supplied by Harvest 5.2.1, see the Harvest Release Summary in the Doc directory on the Harvest installation CD.

    The Harvest 5.x HSDK replaces the Harvest SIK supplied with Harvest 4.x and earlier versions. The Harvest SIK was a C language interface to a subset of the Harvest capabilities. The HSDK is a C++ class set for the same functionality. SIK functionality can be reprogrammed using the HSDK but is not directly compatible with the HSDK.


    6.0 Known Issues

    This section lists the most prominent known issues for Harvest 5.2.1 at publication time. For other known issues, see Computer Associates Technical Support at https://support.ca.com.


    6.1 Access Control

    PR2910: A User Group that does not have View access to an item path can modify the item path through command line utility check in process (hci).


    6.2 Agent Modes

    PR2911: A user cannot start multiple single-user agents on the same machine connecting to different Harvest brokers (rtservers) on a z/OS machine with SuSE Linux 7.0 installed.


    6.3 Check In and Check Out

    PR2912: Generally, two Harvest users can share the same project files; that is, the users can both have the same files checked out simultaneously, and their changes can be merged when both files are checked in again. This ability to share files does not apply to Sybase PowerBuilder project files.

    PR2913: On Windows, if you check in or check out files using HarWind (the Harvest Shell Extension) after you install the Harvest client, you may receive error messages similar to the following, even if the files are actually checked in or checked out properly:
     E3080003: Requested Message Key Not Found: : HSRV_I_CHECKIN  E3080003: Requested Message Key Not Found: : HAPI_I_EXECUTE_SUCCESS  E3080003: Requested Message Key Not Found: : HSRV_I_CHECKOUT E3080003: Requested Message Key Not Found: : HSRV_I_CHECKOUT 

    To fix this problem on Windows 2000, restart the computer.

    To fix this problem on Windows XP, close and restart all Windows Explorer sessions.

    PR2988: If you are using Harvest with any supported IDE, such as PowerBuilder, and you check out a project, you will not be able to see files added to that project by other users until the next time you check in the project. Therefore, we recommend that you check out projects for brief time periods only and that you check in projects as frequently as possible.


    6.4 Command Line

    PR2914: The project restore command line utility named hrt requires a remote file agent connection on the machine where the project was archived. For example, to restore a project to Harvest from machine A, a remote file agent must be running on machine A. Use the following syntax for hrt:
     hrt -b <broker> -f <archive file> -m <machine> -musr <user> -mpw <password>     -user <harvest user> -pw <harvest pw> 


    6.5 Form Management

    PR2915: To use the database combo control in Harweb, the SQL query must include the object ID. For example, the following is a simple query on the Harvest username:
     select usrobjid, username from haruser 

    The object ID does not appear in the combo control list.


    6.6 Graphical User Interface

    PR2916: The function for copying multiple Lifecycle processes in the Harvest Administrator from one state to another does not work. You must copy each process individually.

    PR2917: In the Administrator interface, the Add and Delete buttons are disabled on the Access tab of the linked process properties dialogs, because access to a linked process is controlled by its parent process. A user group granted access to execute a process has implicit access to execute the linked processes.

    PR2918: The remove item process is slow. For example, removing approximately 25 items requires approximately one minute. The efficiency of the removal decreases as the number of items to be removed increases. Also, after each item is deleted, certain pre-link and post-link UDPs are executed automatically. Consequently, pre-link and post-link UDPs are practically unusable for the remove item process.

    PR2919: The promote process may be very slow if you promote a large number of packages (for example, 200) with Verify Package Dependencies and Enable Package Merge selected.

    PR2920: In the Workbench Check Out dialog, the following problems may occur:

  • Making a selection from the file browser changes the setting for the Context View Path, even if Use Context View Path is checked.

  • Clearing the Use Client View Path check box also changes the Context View Path, even if Use Context View Path is checked.

  • The Client View Path may be changed when you browse files if Use Context View Path is not checked or if Use Client View Path is checked.


    6.7 Harweb

    These issues apply to the General Web Client.

    PR2921: The compare view process does not allow a user to select an alternate view name (other than the default Working View) unless the Public user group is granted Use access to the project. The View Chooser says No View. To work around this problem, add the Public user group to the Use access method for the Harvest project in the context.

    PR2922: The create package process does not format the package name correctly if the package name includes one or more double quotation marks ("). If you specify a package name that includes a double quotation mark, Harvest assigns the default package name instead of the name you specified.

    PR2923: The create package process does not display the associated form if the package name contains one or more single quotation marks ('). If you specify a package name that includes a single quotation mark, Harvest issues a Confirmation Message and closes the form. To display the form, open the Package Properties dialog and use the Forms tab to locate the form.

    PR2924: In Harweb, you cannot use a hyphen (-) as the first character of a package name. If you attempt to name a new package or rename an existing package with a hyphen (-) as the first character, the attempt fails.

    PR2925: Harweb users cannot check out all files in the repository by specifying only the root path as the path name for the files to be checked out. Thus, if the default view path—the root path ()—is set as the View Path Anchor, Harweb users cannot check out the versions displayed when they execute Find Version.

    PR2926: If you are using Harweb hosted in IBM WebSphere Studio and you require Tomcat, you must use Tomcat 4.0.6. For details, see System Requirements earlier in this readme file.


    6.8 Installation

    PR2927: The Harvest server does not support fully qualified host names, for example name.domain.com or name1.name2.domain.com. If the host name is fully qualified, the Harvest server fails to start. To work around this problem, follow these steps:

  • Define a host name alias as name or name1 for the fully qualified host name.

  • Define an environment variable, $RT_FORCE_NODE_NAME on UNIX or a system variable RT_FORCE_NODE_NAME on Windows and set it to the alias defined in step 1 above.

  • Restart the Harvest broker and RTserver if they are already running.

    PR2928: The Computer Associates shared components required by Harvest are CA Licensing (Lic98), CA Cryptographic Engine (CACE), CAI/PT ODBC, and Enterprise Communicator (PEC). Generally, on Windows, Computer Associates products install each of these components in the Program FilesCA directory.

    PR2929: On the s/390 machine running SuSE Linux 7.0, the command line utilities-only installation does not prompt you to enter the location of RTHOME; however, the installation completes successfully. The command line utilities-only installation includes the PEC library files.

    PR2930: On UNIX and Linux, if you are re-installing Harvest 5.2.1, to keep the existing Harvest 5.2.1 database created by the first installation, you must use installation option [2] - Upgrade Harvest. For details, see Installation Considerations.

    PR2989: When installing the Harvest server on Windows, use the Oracle SYSTEM account (or another account with the required DBA privileges). If you use the Oracle SYS account, the installation program may "hang" (stop but not close) without displaying error messages. If you experience this problem, use the Windows Task Manager to close the installation program. Then run the installation program again, using the Oracle SYSTEM account.

    PR2990: In the chapter "Installing on UNIX and Linux," the Harvest Install Guide incorrectly states that you must log on to UNIX or Linux as the root user to install the Computer Associates Cryptographic Engine (CACE). You can install CACE on UNIX or Linux under a non-root account. The Harvest 5.2.1 CACE installation accepts an installation path directory argument.

    PR2991: On the Harvest 5.2.1 Installation CD, the cmdonly folder contains a subfolder for Enterprise Communicator (PEC) 4.5 on s/390. This subfolder is not necessary, because the Harvest command-line-utilities-only installation on z/OS includes the PEC files with the Harvest library files. Therefore, you can ignore this subfolder.


    6.9 Illegal Characters

    PR2931: On Windows, a load repository command fails with the following error message if the repository name includes a forward slash (/) or backward slash ():
     Harvest Output: "E03020151: Error: Invalid View Path:   " 

    Therefore, ensure that the Harvest repository name includes no forward or backward slashes.

    PR2932: If you rename a checked-in item to include illegal Harvest characters and then attempt to check out the new version, the check out attempt fails with the following error message:
     Harvest Output: "E03020028: File Agent error for item : Permission denied." 

    On Windows, the following characters are illegal and therefore cannot be used in Harvest file names:

  • quotation mark (")

  • forward slash (/), backward slash (), or vertical separator (|)

  • colon (:)

  • asterisk (*)

  • question mark (?)

  • carets (< >)

    On UNIX and Linux, the forward slash (/) is illegal and may not be used in Harvest file names.

    PR2933: If you are using international character codes and a 5c character code is the last character of the path name of the Harvest repository, then any attempt to load the repository fails. Similarly, a check in or check out attempt fails if a 5c code character is the last character of the path name of the directory specified in the check in or check out.


    6.10 Linux

    PR2934: If you are installing Harvest on Linux Red Hat 9, you must set the environment variable LD_ASSUME_KERNEL=2.4.1 after the installation. For details, see Installation Considerations earlier in this readme file.


    6.11 Password Policy

    PR2935: When AllowUsernameAsPassword = false, a password can be the user's name if the case of one or more letters is different. For example, user rabbit can create password RABBIT, Rabbit, raBBit, and so on. Validation fails only on password rabbit.

    PR2936: A user with a # character at the beginning of the user name (for example, #uno) cannot receive a user override using hppolset because # denotes a comment in the password policy configuration file.


    6.12 Security Concerns

    PR2937: Installing the Harvest components requires only system user access (the system user named harvest). However, installing the required Computer Associates shared components for the first time requires root user access. The Computer Associates shared components required by Harvest are CA Licensing (Lic98), CA Cryptographic Engine (CACE), CAI/PT ODBC, and Enterprise Communicator (PEC).


    6.13 Version Control Interface (VCI)

    PR2938: When you are using Harvest with the Version Control Interface (VCI) on Windows 2003 or Windows .NET, setting the Check out Automatically option of the Tools, Options dialog does not check out files automatically. Use the following steps as a work around:

  • Open the Options dialog.

  • Select the Check out automatically option.

  • Ensure that this option is not selected: allow checked in items to be edited.

  • In your Harvest project, remove all check out processes except check out for update.

  • Open the Checkout Properties dialog and ensure that Update is the only mode enabled.

    After you have completed these steps, if you edit a checked in file, the file is checked out automatically without invoking any dialog.

    PR2939: When checking out files using Version Control Interface with Visual Studio 6.x or Visual Studio .NET, you may use the Synchronize or Browse checkout option from the Advanced Checkout dialog. Synchronize synchronizes the project in Harvest with the versions on the local file system. Browse replaces the files on the local file system with the latest versions from Harvest. Both operations will complete successfully in Harvest. Afterwards, the files remain checked in and read-only. However, both operations appear to fail because Visual Studio displays an error message. This error message is displayed because Visual Studio does not support these features.


    6.14 WebSphere Studio Integration (WSAD Integration)

    PR2998: If you open a resource in the Navigator by right-clicking and selecting Open in New Window, then both windows are closed when close the new window.

    PR2999: WebSphere Studio Integration does not support refactoring of folders.

    PR3000: The user interface sometimes becomes unstable when you are using package lists, version lists, or item lists that contain more than 5000 list items. To avoid this problem, close the Harvest list view when you are working with extremely large projects or lists.

    PR2940: While working in the Workspace, suppose you close a project and disconnect from the Harvest repository. If you then open the same project and attempt to synchronize, you may receive a message similar to the following:
     An unexpected Error has occurred 

    This message means that the connection to the Harvest repository is not available, because you disconnected from it earlier.

    PR2941: If you check out several files, switch to a different context package, and then attempt to check in those files, the check in attempt fails. An ambiguous error message is displayed, and the files are marked as checked out on the local workspace.

    PR2942: If you are using WebSphere Application Server 4.0.x or 5.x as your Harweb web server, you are logged out the first time you start Harweb from WebSphere Studio, after you press any key. This logout happens only once after your initial logon. Afterwards, you can start Harweb from WebSphere Studio without being logged out.

    PR2943: Before you can delete a folder in the WSAD Integration Navigator view, you must do the following:

  • Use the Harvest Administrator interface to delete the folder and all its items.

  • Synchronize with Harvest in WSAD Integration.

    PR2944: While working in project, if you rename an item and then attempt to rename it back to its old name, you receive an error message similar to the following:
     Cannot rename item; new name already exists. 

    The functionality to rename an item and then rename it back to its old name is not supported by the Harvest architecture or WSAD Integration.

    PR2945: If WebSphere Studio users are forced to change their passwords when logging in to WebSphere Studio and then try to open their projects in Harvest repositories, they are denied access and receive an "incorrect login" message. To open their Harvest projects, these users must log out of WebSphere Studio and log back in, using their new passwords.

    PR2946: Suppose that two users are working on the same package, and one user runs an interactive merge process while the second user wants to check out files for that package. The first user running the interactive merge process is locking the package so that the second user cannot check out the files. The second user receives a message displaying that the files are locked because an interactive merge process is in progress. The message displays the machine name (but not the user name) that has the files checked out.

    PR2947: If a process is changed in the Harvest Admin GUI while WebSphere Studio Integration is open, WebSphere Studio Integration does not display the change until it (WebSphere Studio Integration) is stopped and restarted.

    PR2948: If the Client Path entered in the Set Harvest Context dialog is read-only and you attempt to use the Add to Workspace function, the attempt fails and an error message is displayed. This error message does not specify that the path is read-only.

    PR2949: If you are using Harweb hosted in IBM WebSphere Studio and you require Tomcat, you must use Tomcat 4.0.6. For details, see System Requirements earlier in this readme file.

    PR2950: When you replace the latest version of a file with a previous version, and attempt to edit this previous version, the file is checked out as the latest version.

    PR2951: This issue applies if you perform the following steps while using WSAD 5.1.1 and Eclipse 2.1.2 with Harvest 5.2.1:

  • Create a project, add files, share the project with Harvest, and then rename one or more of the files.

  • In Navigator view, select Replace With, Version In Harvest.

    In the Version Compare window, select version 0 (N), right-click, and select Checkout (Check out for concurrent update must be available).

  • From WSAD Integration, attempt to perform any of the following operations on a renamed file, from the Team menu: Undo Checkout, Check In and Keep, or Check In and Release. Each attempt results in the following errors:
     E0202011b: Error: Item has been previously renamed within the project.         Check in failed for file: D:Workspace_WSSDprojoffline.txt  E03060019: ERROR: Process Execute failed. Process Name: Check In Items. 

    PR2952: When logging in to Harvest, you can modify the Client Path field on the Set Harvest Context dialog; however, Harvest always ignores changes to that field and uses the default path name.

    PR2953: If you share a project, un-share it, immediately share it again, and then attempt to use the Move and Delete functions for the files in that project, the attempt fails, and Harvest displays an error message similar to the following:
     Problems occurred moving the selected resources:  Resource is out of sync with the file system... 

    To fix this problem, manually refresh the files by double-clicking them.


    7.0 Language Certifications

    After English GA, the English versions of the Harvest server, client, agent, and Harweb have been certified to run on machines designed to use the following languages: French, German, Spanish, Italian, Brazilian Portuguese, Japanese, Korean, Traditional Chinese, and Simplified Chinese. This certification means that these English versions can run on the non-English operating systems on those machines. It is not intended to mean that these versions are localized for those markets and languages.


    8.0 Contacting Technical Support

    If you need technical assistance with this product, access the Computer Associates web site, https://support.ca.com, where you can quickly locate answers to many questions. Technical support is available 24 hours a day, 7 days a week.



Chat with CA

Just give us some brief information and we'll connect you to the right CA Expert.

Our hours of availability are 8AM - 5PM CST.

All Fields Required

connecting

We're matching your request.

Unfortunately, we can't connect you to an agent. If you are not automatically redirected please click here.

  • {{message.agentProfile.name}} will be helping you today.

    View Profile


  • Transfered to {{message.agentProfile.name}}

    {{message.agentProfile.name}} joined the conversation

    {{message.agentProfile.name}} left the conversation

  • Your chat with {{$storage.chatSession.messages[$index - 1].agentProfile.name}} has ended.
    Thank you for your interest in CA.


    How Did We Do?
    Let us know how we did so that we can maintain a quality experience.

    Take Our Survey >

    Rate Your Chat Experience.

    {{chat.statusMsg}}

agent is typing