Installation on UNIX

 

The following topics are provided for installing WebLogic Integration - Business Connect on computers with UNIX operating systems.

Concepts

• Initialization and Termination Scripts for UNIX

Procedures

• Installing on UNIX

• Uninstalling on UNIX

 

---

Initialization and Termination Scripts for UNIX

After you have installed the application on UNIX, tested it to your satisfaction and are ready to place it into production, you might want to run it automatically in the background.

Installed with the application is a System V initialization and termination script that enables you to start WebLogic Integration - Business Connect when you boot your system and close it when you shut your system down. We recommend that you get assistance from your UNIX system administrator if you want to implement this script.

The script is named interchange and is installed in the following location for each UNIX operating system:

installation_directory/bin/interchange

 

---

Installing on UNIX

Use this procedure as the starting point for installing WebLogic Integration - Business Connect on the supported UNIX operating systems. They are:

• Hewlett-Packard HP-UX 11.0

• IBM AIX 4.3.3

• Sun Solaris 2.6, 2.7 or 2.8

The default installation process is text-based, but you can use an option that activates a graphical user interface during installation.

The following steps are common to all UNIX operating systems. Once you perform them, you are directed to the procedure for your particular operating system to complete the installation.

Before you install WebLogic Integration - Business Connect, see System Requirements, to ensure your hardware, software and communications are ready for installation of the application. In addition, see Installation and Configuration, before installing.

Steps

1. Create a user account for WebLogic Integration - Business Connect (connect, for example) as the home directory for the application. For example, you can use one of the following as a home directory:

   /opt/connect

   /usr/local/connect

   Note: The directory must not be automounted or on an automounted file system. WebLogic Integration - Business Connect cannot run correctly on an automounted file system. This applies to volumes mounted using the automount utility and not to volumes that are automatically mounted at startup. WebLogic Integration - Business Connect cannot be installed on automounted volumes because of automatic unmounting of such drives.

2. Determine the device name of your CD-ROM drive.

   The installation CD has a standard ISO-9660 (High Sierra) file system with Rock Ridge extensions.

3. Determine how much RAM your server has. You need to enter this information during the installation routine.

4. See the installation procedure for your operating system:

   • Installing on Hewlett-Packard HP-UX

   • Installing on IBM AIX

   • Installing on Sun Solaris

   The following installation guidelines apply to all UNIX operating systems.

   You can use the following options with the install.sh command:

   Table 5-1 install.sh Options

   Option	Description
   -g	Uses a graphical user interface (GUI) for the installation routine. The default routine is text-based. If you use this option, ensure you have X Windows connectivity to the server where you are going to install the application. This option tests for X Windows capability and, if the system passes, launches the GUI installation.
   -s	Logs screen output to the file installation_directory/logs/install.log
   -x	Prints all commands before they are executed. Used for debugging, this is a powerful tool when combined with the -s option.

   
    

   When using the default text-based installation, be aware of the following:

   • Press Ctrl+C to cancel the installation at any time.

   • When the license agreement text displays, press Enter to scroll through the text until you reach the accept agreement prompt or type q and press Enter to skip through the license and go directly to the accept agreement prompt.

   • When the ready to install prompt appears, press Enter to install or type 2 and press Enter to cancel the installation.

   When prompted to enter the registration number, type the registration number exactly as it appears on the CD jewel case. This entry is case sensitive.

   When prompted to type your company name, you can use any alphanumeric characters and spaces. You also can use the following characters: / \ : . _. If your company name includes spaces, the application translates them as underscores.

   When prompted to select an installation directory, be advised that you cannot use a directory name that includes blank spaces.

   When prompted to type the path where your HTML browser is located, you can skip this and specify a location later by selecting Tools—>Preferences in Administrator. You use a browser to access the online help and obtain certificates from third-party certificate authorities. You will not be able to access the online help until you specify a browser.

   Following installation, the Terminal window provides the command for starting Administrator. It also provides instructions for enabling group access to the application.

 

