Document ID: 74486-01-1201-01

Topic	Page
1. Accessing current release bulletin information
2. Product summary
2.1 Version Contents
3. Special installation instructions
3.1 Instructions for Enterprise Connect
3.2 Instructions for Enterprise Connect Data Access
3.3 Instructions for Enterprise Connect Data Movement
3.4 Instructions for Enterprise Connect Complete
4. Changed functionality in this version
4.1 Support for DB2 Universal Database for UNIX and Windows
4.2 Support for Informix 9
5. Product compatibilities
6. Documentation updates and clarifications
6.1 Enterprise Connect
6.2 Enterprise Connect Data Movement
7. Technical support
8. Other sources of information
8.1 Sybase certifications on the Web

1. Accessing current release bulletin information

A more recent version of this release bulletin may be available on the World Wide Web. To check for critical product or document information added after the release of the product CD, use the Sybase Technical Library Product Manuals Web site.

To access release bulletins at the Technical Library Product Manuals Web site:

1. Go to Product Manuals.

2. Follow the links to the appropriate Sybase product.

3. Select the “Platform-Specific” collection for the product version you are interested in.

4. From the list of individual documents, select the link to the release bulletin for your platform. You can either download the PDF version or browse the document online.

2. Product summary

Enclosed is one of the following:

• Enterprise Connect Data Access Integrated Product Set

• Enterprise Connect Data Movement Integrated Product Set

• Enterprise Connect Complete Integrated Product Set

---

Note:

Enterprise Connect Complete is the combination of Enterprise Connect Data Access and Enterprise Connect Data Movement on each platform. Since each of these Integrated Product Sets is discussed in detail in the following sections, Enterprise Connect Complete will not be discussed separately.

---

2.1 Version Contents

The following sections describe the contents of each Integrated Product Set, including current version numbers.

2.1.1 Enterprise Connect Data Access

Enterprise Connect Data Access consists of the following components:

• DirectConnect™ 12.0 — a Sybase product that provides basic connectivity to non-Sybase data sources. In particular, it provides access management, transaction management, and remote systems management. Enterprise Connect Data Access contains the following DirectConnect products:

  • DirectConnect Anywhere™ 12.0

  • DirectConnect for AS/400 12.0

  • DirectConnect for DRDA 12.0

    ---

    
    Note:

    To obtain support for DB2 Universal Database for UNIX and Microsoft Windows platforms and improved jConnect™ metadata access, you must update DirectConnect for DRDA to version 12.00.03 or higher.

    ---

  • DirectConnect for Informix 12.0

  • DirectConnect for Microsoft SQL Server 12.0

  • DirectConnect for Oracle 12.0

  ---

  
  Note:

  DirectConnect for MVS 12.0 is a component in the Mainframe Connect 12.0 Integrated Product Set. For content information about DirectConnect for MVS, see the release bulletin for DirectConnect for MVS Version 12.0.

  ---

• Adaptive Server® Enterprise 12.0 — a Relational Database Management System (RDBMS) licensed solely for the use of the Component Integrations Services (CIS) functionality.

• jConnect for JDBC™ 4.2 & 5.2 — Sybase's high-performance JDBC driver that works with both Sun and Microsoft virtual machines. jConnect provides native access to all Sybase database products, including Adaptive Server®, Replication Server®, and servers based on Open Server™.

• Open Client/Server™ 12.0 — two families of Sybase products that enable customers to write client and server application programs.

For more information on specific platform requirements and operating system configurations, refer to the release bulletins for the component products listed previously.

2.1.2 Enterprise Connect Data Movement

Enterprise Connect Data Movement consists of the following components:

• Replication Server 12.1 — an Open Server application that maintains replicated data in multiple databases while ensuring the integrity and consistency of the data.

• Replication Server Manager (RSM) 12.1 — an Open Server application, called RSM Server, which connects to other servers in the replication environment, plus a plug-in to Sybase Central, called RSM Client, which communicates with RSM Server to manage the replication system.

• Sybase Replication Agent™ 12.1 — an Open Server application that captures transactions in the primary database and then transfers these transactions to Replication Server for distribution to replicate databases.

• Adaptive Server Enterprise 12.0 — an RDBMS licensed solely for use as the repository for the Replication Server System Database (RSSD).

