Installing BEA WebLogic XML/Non-XML Translator

 

This chapter describes the steps required to install the BEA WebLogic XML/Non-XML Translator (hereafter referred to as XML Translator). The following topics are discussed:

• Preinstallation Considerations

• Installing on UNIX Platforms in Console Mode

• Installing on Windows Platforms or UNIX in Graphics Mode

• Installing Your Software License

• Uninstalling XML Translator

• Distribution Directories and Files

 

---

Preinstallation Considerations

The following actions are necessary before installing XML Translator:

• Review the platform support and software requirements sections of the BEA WebLogic XML/Non-XML Translator Release Notes and make sure that the computer upon which you are installing XML Translator satisfies the listed requirements.

• Perform a successful installation of WebLogic Server and WebLogic Integration, specifically the WebLogic Process Integrator component, if you are going to run the XML Translator plug-in.

Software Requirements

The XML Translator Version 2.0 requires the following products:

• Java Software Development Kit (SDK), Standard Edition, v 1.3.0
  or
  Java Runtime Environment (JRE), International Version, v 1.3.0

To run the XML Translator Plug-In, the following applications are also required:

• WebLogic Server 6.0 Service Pack 2

• WebLogic Integration 2.0, specifically the WebLogic Process Integrator 2.0 component

 

---

Installing on UNIX Platforms in Console Mode

To install the XML Translator software on UNIX in console mode, you run the install.bin program. A UNIX installation installs the runtime classes that translate data between XML and non-XML, as well as a plug-in for interfacing with WebLogic Process Integrator.

Perform the following steps to install the XML Translator software in console mode on a certified UNIX platform:

1. Log on as root.

   $ su -
   Password:

2. Access the CD-ROM device.

   # ls -l /dev/cdrom

   total 0

   brw-rw-rw-     1 root     sys     22,   0 July 1 10:55 c1b0t010

3. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM on any UNIX system, except HP-UX.

   # mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt

   If you are installing on an HP-UX system, use a command similar to the following command:

   # mount -r -F cdfs -o cdcase /dev/cdrom/c1b0t010 /mnt

4. Change the directory to the unix directory on your CD-ROM device. For example,

   # cd /mnt/wlintegration2.0/unix/xmltranslator

5. List the CD-ROM contents.

   # ls

   install.bin

6. Execute the installation program in character-based mode.

   # sh install.bin -i console

7. The installation program runs and prompts you for responses (see Listing 1-1 for an example).

   Listing 1-1 UNIX Console Mode Installation Example

   Preparing to install...

   Preparing CONSOLE Mode Installation...

   =================================================================

   BEA WebLogic XML/Non-XML Translator 2.0(created with InstallAnywhere by Zero G)

   -----------------------------------------------------------------

   =================================================================

   Introduction

   ------------

   This installer will guide you through the installation of 'WebLogic XML Non-XML Translator'. On each step, answer the questions provided. Type "quit" at any time to exit the installer.

   PRESS <ENTER> TO CONTINUE: 

   =================================================================

   License Agreement

   -----------------

   Please read before installing:

   BEA SYSTEMS, INC. SOFTWARE LICENSE AGREEMENT

   USE OF SOFTWARE ORDERED FROM BEA SYSTEMS, INC. ("BEA") IS PROVIDED ONLY UNDER LICENSE FROM BEA. PLEASE READ THE FOLLOWING LICENSE CAREFULLY AND INDICATE YOUR ACCEPTANCE BY CLICKING THE ACCEPTANCE BOX. CERTAIN CAPITALIZED TERMS ARE DEFINED IN SECTION 11.

   1. LICENSE TERMS

   a. Evaluation Use. The terms of this Section 1(a) are applicable to you if you have registered as an Evaluation customer. Subject to the terms of this Agreement, BEA grants to you a non-exclusive, non-transferable, license to use the evaluation version of the Software solely for Evaluation Use. Third party software products or modules supplied by BEA, if any, may be used solely with the Software. This license begins upon downloading and ends thirty (30) days thereafter (the "Evaluation Period"). When the license expires you must stop using the Software. All rights not specifically granted to you herein are retained by BEA.

   .

   .

   .

   . . .an Upgrade or a new product or feature, BEA's opinion will prevail, provided that BEA treats the product offering as a new product or feature for its end user customers generally.

   DO YOU AGREE WITH THE TERMS OF THE LICENSE? (Y/N): y

   =================================================================

   Choose BEA Home Directory

   -------------------------

       1- Create a New BEA Home

       2- Use Existing BEA Home

   Enter a number: 2

       1- /usr/bea

       2- /usr2/bea

   Existing BEA Home: 1

   =================================================================

   Choose Product Directory

   ------------------------

       1- Modify Current Selection (/usr/bea/wlintegration2.0)

       2- Use Current Selection (/usr/bea/wlintegration2.0)

   Enter a number: 2

   =================================================================

   Select a Database

   -----------------

       1- Oracle

       2- Cloudscape

       3- Microsoft SQL Server

   : 1

   Database Host Name: server_name

   Database Name: database_name

   Database User: user_name

   Database Password: password

   Email: email_address

   EmailHost: email_server_name

   =================================================================

   Installing...

   -------------

   [===============|===============|===============|===============]

   [---------------|---------------|---------------|---------------]

   =================================================================

   Install Complete

   ----------------

   Congratulations. 'WebLogic XML Non-XML Translator' has been successfully installed to:

      /usr/bea/wlintegration2.0/xmltranslator

   PRESS <ENTER> TO EXIT THE INSTALLER:

 

