Technical Notes

This technical note describes how to perform a new installation or upgrade an existing installation for DATABridge Client 6.0 on a Windows server.

For detailed information about the installation process, see the Client Administration Guide:

Installing or Upgrading DATABridge Client 6.0

Follow these steps to install DATABridge Client 6.0 on a Windows server.

Note: If you are upgrading an existing installation, make sure that you install to a new install directory and not to the previous client install directory.

1. Locate the installation image.
2. Run Setup and click Continue to install.
3. On the File Location tab, enter the File Location. The default location is C:\Program Files\Attachmate\DATABridge\6.0.
4. On the Feature Selection tab, select the client you want to install. By default, the Microsoft SQL Server client is selected.

View Full Size

Figure 1: Selecting the features to install.

5. By default, DATABridge installs to the machine on which you run setup. If you want to create an administrative install (in other words, install a source image of the application on a network share, similar to a source image on a CD-ROM), use the Advanced tab.
6. Once you have selected the desired options click Install Now to install the product.

Configuring the Installation

Once the installation is complete, you are prompted to make some additional configurations. Configuring updatepath options is required for both a new install and an upgrade.

Important Note for Upgrading: If you are upgrading, you must configure the path and working directory to be able to use the migrate utility that ships with DATABridge 6.0.

1. Select one of two options:

2. Enter the Working Directory. Note: If you are upgrading, the working directory for DATABridge 6.0 must be different from the working directory of your current installation.

View Full Size

Figure 2: Configuring the path and working directory.

If this is a new installation, the install is complete. If you are upgrading from a previous client, proceed to the next section.

Upgrading an Existing Datasource

The migrate utility reads the old configuration files for all of the specified data sources, converts the files to the 6.0 format, and migrates the files to the new working directories. Migrate creates subdirectories for all the data sources using the data source name (in lowercase), and also creates the config, logs, dbscripts and discards subdirectories for all the data sources. Note: The functionality you have configured in your current installation is not affected by using the migrate utility when you upgrade.

Open a DOS prompt and follow the instructions below to use the migrate utility to upgrade an existing datasource. 

1. Click Start > Run, and type cmd to open a Windows command window. Enter the following commands at the command prompt, pressing Enter after each command.
   1. Type: migrate

2. Type: <source name>
3. Type: <old working directory>
2. Repeat steps b and c for all of your datasources. When done, press Enter again to complete the process.

View Full Size

Figure 3: Running the migrate utility at the DOS prompt.

The upgrade is now complete. You can run your client from a DOS prompt, or you can configure the console to run the client through the console.

Additional Resources

DATABridge documentation is available in the product and online at http://support.attachmate.com/manuals/databridge.html.

For information about how to contact Technical Support, see http://support.attachmate.com/contact/?prod=databridge.