For more information on specific platform requirements and operating system configurations, refer to the release bulletins for the component products listed above.

3. Special installation instructions

This section describes special instructions for installing Enterprise Connect 12.1.

---

Note:

Read through this entire section before you begin installing any Enterprise Connect 12.1 components.

---

3.1 Instructions for Enterprise Connect

This section contains installation instructions for all Integrated Product Sets delivered as part of Enterprise Connect.

3.1.1 Products don’t appear in configuration utility after installation

If you have previously installed Sybase products and are now installing additional products in the same $SYBASE directory, the configuration utility may not show your new products as available for configuration. If this happens, click Cancel to exit the configuration utility, then follow the product documentation to configure each product without the use of the configuration utility.

3.1.2 Drivers fail during installation (NT and 2000)

On Microsoft Windows NT and Windows 2000, after client installation of DB2 Universal Database for Windows version 7.1, Open Client/Server and third-party ODBC drivers fail.

The problem is that the DB2 Universal Database installation sets an environment variable called LC_ALL. In the case of ODBC, the driver reads this variable and fails to connect. In the case of Open Client/Server, the isql session will fail to connect.

Workaround: Users must remove the LC_ALL environment variable to restore the environment. Removing this variable does not affect ODBC driver connectivity or isql connectivity.

3.1.3 License certification utility runs in GUI mode only

In non-GUI (Graphical User Interface) mode, you are not prompted to enter license certificate information.

During a command line installation, the license prompt asks whether you have already entered your license at a central server. The problem is that if you respond “no,” you get the default license provided on the installation CD.

In setting up a silent or command file installation, you can enter network license information at the end of the command file. The problem is that you must have already entered the license keys somewhere else.

Workaround 1: After a command line installation, and before or after a command file installation, you can run the License Manager utility.

• On Windows, run the lmgr.bat utility located in %SYBASE%\SYSAM-1_0\bin to enter license certificate information for your installation.

• On UNIX, go to the $SYBASE directory and enter:

  source SYBASE.sh (or .csh)

  At the command line, enter:

  SYSAM-1_0/bin/lmgr

This utility starts the Studio Installer GUI in license mode.

Workaround 2: Manually execute the SySAM daemons.

To start SySAM and the SySAM daemons from Windows:

1. From the Windows taskbar, select Start|Programs|Sybase|SySAM.

   The Studio Installer starts in License mode and prompts you for a SySAM Certificate to register.

2. Click “yes”.

3. Enter the license information.

4. At the command line, enter:

   %SYBASE%\SySAM-1_0\bin\SySAM.bat

5. To verify the software is running, enter:

   %SYBASE%\SySAM-1_0\bin\lmutil.exe lmstat -c

To stop the SySAM daemons from Windows:

1. From the Control Panel, select Services.

2. On the Services dialog box, select Stop.

3. To verify that the software is stopped, enter the following at the command line:

   %SYBASE%\SySAM-1_0\bin\lmutil.exe lmstat –c

To start SySAM and the SySAM daemons from UNIX:

1. Got to the $SYBASE directory and enter:

   source SYBASE.sh (or .csh)

2. At the command line, enter:

   SYSAM-1_0/bin/startd.sh

   When the lmgrd daemon starts, it automatically starts the SYBASE daemon.

3. Verify that the license management software is running on the system. At the command line, enter:

   SYSAM-1_0/bin/lmutil  lmstat -c

To stop the SySAM daemon from UNIX:

1. Got to the $SYBASE directory and enter:

   source SYBASE.sh (or .csh)

2. At the command line, enter:

   SYSAM-1_0/bin/lmutil lmdown

   When the lmgrd daemon stops, it automatically stops the SYBASE daemon.

3. Verify that the license management software is stopped. At the command line, enter the following:

   SYSAM-1_0/bin/lmutil lmstat -c

3.1.4 “Missing font” error messages (Solaris 2.6)

In jre1.2/lib/font.properties the default font, fontset.default, is set to Monotype Arial. Monotype Arial is not part of a standard Solaris 2.6 installation but is part of the optional font set. If Monotype Arial is not installed before you start a Java application, you will receive a large number of error messages regarding missing fonts. In addition, the Java application will not be able to display some text. This problem occurs because the application cannot explicitly set a particular font that is available on the system.