---

Installing on Windows Platforms or UNIX in Graphics Mode

Perform the following steps to install the XML Translator software on a Windows platform or on a UNIX platform in Graphics Mode:

1. Insert the XML Translator CD-ROM.

2. Do one of the following, depending on your platform:

   On Windows:

   1. Choose Start—>Run. The Run dialog displays.

   2. Click Browse to navigate to the CD-ROM drive.

   3. Select the wlintegration2.0/nt/xmltranslator directory; then, select the install.exe program.

   4. Click Open. The selected path and executable appear in the Run dialog.

   5. Click OK to begin the installation. The Introduction screen (Figure 1-1) is displayed.

   On UNIX:

   1. Log on as root to install the XML Translator software.

      $ su -
      Password:

   2. Access the CD-ROM device.

      > ls -l /dev/cdrom

      total 0

      brw-rw-rw-     1 root     sys     22,   0 July 1 10:55 c1b0t010

   3. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM on any UNIX system, except HP-UX.

      > mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt

      If you are installing on an HP-UX system, use a command similar to the following command:

      > mount -r -F cdfs -o cdcase /dev/cdrom/c1b0t010 /mnt

   4. Change the directory to the xmltranslator directory on your CD-ROM device. For example,

      > cd /mnt/wlintegration2.0/unix/xmltranslator

   5. List the CD-ROM contents.

      /mnt/wlintegration2.0/unix/xmltranslator> ls

      install.bin

   6. Execute the installation program.

      /mnt/wlintegration2.0/unix/xmltranslator> sh install.bin

      The Introduction screen (see Figure 1-1) is displayed.

      Figure 1-1 Introduction Screen

      
       

3. Click Next to continue with the installation. The License Agreement screen is displayed (Figure 1-2).

   Figure 1-2 License Agreement Screen

   
    

4. Click the Yes option button to accept the license agreement; then click Next to proceed with the installation. The Choose Install Set screen is displayed (Figure 1-3). This screen appears in Windows installations only.

   Note: If you click the No option button, you will not be able to continue with the installation. You must either exit the installation or go back to the Introduction screen.

   Figure 1-3 Choose Install Set Screen

   
    

5. Select the install set that you want to install on your system. You can select from the following options:

   • Client — This option installs the Format Builder design tool and samples that demonstrate its usage.

   • Server — This option installs the runtime classes that translate data between XML and non-XML, as well as a plug-in for interfacing with WebLogic Process Integrator.

   • Client and Server — This option installs the Format Builder design tool and samples, the runtime classes, and the plug-in.

     Click Next to proceed with the installation. The Choose BEA Home Directory screen is displayed (see Figure 1-4).

     Figure 1-4 Choose BEA Home Directory Screen

     
      

6. Create or select a BEA Home directory (the default is c:\bea). The BEA Home directory is the root directory in which you install all BEA products.

   Note: If you are performing a Server installation, you must install XML Translator in the same BEA Home directory where you have WebLogic Server and WebLogic Process Integrator installed.

   If you do not already have a BEA Home directory, you can create one by following these steps:

   1. Select the Create a New BEA Home option button.

   2. Accept the default location for your BEA Home directory or click Browse to specify a different location. If you accept the default location, your BEA Home directory will be c:\bea, and your XML Translator software default installation directory is c:\bea\wlintegration2.0\xmltranslator. If you do not want to install XML Translator in this default location, you will have the opportunity, in Step 7, to choose another directory in which to install the software.

   3. Click Next to proceed with the installation.

      If you already have one or more BEA Home directories on your system, you can use one of those directories as follows:

   4. Select the Use Existing BEA Home option button.

   5. Select a BEA Home directory from the list displayed to the right of the option buttons. All valid BEA Home directories are displayed in this list. Valid BEA Home directories are directories where BEA products have been installed using the standard installation program.

   6. Click Next to proceed with the installation.

