Install Databridge Host

The installation process for Hot Fixes, Updates and Service Packs for the host software in 6.6 has been simplified. Hotfixes will be supplied in a container file that has a name similar to the base release (e.g. DB66-01-Hotfix). To apply the patch, follow the procedure as you did when installing the base release. Run the install WFL to verify the latest patch and install the software.

In this new installation process a patch will replace all files previously installed rather than only the changed files. If the base release isn’t installed you can directly install a patch without having to first install the base release.

To install Databridge Host

  1. Sign on to a privileged usercode. If you install to a nonprivileged usercode, all object files will be marked as restricted, and you will have to use the ODT command RESTRICT – FILE objectcode on every Databridge program, enter the SL commands for the DBLicenseSupport libraries, and then run the DBLicenseManager program to add your license key. See the instructions in “Nonprivileged Installation.”.

  2. Upload Databridge container to the host.

    Upload the DB66-00-BASE file using a file transfer tool capable of binary/image transfers to the privileged usercode where Databridge is to be installed.

    This DB66-00-BASE file replaces the IMAGE and DISKINSTALL files used in prior releases. The DISKINSTALL image is still available, and can be uploaded and utilized to get the install WFL. Note that, the install WFL can also be extracted from the DB66-00-BASE file, which makes this file redundant. The file DISKINSTALL will not be provided in the next release.

  3. Unwrap the Databridge installation WFL (WFL/DATABRIDGE/INSTALL).

    To extract the install WFL from the file DB66-00-BASE, enter the following CANDE command: WFL UNWRAP *WFL/DATABRIDGE/INSTALL AS WFL/DATABRIDGE/INSTALL OUTOF DB66-00-BASE

  4. Start the Databridge Installation WFL.

    If you want to install the Databridge software to a different pack family than primary pack of your FAMILY substitution statement (FAMILY DISK = primarypack

    OTHERWISE secondarypack) use the following command instead.

    START WFL/DATABRIDGE/INSTALL ("DATABRIDGE", "
         otherpack")
        

    Most WFLs are copied with a SAMPLE node in the title. They will also be copied without the SAMPLE node using the ADD command so that first-time installations will have WFL files with the standard name but existing WFL files are not replaced. Parameter files, like DATA/SERVER/SAMPLE/CONTROL, are also copied without the SAMPLE node if the file doesn’t already exist.

  5. For first-time installations, edit the DBServer control file (DATA/SERVER/CONTROL). Otherwise, skip to step 8.

    1. (Optional) Change TCP/IP Port = 11367 (the default) to the port you want to use.

    2. Change SOURCE < datasourcename> to the name of the data source that the client will use.

    3. Change Database = (< usercode>)DESCRIPTION/< databasename> ON < packname> to reflect the usercode/location of the description file for the database to be replicated.

  6. If you are upgrading, do the following:

    1. Bring down the Databridge Server using the AX QUIT command.

    2. Recompile your tailored support libraries by entering the following command (replacing usercode, databasename, and pack with your values):

      START WFL/DATABRIDGE/COMP ("SUPPORT", "(
             usercode)
             databasename ON
      
             pack")
            

    For more information on recompiling, see the Databridge Host Administrator's Guide.

  7. Start the Databridge Server:

    START WFL/DATABRIDGE/SERVER

NOTE:

  • If your database uses guardfiles, you can include Databridge under database guardfile validation. See Set Up Guardfiles.

  • For information about security options, see "Databridge Security" in the Databridge Host Administrator's Guide.