Workaround: Install the optional font set from the package, SUNWi1of.

3.1.5 ESD#1 incorporated in ASE 12.0

In the release bulletin for ASE, sections 9.2, 9.3, and 9.4 refer to downloading ESD#1 to correct some known problems. The fixes contained in the ESD#1 are incorporated in the version of ASE delivered with Enterprise Connect 12.x.

For more information on the specific problems corrected in the ASE 12.0 ESD#1, see “6.1.1 Problems corrected by ESD#1 incorporated in ASE 12.0”.

3.1.6 ESD#3 incorporated in Enterprise Connect 12.1

ESD#3 is incorporated in Enterprise Connect 12.1 and corrects some known problems. For information about what problems are resolved in this version, see the documentation accompanying ASE 12.00.03 on the World Wide Web.

3.1.7 Studio Installer will not run when environment variables change (UNIX)

On UNIX platforms, the Studio Installer will not run after environment variables are changed by the Sybase environment variables shell script (SYBASE.csh or SYBASE.sh). The shell script resides in the $SYBASE directory after an initial install.

If you need to run the Studio Installer after environment variables are changed by the SYBASE.csh or SYBASE.sh script (or changed as specified in that script), open a new window that does not use that environment.

---

Note:

The uninstall program will run normally even after environment variables are changed by the SYBASE.csh or SYBASE.sh environment variables shell script.

---

3.1.8 Null pointer exception when exiting Studio Installer

Under some circumstances, a null pointer exception might be displayed when the installer is exiting. The message will include the string “invalid peer.” This problem will be fixed in a future release and should not affect the current installation of any product.

3.1.9 Uninstalling Sybase software

In the Installation Guide of some Enterprise Connect Integrated Product Set 12.1 components, including ASE 12.0, the uninstall function of the Studio Installer is not documented correctly. This section describes the uninstall procedure.

Before uninstalling Sybase software, shut down all Sybase applications and processes that will be affected by the uninstall procedure.

---

Note:

The uninstall procedure does not uninstall Sybase directories created by the user. You should remove these directories before executing the uninstall procedure.

---

To start the uninstall procedure from Windows:

1. From the Start menu, choose Programs.

2. Under the Programs menu, choose Sybase, then Uninstall.

You can also execute the uninstall batch file uninstall.bat directly from a DOS window:

Installer\bin\uninstall.bat

You must be in the %SYBASE% directory when you invoke the uninstall batch file.

To start the uninstall procedure from UNIX:

1. Stop the SySAM daemon. For more information see “To stop the SySAM daemon from UNIX:”.

2. Go to the $SYBASE directory and enter:

   source SYBASE.sh (or .csh)

3. To execute the uninstall program, enter:

   Installer/bin/uninstall

To uninstall the Sybase software:

1. If you have not already done so, shut down all Sybase applications and processes that will be affected by the uninstall procedure. The uninstall procedure prompts you to do this, even if there are no such processes running.

2. Click Yes to continue with the uninstall procedure.

   The uninstall procedure displays the Uninstall Component Selection dialog box.

3. Select the components you want to uninstall, or click Select All if you want to uninstall everything.

4. Click Next to continue.

   The uninstall procedure displays an Uninstall Summary, which lists the components you selected to uninstall.

5. If this information is correct, click Next to continue.

   The uninstall procedure lists each component as it is removed.

   ---

   
   Note:

   The uninstall procedure does not uninstall Sybase directories created by the user.

   ---

6. An information dialog box verifies that the uninstall procedure has completed.

---

Note:

Windows NT does not delete open files or files currently in use.

---

3.2 Instructions for Enterprise Connect Data Access

This section contains installation instructions that are unique to Enterprise Connect Data Access.

---

Note:

If you have an existing installation of DirectConnect 12.0 or greater, do not install Enterprise Connect Data Access. Enterprise Connect Data Access contains DirectConnect 12.0. For information about the current version of DirectConnect, see the documentation accompanying DirectConnect for DRDA version 12.00.03 or later. Check the World Wide Web for availability.

---

3.2.1 New installation for DirectConnect 12.0

---