7. If the installation program encounters a previous version of XML Translator in the selected BEA Home directory, the Previous Installation Found message box displays (Figure 1-5).

   Figure 1-5 Previous Installation Found Message Box

   
    

   From this message box, do one of the following:

   • Click Continue to install over the previous version.

   • Click Cancel to return to the Choose BEA Home Directory Screen and select another directory.

   • Click Exit to exit the installation program.

8. If you do not have a successful installation of WebLogic Integration, specifically the WebLogic Process Integrator component, in the BEA Home directory, the WebLogic Process Integrator Not Installed message box displays (Figure 1-6).

   Figure 1-6 WebLogic Process Integrator Not Installed Message Box

   
    

   From this message box, do one of the following:

   • Click Exit to exit the installation program.

   • Click Previous to return to the Choose BEA Home Directory Screen and select another directory.

   • Click Next to proceed with the installation process. The .JAR files required for the XML Translator plug-in will be installed in the wlintegration2.0\repository\lib directory, but will not be functional until you perform a successful installation of the WebLogic Process Integrator component of WebLogic Integration.

9. If this is the first WebLogic Integration component you are installing, once you have selected a BEA Home Directory in which to install XML Translator, the Choose Product Directory Screen displays (Figure 1-7).

   Figure 1-7 Choose Product Directory Screen

   
    

10. Specify an installation directory for XML Translator by performing the one of the following actions:

    • Accept the default installation directory.

    • Enter the installation directory directly into the text entry field.

    • Click Browse and navigate to your desired installation root directory, then click OK to make the directory path appear in the Specify Product Installation Directory text entry field.

      Note: Clicking Reset resets the installation directory to the previous value (before you made any changes).

11. Click Next to proceed with the installation. If you chose a Server Install or a Client and Server Install, the Database Selection screen is displayed (Figure 1-8).

    Note: If you chose a Client Install, proceed with step 14.

    Figure 1-8 Database Selection Screen

    
     

12. Choose the database type that contains the document repository and click Next. The Database Configuration screen displays (Figure 1-9).

    Note: Because a common database is used by all WebLogic Integration components, you should specify the same database and provide the same access information as you provided for any previously installed component. To facilitate this, the information you provided when you installed any other WebLogic Integration component is carried forward to the XML Translator installation.
    
    If, when you installed the WebLogic Process Integrator component of WebLogic Integration, you specified a Sybase database for the custom domain, you must reinstall the WebLogic Process Integrator component and select a database that is supported by XML Translator. Click Exit, to exit the XML Translator installation program. After you have reinstalled WebLogic Process Integrator, you may restart the XML Translator installation program.
    
    If you chose Cloudscape as the database type, proceed to step 13.

    Figure 1-9 Database Configuration Screen

    
     

13. Enter the connection information appropriate for your repository database and click Next. The Database Confirmation screen displays (Figure 1-10).

    Note: Clicking Reset resets the database configuration values to the previous values (before you made any changes).

    Figure 1-10 Database Confirmation Screen

    
     

14. Verify that you chose the correct database type and click Install to install the software. If you need to change your database selection, click Previous.

    Note: Clicking Exit exits the installation program.

    Upon installation completion, the Install Complete screen is displayed (Figure 1-11).

    Figure 1-11 Install Complete Screen

    
     

15. Click Done to exit the installation program.

 

---

Installing Your Software License

The components of WebLogic Integration cannot be used without a valid software license. A 30-day license file is automatically installed when you install the first WebLogic Integration component. When you purchase the software, a permanent WebLogic Integration license file will be provided to you by BEA. Follow the directions below to update your license file on the target system.

To update the WebLogic Integration software license:

1. Open a Command Prompt window.

2. Change directories to your BEA Home directory.

3. Run the Update License Utility.

   On Windows:

   c:\bea> UpdateLicense [license_file_name]

   On UNIX:

   /usr/bea> sh updatelicense.sh [license_file_name]

 

---

Uninstalling XML Translator

This section provides instructions for uninstalling XML Translator. The following topics are discussed:

• Uninstalling on UNIX Platforms in Console Mode

• Uninstalling on Windows Platforms

Uninstalling on UNIX Platforms in Console Mode

To uninstall XML Translator on a UNIX platform:

1. Change directories to your UninstallerData directory with the following command:

   > cd /usr/bea/wlintegration2.0/unix/xmltranslator/UninstallerData