---

Installing on Hewlett-Packard HP-UX

Use this procedure to install the application on your Hewlett-Packard HP-UX server.

Steps

1. Log in as root.

2. Insert the WebLogic Integration - Business Connect CD into the CD-ROM drive.

3. If /mnt does not exist, create it with the following command:

   mkdir /mnt

4. Mount the WebLogic Integration - Business Connect CD with the following command:

   mount -o cdcase /dev/dsk/* /mnt

   where /dev/dsk/* is the device name of your CD-ROM.

5. Log out as root.

6. Log in to the account you created previously.

7. From the home directory, run the following command:

   /mnt/hpux/install.sh

8. Follow the instructions in the installation process.

9. Log out from the account.

10. Log in as root.

11. Unmount the WebLogic Integration - Business Connect CD by running the following command:

    umount /mnt

12. Eject the WebLogic Integration - Business Connect CD from the CD-ROM drive.

13. Log out as root.

 

---

Installing on IBM AIX

Use this procedure to install the application on your IBM AIX server.

The Logical Volume Manager (LVM) enables the user to specify the physical sectors of the hard drive, or group of hard drives, to use when creating a volume on the AIX. The sectors closest to the center spindle of the disk generally give the fastest, most efficient, input and output reads and writes. The sectors towards the edge of the disk generally give the slowest input and output results. Once the LVM is used to create and mount a volume on the AIX, WebLogic Integration - Business Connect can be installed into a directory on that mount point just as it can with a non-LVM volume. The WebLogic Integration - Business Connect software itself is not aware of whether or not this is an LVM mount point.

Steps

1. Insert the WebLogic Integration - Business Connect CD into the CD-ROM drive.

2. Log in as root

3. Run the command:

   mount -vcdrfs -r -p /dev/cd? /mnt

   where /dev/cd? is the device name of your CD-ROM. Possible values are 0 through 9. If you have only one CD-ROM, its number is probably 0.

4. Log out as root.

5. Log in to the account you created previously.

6. From the home directory, run the following command:

   /mnt/aix/install.sh

7. Follow the instructions in the installation process.

8. Log out from the account.

9. Log in as root.

10. Unmount the CD by running the following command:

    umount /mnt

11. Eject the CD from the CD-ROM drive.

12. Log out as root.

 

---

Installing on Sun Solaris

Use this procedure to install the application on your Sun Solaris server. Note that separate procedures are provided, depending on whether you are running the automounter.

Steps

If you are running the automounter (the Solaris default):

1. Log in to the account you created previously.

2. Insert the WebLogic Integration - Business Connect CD into the CD-ROM drive.

3. From the home directory, run the following command:

   /cdrom/solaris/install.sh

4. Follow the instructions in the installation process.

5. Eject the WebLogic Integration - Business Connect CD by running the following command:

   eject cdrom

If you are not running the automounter:

1. Insert the WebLogic Integration - Business Connect CD into the CD-ROM drive.

2. Log in as root.

3. Run the command:

   mount /dev/sr? /mnt

   where /dev/sr? is the device name of your CD-ROM. Possible values are 0 through 9. If you have only one CD-ROM, its number is probably 0.

4. Log out as root.

5. Log in to the account you created previously.

6. From the home directory, run the following command:

   /mnt/solaris/install.sh

7. Follow the instructions in the installation process.

8. Log out from the account.

9. Log in as root.

10. Unmount the WebLogic Integration - Business Connect CD by running the following command:

    umount /mnt

11. Eject the WebLogic Integration - Business Connect CD from the CD-ROM drive.

12. Log out as root.

 

---

Uninstalling on UNIX

Use this procedure to remove WebLogic Integration - Business Connect from your UNIX computer.

Steps

1. Log in to the account you created previously.

2. Shut down all WebLogic Integration - Business Connect applications.

3. Run the following command:

   rm -rf installation_directory

   All program files and documents are removed from your computer.