WARNING!

The installation for DirectConnect 12.0 has changed completely from the 11.7 version. You must follow the installation steps in the Installation Guide for DirectConnect to install DirectConnect 12.0.

---

3.2.2 Error messages during installation (Windows NT)

If you receive the message, “The current user doesn’t have administrator privileges...”

If you do not log in as “system administrator” before running Studio Installer, the message, “The current user doesn’t have administrator privileges, log in as administrator and continue installation,” appears followed by a Yes and No button. This message appears if you use any user ID other than “system administrator,” even when that user ID has administrator privileges. Dismiss this message and proceed with installation by choosing Yes.

If you are prompted to replace the existing msvcrt.dll file

During the Studio Installer installation process, you might receive a message asking if you want to replace the existing msvcrt.dll file. Select the most recent file by choosing Yes or No, depending on the dates.

3.3 Instructions for Enterprise Connect Data Movement

This section contains the installation instructions that are unique to Enterprise Connect Data Movement.

3.3.1 Uninstall on Solaris requires a local display

On Solaris, to uninstall Enterprise Connect Data Movement software, you must use a local disk and a local display.

3.4 Instructions for Enterprise Connect Complete

This section contains installation instructions unique to Enterprise Connect Complete.

---

Note:

If you have an existing installation of DirectConnect 12.0 or greater, do not install Enterprise Connect Complete. Enterprise Connect Complete contains DirectConnect 12.0. For information about the current version of DirectConnect, see the documentation accompanying DirectConnect for DRDA version 12.00.03 or later. Check the World Wide Web for availability.

---

3.4.1 Installing ASE with Enterprise Connect Complete Integrated Product Set

The Enterprise Connect Complete Integrated Product Set contains two copies of Adaptive Server Enterprise (ASE) 12.0 for restricted use:

• On the Data Access CD for CIS functionality

• On the Data Movement CD for storage of the Replication Server RSSD

To ensure that the ASE 12.0 license management feature works properly, Sybase recommends that you install only one copy of the ASE software. A single copy of ASE can be used for both functions described above.

4. Changed functionality in this version

Enterprise Connect 12.1 functionality changes are described in the following sections. For more details about new features see the release bulletins for the specific components of Enterprise Connect.

4.1 Support for DB2 Universal Database for UNIX and Windows

Enterprise Connect Data Movement now supports replication from DB2 Universal Database for UNIX and Windows NT. For more information about specific components and their support of DB2 Universal Database, see the release bulletins for those components.

---

Note:

An enhancement to DirectConnect for DRDA that includes access to DB2 Universal Database for Windows and UNIX platforms will be available in DirectConnect for DRDA version 12.00.03 or later. Check the World Wide Web for availability.

---

4.2 Support for Informix 9

Enterprise Connect Data Movement now supports replication from Informix Version 9.0. For more information about this new functionality, see the release bulletin for Sybase Replication Agent 12.1.

4.3 Support for Microsoft SQL Server 2000

Enterprise Connect Data Movement now supports replication from Microsoft SQL Server 2000. For more information about this new functionality, see the release bulletin for Sybase Replication Agent 12.1.

5. Product compatibilities

If you have previously installed Sybase products using the configuration utility, you may not see a product you’ve just installed on your list of products to configure. If this happens, click Cancel to exit the configuration utility. Restart the configuration utility and continue with configuration.

6. Documentation updates and clarifications

This section describes documentation updates and clarifications that apply to the manuals and online documentation for the Enterprise Connect 12.1 components.

6.1 Enterprise Connect

This section describes documentation updates and clarifications that apply to all Enterprise Connect Integrated Product Sets.

6.1.1 Problems corrected by ESD#1 incorporated in ASE 12.0

In the release bulletin for ASE, sections 9.2, 9.3, and 9.4 refer to downloading ESD#1 to correct some known problems. The fixes contained in the ESD#1 are incorporated in the version of ASE delivered with Enterprise Connect Data Movement Integrated Product Set 12.x.

The problems corrected by ESD#1 and incorporated in ASE are listed below:

• 210686 — Java Applications using jConnect 4.2 can throw IOExceptions when using numeric datatypes as arguments to stored procedures that are also OUTPUT parameters.