2. Start the uninstallation program with the following command:

   /usr/bea/wlintegration2.0/unix/xmltranslator/UninstallerData> sh Uninstall -i console

   Listing 1-2 displays an XML Translator uninstallation.

   Note: The single-dash bar just beneath the double-dash bar in Listing 1-2 is a progress indicator. When the single-dash bar becomes the same length as the double-dash bar, uninstallation is complete.

   Listing 1-2 UNIX Uninstallation Example

   Preparing CONSOLE Uninstall...

   =================================================================

   BEA WebLogic XML/non-XML Translator 2.0 (InstallAnywhere Uninstaller by Zero G)

   -----------------------------------------------------------------

   About to uninstall...

      BEA WebLogic XML/non-XML Translator 2.0

   This will completely remove all components installed by InstallAnywhere. It will not remove files and folders created after the installation.

   PRESS <ENTER> TO BEGIN THE UNINSTALL, OR 'QUIT' TO EXIT THE UNINSTALLER: <ENTER>

   =================================================================

   Uninstall...
   ------------

   [==================|==================|==================|======]

   [------------------|------------------|------------------|------]

   ================================================================

   Uninstall Complete

   ------------------

   All items were successfully uninstalled.

   PRESS <ENTER> TO EXIT THE UNINSTALLER: <ENTER>

Note: Some files may not be uninstalled because they are required for another WebLogic Integration product.

Uninstalling on Windows Platforms

Perform the following steps to uninstall the XML Translator software on a Windows platform:

1. Choose Start—>Programs—>BEA WebLogic E-Business Platform—>wlintegration2.0—>xmltranslator—>Uninstall XML Translator from the Start menu. The XML Translator Uninstaller screen is displayed (Figure 1-12).

   Figure 1-12 XML Translator Uninstaller Screen

   
    

2. Click Uninstall to start uninstalling XML Translator. When the process is complete, the screen shown in Figure 1-13 is displayed.

   Figure 1-13 XML Translator Uninstallation Complete Screen

   
    

3. Click Exit to complete the uninstallation.

Note: Some files may not be uninstalled because they are required for another WebLogic Integration product.

 

---

Distribution Directories and Files

The XML Translator CD-ROM contains the following directories and files. After running the installation program, verify that the directories and files appropriate for the type of installation you performed are installed on your system.

Server Installation

Table 1-1 lists the files and directories that get installed when you perform a Server Installation.

Table 1-1 Server Installation Files and Directories

Directory	Files
<BEA_Home>\wlintegration2.0\repository	Files required for the WebLogic Integration products to access the document repository.
<BEA_Home>	license.bea log.txt registry.xml UpdateLicense.cmd
<BEA_Home>\utils	utils.jar
<BEA_Home>\wlintegration2.0\ xmltranslator	wlxtrt.jar
<BEA_Home>\wlintegration2.0\ xmltranslator\uninstaller	Files required to run the XML Translator uninstallation program
<BEA_Home>\wlintegration2.0\ xmltranslator\samples	Files required to run the sample applications included on the CD-ROM

 

Table 1-2 lists the files and directories that get installed when you install the XML Translator Plug-In.

Table 1-2 Plug-In Installation Files and Directories

Directory	Files
<BEA_Home>\wlintegration2.0\ processintegrator\lib	wlxtmb.jar wlxtpi.jar wlxtpi.war

 

Client Installation

Table 1-3 lists the files and directories that get installed when you perform a Client Installation.

Table 1-3 Client Installation Files and Directories

Directory	Files
<BEA_Home>\wlintegration2.0\repository	Files required for the WebLogic Integration products to access the document repository.
<BEA_Home>	license.bea log.txt registry.xml UpdateLicense.cmd
<BEA_Home>\utils	utils.jar
<BEA_Home>\wlintegration2.0\ xmltranslator	fb.cmd or fb.sh FormatBuilder.config FormatBuilder.exe FormatBuilder.lax FormatBuilderHelp.properties jamdmd42.jar lax.jar LICENSE palette.mfl repository-client.jar weblogic.jar wlxtfb.jar xmlx.jar
<BEA_Home>\wlintegration2.0\ xmltranslator\uninstaller	Files required to run the XML Translator uninstallation program
<BEA_Home>\wlintegration2.0\ xmltranslator\apidoc	Files containing Java documentation
<BEA_Home>\wlintegration2.0\ xmltranslator\help	Files required to access the Format Builder online help system
<BEA_Home>\wlintegration2.0\ xmltranslator\samples	Files required to run the samples applications included on the XML Translator CD-ROM