• 209913 — A 953 error can be incorrectly reported during execution of the DISK REFIT command, and sysdatabases.name can have a blank value for tempdb after execution of the DISK REFIT command.

• 209828 — Executing a server-to-server RPC from an ASE 12.0 server to an ASE 11.x server fails with a 7221 error (Login failed).

6.1.2 Studio Installer uninstall feature

In the Adaptive Server Enterprise Installation Guide, the uninstall function of the Studio Installer is documented as not working. This problem is corrected in the Studio Installer distributed with Enterprise Connect Integrated Product Sets version 12.x. For more information about the uninstall procedure, see “3.1.9 Uninstalling Sybase software”.

6.2 Enterprise Connect Data Movement

This section describes documentation updates and clarifications that uniquely apply to Enterprise Connect Data Movement.

6.2.1 Path to rsmgen program

In Chapter 6, the Replication Server Configuration Guide for UNIX Platforms lists the path to the rsmgen executable incorrectly. It states: To use rsmgen to create a RUN file, enter:

$SYBASE/RSM-12_0/install/config/rsmgen [rsm_server_name]

The rsmgen executable actually resides in the install directory, and the config directory is not in the install directory.

To use rsmgen to create a RUN file, enter the following command instead of the command shown in the Replication Server Configuration Guide for UNIX Platforms:

$SYBASE/RSM-12_0/install/rsmgen [rsm_server_name]

6.2.2 Upgrading RSM to version 12.x

In Chapter 6, the Replication Server Configuration Guide, instructions are incomplete for upgrading earlier versions of Replication Server Manager (RSM) to version 12.x.

Use the procedures in the following sections to upgrade RSM Server version 11.x to version 12.x.

To upgrade RSM to version 12.x on UNIX platforms

1. Install RSM Server version 12.x from the distribution CD.

2. Execute the rsmgen program.

   Edit the Configuration Directory field to point to the old configuration directory.

   The default directory for version 11.5 installations was:

       $SYBASE/admin/config

3. Generate the new RUN script.

   Restart RSM Server using the new RUN Script.

To upgrade RSM to version 12.x on Windows NT platforms

1. Install RSM Server version 12.x from the distribution CD.

2. Execute the RSMSetup program.

3. Enter the name of the existing RSM Server.

   RSMSetup retrieves the location of the existing configuration files.

4. Select the Modify Button.

   RSMSetup generates a new batch file that uses the new directory structure.

7. Technical support

Each Sybase installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support. If you have any questions about this installation or if you need assistance during the installation process, ask the designated person to contact Sybase Technical Support or the Sybase subsidiary in your area.

8. Other sources of information

Use the Sybase Technical Library CD and the Technical Library Product Manuals Web site to learn more about your product:

• The Technical Library CD contains product manuals and technical documents and is included with your software. The DynaText browser (included on the Technical Library CD) allows you to access technical information about your product in an easy-to-use format.

  Refer to the Technical Library Installation Guide in your documentation package for instructions on installing and starting the Technical Library.

• The Technical Library Product Manuals Web site is an HTML version of the Technical Library CD that you can access using a standard Web browser. In addition to product manuals, you will find links to the Technical Documents Web site (formerly known as Tech Info Library), the Solved Cases page, and Sybase/Powersoft newsgroups.

  To access the Technical Library Product Manuals Web site, go to Product Manuals.

8.1 Sybase certifications on the Web

Technical documentation at the Sybase Web site is updated frequently.

For the latest information on product certifications

1. Point your Web browser to Technical Documents.

2. Select a product from the product pick list and click Go.

3. Select the Certification Report filter, specify a time frame, and click Go.

4. Click a Certification Report title to display the report.

For the latest information on EBFs and Updates

1. Point your Web browser to Technical Documents.

2. Select EBFs/Updates. Enter user name and password information, if prompted (for existing Web accounts) or create a new account (a free service).

3. Specify a time frame and click Go.

4. Select a product.

5. Click an EBF/Update title to display the report.

To create a personalized view of the Sybase Web site (including support pages)

Set up a MySybase profile. MySybase is a free service that allows you to create a personalized view of Sybase Web pages.

1. Point your Web browser to Technical Documents

2. Click MySybase and create a MySybase profile.