PK
+Aoa, mimetypeapplication/epub+zipPK +A iTunesMetadata.plist&
This chapter provides information about the hardware and software requirements and the installation procedure for Oracle Database Gateway for Informix.
To install the gateway, follow these steps:
Ensure that the system meets all of the hardware and software requirements specified in "System Requirements for Oracle Database Gateway for Informix".
Run the Oracle Universal Installer.
See "Step Through the Oracle Universal Installer" for more information about running the Oracle Universal Installer
Oracle Universal Installer is a menu-driven utility that guides you through the installation of the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform.
See Table 4-3 for a description of the installation procedure of Oracle Database Gateway for Informix.
This section provides information about the hardware and software requirements for the gateway. It contains the following sections:
Table 4-1 lists the minimum hardware requirements for Oracle Database Gateway for Informix.
Table 4-1 Hardware requirements for Oracle Database Gateway for Informix
Hardware Items | Required for AIX-Based System | Required for HP-UX Itanium | Required for Solaris Operating System (SPARC) | Required for Linux x86 | Required for Linux x86 64 bit |
---|---|---|---|---|---|
Temporary Disk Space |
400 MB |
400 MB |
400 MB |
400 MB |
400 MB |
Disk Space |
1.5 GB |
1.5 GB |
750 MB |
750 MB |
750 MB |
Physical Memory* |
512 MB |
512 MB |
512 MB |
512 MB |
512 MB |
Swap Space |
1 GB |
1 GB |
1 GB |
1 GB |
1 GB |
Processor |
IBM RS/6000 AIX-Based System Processor |
HP Itanium processor for hp-ux 11 |
Sun Solaris Operating System (SPARC) Processor |
x86 |
x86_64 |
* The minimum swap space is 1 GB (or twice the size of RAM). On systems with 2 GB or more of RAM, the swap space can be between one and two times the size of RAM. On AIX systems with 1 GB or more of memory, do not increase the swap space more than 2 GB.
To ensure that the system meets the minimum requirements, follow these steps:
To determine the physical RAM size, enter one of the following commands:
Operating System | Command |
---|---|
AIX | # /usr/sbin/lsattr -E -l sys0 -a realmem |
HP-UX Itanium | # /usr/contrib/bin/machinfo | grep -i Memory |
Solaris (SPARC) | # /usr/sbin/prtconf | grep "Memory size" |
Linux x86 | # grep MemTotal /proc/meminfo |
Linux x86 64 bit | # grep MemTotal /proc/meminfo |
If the size of the physical RAM installed in the system is less than the required size, you must install more memory before continuing.
To determine the size of the configured swap space, enter one of the following commands:
Operating System | Command |
---|---|
AIX | # /usr/sbin/lsps -a |
HP-UX Itanium | # /usr/sbin/swapinfo -a |
Solaris (SPARC) | # /usr/sbin/swap -s |
Linux x86 | # grep SwapTotal /proc/meminfo |
Linux x86 64 bit | # grep SwapTotal /proc/meminfo |
If necessary, see your operating system documentation for information about how to configure additional swap space.
To determine the amount of disk space available in the /tmp
directory enter the following commands:
Operating System | Command |
---|---|
AIX | # df -k /tmp |
HP-UX Itanium | # bdf /tmp |
Solaris (SPARC) | # df -k /tmp |
Linux x86 | # df -k /tmp |
Linux x86 64 bit | # df -k /tmp |
To determine the amount of disk space available on the system enter the following commands:
Operating System | Command |
---|---|
AIX | # df -k |
HP-UX Itanium | # bdf |
Solaris (SPARC) | # df -k |
Linux x86 | # df -k |
Linux x86 64 bit | # df -k |
The following section describes the minimum software requirements for Oracle Database Gateway for Informix.
Table 4-2 lists the minimum operating system version required for Oracle Database Gateway for Informix. If your operating system is lower than the minimum requirements, upgrade your operating system to meet the specified levels.
Table 4-2 Operating Systems version for Oracle Database Gateway for Informix
Operating System | Version |
---|---|
AIX |
AIX 5L version 5.3 TL9 or higher, AIX 6.1 |
HP-UX Itanium |
HP-UX 11iv3 (11.31) |
Solaris (SPARC) |
Solaris 10, (Update 6 or later) |
Linux x86 Red Hat |
One of the following operating system versions:
|
Linux x86 64 bit Red Hat |
One of the following operating system versions:
|
Oracle Linux x86 |
One of the following operating system versions:
|
Oracle Linux x86 64 bit |
One of the following operating system versions:
|
Asianux Linux 32 bit |
One of the following operating system versions:
|
Asianux Linux 64 bit |
One of the following operating system versions:
|
SUSE Linux Enterprise Server 32 bit |
SUSE Linux Enterprise Server 10.0 SUSE Linux Enterprise Server 11.0 |
SUSE Linux Enterprise Server 64 bit |
SUSE Linux Enterprise Server 10.0 SUSE Linux Enterprise Server 11.0 |
To ensure that the system meets the minimum requirements, follow these steps:
To determine which version of AIX is installed, enter the following command:
# oslevel -r
To determine which version of HP-UX Itanium is installed, enter the following command:
# uname -a
To determine which version of Solaris Operating System (SPARC) is installed, enter the following command:
# uname -r
To determine which distribution and version of Linux x86 is installed, enter the following command:
# cat /etc/issue
To determine which distribution and version of Linux x86 64 bit is installed, enter the following command:
# cat /proc/version
The gateway supports Informix Dynamic Server. For the latest versions supported refer to the OTN Web site:
http://www.oracle.com/technetwork/database/gateways/certmatrix-168347.pdf
Table 4-3 describes the installation procedure for Oracle Database Gateway for Informix.
Table 4-3 The Oracle Universal Installer: Steps for Installing the Gateway
Screen | Response |
---|---|
Oracle Universal Installer: Welcome |
Click Next. |
Oracle Universal Installer: File Locations |
The Source section of the screen is where you specify the source location that the Oracle Universal Installer must use to install the Oracle Database Gateway for Informix. You need not edit the file specification in the Path field. The default setting for this field points to the installer file on your Oracle Database Gateway installation media. The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to |
Oracle Universal Installer: Available Product Components |
a. Select Oracle Database Gateway for Informix 11.2. b. Click Next. |
Oracle Database Gateway for Informix |
Informix Database Server Host Name - Specify the host name or the IP address of the machine hosting the Informix database server. This release supports IPv6 format. Informix Database Server Port number - Specify the port number of the Informix database server Informix Server Name - Specify the Informix server name Informix Database Name - Specify the Informix database name Click Next to continue. |
Oracle Universal Installer: Summary |
The Installation Summary screen enables you to review a tree list of options and components for this installation. Click Install to start installation. |
Oracle Net Configuration Assistant: Welcome |
Click Cancel |
Oracle Net Configuration Assistant: |
Click Yes |
Oracle Universal Installer: Configuration Tools |
Click Exit |
Exit |
The final screen of the Oracle Universal Installer is the End of Installation screen. Click Exit to exit the installer. |
This chapter provides information about the hardware and software requirements and the installation procedure for Oracle Database Gateway for ODBC.
To install the gateway, follow these steps:
Ensure that the system meets all of the hardware and software requirements specified in "System Requirements for Oracle Database Gateway for ODBC"
Run the Oracle Universal Installer.
See "Step Through the Oracle Universal Installer" for more information about running the Oracle Universal Installer
Oracle Universal Installer is a menu-driven utility that guides you through the installation of the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform.
See Table 10-3 for a description of the installation procedure of Oracle Database Gateway for ODBC
This section provides information about the hardware and software requirements for the gateway. It contains the following sections:
"Hardware Requirements" on page 10-1
"Software Requirements" on page 10-3
Table 10-1 lists the minimum hardware requirements for Oracle Database Gateway for ODBC.
Table 10-1 Hardware requirements for Oracle Database Gateway for ODBC
Hardware Items | Required for AIX-Based System | Required for HP-UX Itanium | Required for Solaris Operating System (SPARC) | Required for Linux x86 | Required for Linux x86 64 bit** |
---|---|---|---|---|---|
Temporary Disk Space |
400 MB |
400 MB |
400 MB |
400 MB |
400 MB |
Disk Space |
1.5 GB |
1.5 GB |
750 MB |
750 MB |
750 MB |
Physical Memory* |
512 MB |
512 MB |
512 MB |
512 MB |
512 MB |
Swap Space |
1 GB |
1 GB |
1 GB |
1 GB |
1 GB |
Processor |
IBM RS/6000 AIX-Based System Processor |
HP Itanium processor for hp-ux 11 |
Sun Solaris Operating System (SPARC) Processor |
x86 |
x86_64 |
* The minimum swap space is 1 GB (or twice the size of RAM). On systems with 2 GB or more of RAM, the swap space can be between one and two times the size of RAM. On AIX systems with 1 GB or more of memory, do not increase the swap space more than 2 GB.
** Database Gateway for ODBC on Linux x86-64 is now a 64-bit application that requires the use of a 64-bit third party ODBC Driver
To ensure that the system meets the minimum requirements, follow these steps:
To determine the physical RAM size, enter one of the following commands:
Operating System | Command |
---|---|
AIX | # /usr/sbin/lsattr -E -l sys0 -a realmem |
HP-UX Itanium | # /usr/contrib/bin/machinfo | grep -i Memory |
Solaris (SPARC) | # /usr/sbin/prtconf | grep "Memory size" |
Linux x86 | # grep MemTotal /proc/meminfo |
Linux x86 64 bit | # grep MemTotal /proc/meminfo |
If the size of the physical RAM installed in the system is less than the required size, you must install more memory before continuing.
To determine the size of the configured swap space, enter one of the following commands:
Operating System | Command |
---|---|
AIX | # /usr/sbin/lsps -a |
HP-UX Itanium | # /usr/sbin/swapinfo -a |
Solaris (SPARC) | # /usr/sbin/swap -s |
Linux x86 | # grep SwapTotal /proc/meminfo |
Linux x86 64 bit | # grep SwapTotal /proc/meminfo |
If necessary, see your operating system documentation for information about how to configure additional swap space.
To determine the amount of disk space available in the /tmp
directory enter the following commands:
Operating System | Command |
---|---|
AIX | # df -k /tmp |
HP-UX Itanium | # bdf /tmp |
Solaris (SPARC) | # df -k /tmp |
Linux x86 | # df -k /tmp |
Linux x86 64 bit | # df -k /tmp |
To determine the amount of disk space available on the system enter the following commands:
Operating System | Command |
---|---|
AIX | # df -k |
HP-UX Itanium | # bdf |
Solaris (SPARC) | # df -k |
Linux x86 | # df -k |
Linux x86 64 bit | # df -k |
The following section describes the minimum software requirements for Oracle Database Gateway for ODBC.
Table 10-3 lists the minimum operating system version required for Oracle Database Gateway for ODBC. If your operating system is lower than the minimum requirements, upgrade your operating system to meet the specified levels.
Table 10-2 Operating Systems version for Oracle Database Gateway for ODBC
Operating System | Version |
---|---|
AIX |
AIX 5L version 5.3 TL9 or higher, AIX 6.1 |
HP-UX Itanium |
HP-UX 11iv3 (11.31) |
Solaris (SPARC) |
Solaris 10, (Update 6 or later) |
Linux x86 Red Hat |
One of the following operating system versions:
|
Linux x86 64 bit Red Hat |
One of the following operating system versions:
|
Oracle Linux x86 |
One of the following operating system versions:
|
Oracle Linux x86 64 bit |
One of the following operating system versions:
|
Asianux Linux 32 bit |
One of the following operating system versions:
|
Asianux Linux 64 bit |
One of the following operating system versions:
|
SUSE Linux Enterprise Server 32 bit |
SUSE Linux Enterprise Server 10.0 SUSE Linux Enterprise Server 11.0 |
SUSE Linux Enterprise Server 64 bit |
SUSE Linux Enterprise Server 10.0 SUSE Linux Enterprise Server 11.0 |
To ensure that the system meets the minimum requirements, follow these steps:
To determine which version of AIX is installed, enter the following command:
# oslevel -r
To determine which version of HP-UX Itanium is installed, enter the following command:
# uname -a
To determine which version of Solaris Operating System (SRPARC) is installed, enter the following command:
# uname -r
To determine which distribution and version of Linux x86 is installed, enter the following command:
# cat /etc/issue
To determine which distribution and version of Linux x86 64 bit is installed, enter the following command:
# cat /proc/version
For the latest certified configuration refer to the OTN Web site:
http://www.oracle.com/technetwork/database/gateways/certmatrix-168347.pdf
Table 10-3 describes the installation procedure for Oracle Database Gateway for ODBC.
Table 10-3 The Oracle Universal Installer: Steps for Installing Oracle Database Gateway for ODBC
Screen | Response |
---|---|
Oracle Universal Installer: Welcome |
Click Next. |
Oracle Universal Installer: File Locations |
The Source section of the screen is where you specify the source location that the Oracle Universal Installer must use to install the Oracle Database Gateway for ODBC. You need not edit the file specification in the Path field. The default setting for this field points to the installer file on your gateway installation media. The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to |
Oracle Universal Installer: Available Product Components |
a. Select Oracle Database Gateway for ODBC 11.2. b. Click Next. |
Oracle Universal Installer: Summary |
The Installation Summary screen enables you to review a tree list of options and components for this installation. Click Install to start installation. |
Oracle Net Configuration Assistant: Welcome |
Click Cancel |
Oracle Net Configuration Assistant: |
Click Yes |
Oracle Universal Installer: Configuration Tools |
Click Exit |
Exit |
The final screen of the Oracle Universal Installer is the End of Installation screen. Click Exit to exit the installer. |
Part VIII, "Removing Oracle Database Gateway" describes how to remove Oracle Database Gateway.
It contains the following chapter:
The table below is a worksheet that lists all of the parameter names and the reasons that you will need them for configuring the gateway and TCP/IP. Use the worksheet to gather the specific information that you need before you begin the configuration process.
Table D-1 List of Parameters Needed to Configure the Gateway
Reason | Name of Parameter Needed | Your Specific Parameters Here |
---|---|---|
Oracle home of the gateway |
| |
System ID of the gateway |
| |
Remote collection ID |
| |
Configuring TCP/IP |
Local Hostname, Domain Name | |
Configuring TCP/IP |
IP Address | |
Configuring TCP/IP |
Network Mask | |
Configuring TCP/IP |
Name Server IP Address | |
Configuring TCP/IP | ||
Configuring TCP/IP | ||
Recovery user ID |
| |
Recovery Password |
| |
Remote Database Name |
| |
Owner ID of DRDA package |
| |
DB Name used with Oracle database |
| |
DB Domain used with Oracle database |
|
Note: The user ID that is used to bind or rebind the DRDA package must have the appropriate privileges on the remote database as described in Chapter 13, "Configuring the DRDA Server". Your database administrator will need to provide these privileges. |
Installation and Configuration Guide
11g Release 2 (11.2) for AIX 5L Based Systems (64-Bit), HP-UX Itanium, Solaris Operating System (SPARC 64-Bit), Linux x86, and Linux x86-64
E12013-07
January 2012
Oracle Database Gateway Installation and Configuration Guide, 11g Release 2 (11.2) for AIX 5L Based Systems (64-Bit), HP-UX Itanium, Solaris Operating System (SPARC 64-Bit), Linux x86, and Linux x86-64
E12013-07
Copyright © 2006, 2012, Oracle and/or its affiliates. All rights reserved.
Primary Author: Maitreyee Chaliha
Contributor: Vira Goorah, Den Raphaely, Govind Lakkoju, Peter Wong, Juan Pablo Ahues-Vasquez, Peter Castro, and Charles Benet
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.
Part II, "Installing and Configuring Oracle Database Gateway for Sybase" describes how to install and configure Oracle Database Gateway for Sybase on UNIX based platforms.
It contains the following chapters:
This appendix describes how to install and configure Oracle products using response files. It includes the following topics:
You can automate the installation and configuration of Oracle software, either fully or partially, by specifying a response file when you start Oracle Universal Installer. Oracle Universal Installer uses the values contained in the response file to provide answers to some or all of Oracle Universal Installer prompts:
If you include responses for all of the prompts in the response file and specify the -silent
option when starting Oracle Universal Installer, then Oracle Universal Installer runs in silent mode. During a silent-mode installation, Oracle Universal Installer does not display any screens. Instead, it displays progress information in the terminal that you used to start it.
If you include responses for some or all of the prompts in the response file and omit the -silent
option, then Oracle Universal Installer runs in suppressed mode. During a suppressed-mode installation, Oracle Universal Installer displays only the screens for which you did not specify all required information. You can also use variables in the response file or command-line options to suppress other installer screens, such as the Welcome screen or Summary screen, that do not prompt for information.
The following table describes several reasons why you might want to run Oracle Universal Installer in silent mode or suppressed mode:
Mode | Uses |
---|---|
Silent | Use silent mode if you want to:
Oracle Universal Installer displays progress information in the terminal that you used to start it, but it does not display any of Oracle Universal Installer screens. |
Suppressed | Use suppressed mode if you want to complete similar Oracle software installations on more than one system, providing default answers to some, but not all of Oracle Universal Installer prompts.
If you do not specify information required for a particular Installer screen in the response file, Oracle Universal Installer displays that screen. It suppresses screens for which you have provided all of the required information. |
To install and configure Oracle products using Oracle Universal Installer in silent or suppressed mode, follow these steps:
Create the oraInst.loc
file.
Prepare a response file.
Run Oracle Universal Installer in silent or suppressed mode.
These steps are described in the following sections.
If you plan to install Oracle products using Oracle Universal Installer in silent or suppressed mode, you must manually create the oraInst.loc
file if it does not already exist. This file specifies the location of the Oracle Inventory directory where Oracle Universal Installer creates the inventory of Oracle products installed on the system.
Note: If Oracle software has been installed previously on the system, theoraInst.loc file might already exist. If the file does exist, you do not need to create a file. |
To create the oraInst.loc
file, follow these steps:
Switch user to root:
On Solaris (SPARC), create the /var/opt/oracle
directory if it does not exist:
# mkdir /var/opt/oracle
Change directory as follows, depending on your operating system:
AIX:
# cd /etc
Solaris (SPARC):
# cd /var/opt/oracle
Enter the following commands to set the appropriate owner, group, and permissions on the oraInst.loc
file:
# chown oracle:oinstall oraInst.loc # chmod 664 oraInst.loc
This section describes the methods that you can use to prepare a response file for use during silent-mode or suppressed-mode installations:
Oracle provides response file templates for each product and installation type, and for each configuration tool. The response files for Oracle Gateways, tg.rsp
and netca.rsp
are located in the response
directory on the media.
Note: If you copied the software to a hard disk, the response files are located in theDisk1/response directory. |
To prepare a response file:
Copy the response file from the response file directory to a directory on your system:
$ cp /directory_path
/response/response_file.rsp local_directory
In this example, directory_path
is the CD-ROM mount point directory or the directory on the DVD. If you have copied the software to a hard drive, you can edit the file in the response
directory if you prefer.
Open the response file in a text editor:
$ vi /local_dir
/response_file.rsp
Edit the file, following the instructions in the file.
Note: Oracle Universal Installer or configuration assistant fails if you do not correctly configure the response file. Refer to the "Silent-Mode Response File Error Handling" section for more information about troubleshooting a failed silent-mode installation. |
Change the permissions on the file to 700:
$ chmod 700 /local_dir/response_file.rsp
This method is most useful for Custom or software-only installations.
You can use Oracle Universal Installer in interactive mode to record a response file that you can edit and then use to complete silent-mode or suppressed-mode installations. When you are recording the response file, you can either complete the installation, or you can exit from Oracle Universal Installer on the Summary page, before it starts to copy the software to the system.
To record a new response file:
Complete the pre-installation tasks listed in respective chapters.
When you run Oracle Universal Installer to record a response file, it checks the system to verify that it meets the requirements to install the software. For this reason, Oracle recommends that you complete all of the required pre-installation tasks and record the response file while completing an installation.
If you have not installed Oracle software on this system previously, create the oraInst.loc
file, as described in the previous section.
Ensure that the Oracle software owner user (typically oracle
) has permissions to create or write to the Oracle home path that you will specify when you run Oracle Universal Installer.
To record a response file, enter a command similar to the following to start Oracle Universal Installer:
Note: Do not specify a relative path to the response file. If you specify a relative path, Oracle Universal Installer fails. |
$ /directory_path/runInstaller -record -destinationFile filename
In the previous example:
directory_path
is either the CD-ROM mount point directory, the path of the directory on the DVD, or the path of the Disk1
directory on the hard drive
The -record
parameter specifies that you want to record the responses that you enter in a response file
filename
is the full path and file name of the response file that you want to record
On each Installer screen, specify the required information.
When Oracle Universal Installer displays the Summary screen, do one of the following:
Click Install to create the response file, then continue with the installation.
Click Cancel, then Yes to create the response file but exit from Oracle Universal Installer without installing the software.
The response file is saved in the location that you specified using the -destinationFile
option.
If you did not complete the installation, delete the Oracle home directory that Oracle Universal Installer created using the path you specified on the Specify File Locations screen.
Before using the recorded response file on another system, use a text editor to edit the file and make any required changes.
Use the comments in the file as a guide when editing it.
To run Oracle Universal Installer in silent or suppressed mode, follow these steps:
Complete the pre-installation tasks listed in the respective chapters.
Log in as the Oracle software owner user (typically oracle
).
To start Oracle Universal Installer in silent or suppressed mode, enter a command similar to the following:
$ $ /directory_path/runInstaller -silent -noconfig -responseFile filename
Note: Do not specify a relative path to the response file. If you specify a relative path, Oracle Universal Installer fails. |
In this example:
directory_path
is either the installation media mount point directory, the path of the directory on the DVD, or the path of the Disk1
directory on the hard drive.
-silent
indicates that you want to run Oracle Universal Installer in silent mode.
-noconfig
suppresses running the configuration assistants during installation, and a software-only installation is performed instead.
filename
is the full path and file name of the installation response file that you configured.
Note: For more information about other options for therunInstaller command, enter the following command:
$ /directory_path/runInstaller -help
|
This appendix contains information about troubleshooting. It includes the following topics:
Before performing any of the troubleshooting steps in this appendix, ensure that the system meets the requirements and that you have completed all of the pre-installation tasks specified in respective chapters.
Read the Release Notes
Read the release notes for the product before installing it. The release notes are available on the Oracle Database 11g installation media. The latest version of the release notes is also available on the OTN Web site:
http://www.oracle.com/technetwork/documentation/index.html
If you encounter an error during installation:
Do not exit Oracle Universal Installer.
If you clicked Next after you entered incorrect information about one of the installation screens, then click Back to return to the screen and correct the information.
If you encounter an error while Oracle Universal Installer is copying or linking files, see the "Reviewing the Log of an Installation Session" section.
If you encounter an error while a configuration assistant is running, see the "Troubleshooting Configuration Assistants" section.
If you cannot resolve the problem, then remove the failed installation by following the steps listed in the "Cleaning Up After a Failed Installation" section.
During an installation, Oracle Universal Installer records all the actions that it performs, in a log file. If you encounter problems during the installation, then review the log file for information about possible causes of the problem.
To view the log file, follow these steps:
If necessary, enter the following command to determine the location of the oraInventory
directory:
For AIX and Linux:
$ cat /etc/oraInst.loc
For Solaris SPARC:
# more /var/opt/oracle/oraInst.loc
The inventory_loc
parameter in this file specifies the location of the oraInventory
directory.
Enter the following command to change directory to Oracle Universal Installer log file directory, where orainventory_location
is the location of the oraInventory
directory:
$ cd /orainventory_location/logs
Enter the following command to determine the name of the log file:
$ ls -ltr
This command lists the files in the order of creation, with the most recent file shown last. Installer log files have names similar to the following, where date_time
indicates the date and time that the installation started:
installActionsdate_time.log
To view the most recent entries in the log file, where information about a problem is most likely to appear, enter a command similar to the following:
$ tail -50 installActionsdate_time.log | more
This command displays the last 50 lines in the log file.
If the error displayed by Oracle Universal Installer or listed in the log file indicates a relinking problem, refer to the following file for more information:
$ORACLE_HOME/install/make.log
To troubleshoot an installation error that occurs when a configuration assistant is running:
Review the installation log files listed in the "Reviewing the Log of an Installation Session" section.
Review the specific configuration assistant log file located in the $ORACLE_HOME/cfgtoollogs
directory. Try to fix the issue that caused the error.
If you see the "Fatal Error. Reinstall" message, look for the cause of the problem by reviewing the log files. Refer to the "Fatal Errors" section for further instructions.
Oracle configuration assistant failures are noted at the bottom of the installation screen. The configuration assistant interface displays additional information, if available. The configuration assistant execution status is stored in the following file:
oraInventory_location/logs/installActionsdate_time.log
The execution status codes are listed in the following table:
Status | Result Code |
---|---|
Configuration assistant succeeded | 0 |
Configuration assistant failed | 1 |
Configuration assistant cancelled | -1 |
If you receive a fatal error while a configuration assistant is running then:
Remove the failed installation as described in the "Cleaning Up After a Failed Installation" section.
Correct the cause of the fatal error.
Reinstall the Oracle software.
To determine whether a silent-mode installation succeeds or fails, refer to the following log file:
/oraInventory_location/logs/silentInstalldate_time.log
If necessary, refer to the previous section for information about determining the location of the oraInventory
directory.
A silent installation fails if:
You do not specify a response file
You specify an incorrect or incomplete response file
Oracle Universal Installer encounters an error, such as insufficient disk space
Oracle Universal Installer or configuration assistant validates the response file at run time. If the validation fails, then the silent-mode installation or configuration process ends. Oracle Universal Installer treats values for parameters that are of the wrong context, format, or type as if no value was specified in the file.
If an installation fails, you must remove files that Oracle Universal Installer created during the attempted installation and remove the Oracle home directory. Perform the following steps to remove the files:
Start Oracle Universal Installer as described in the "Running the Oracle Universal Installer" section.
Click Deinstall Products on the Welcome window or click Installed Products on any Installer window.
The Inventory window appears, listing installed products.
Select the Oracle home that contains the products that you want to remove, then click Remove.
Manually remove the Oracle home directory created during the failed installation.
Reinstall the Oracle software.
This chapter provides information about the hardware and software requirements and the installation procedure of Oracle Database Gateway for DRDA.
To install the gateway, follow these steps:
Ensure that the system meets all of the hardware and software requirements specified in "System Requirements for Oracle Database Gateway for DRDA".
Run the Oracle Universal Installer.
See "Step through the Oracle Universal Installer" for more information about running the Oracle Universal Installer.
Oracle Universal Installer is a menu-driven utility that guides you through the installation of the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform.
See Table 12-3 for a description of the installation procedure of Oracle Database Gateway for DRDA.
This section provides information about the hardware and software requirements for the gateway. It contains the following sections:
Table 12-1 lists the minimum hardware requirements for Oracle Database Gateway for DRDA.
Table 12-1 Hardware requirements for Oracle Database Gateway for DRDA
Hardware Items | Required for AIX-Based System | Required for HP-UX Itanium 64 bit | Required for Solaris Operating System (SPARC) | Required for Linux x86 | Required for Linux x86 64 bit | Required for Linux Itanium 64 bit |
---|---|---|---|---|---|---|
Temporary Disk Space |
400 MB |
400 MB |
400 MB |
400 MB |
400 MB |
400 MB |
Disk Space |
1.5 GB |
1.5 GB |
1.5 GB |
1.5 GB |
1.5 GB |
1.5 GB |
Physical Memory* |
256 MB |
256 MB |
256 RAM |
256 RAM |
256 RAM |
256 RAM |
Swap Space |
1 GB |
1 GB |
1 GB |
1 GB |
1 GB |
1 GB |
Processor |
IBM pSeries |
Intel Itanium that can run the required version of HP-UX |
A Solaris Operating System (SPARC 64-bit) that can run the required version of Solaris with 64-bit architecture |
x86 |
x86_64 |
Intel Itanium that can run the required version of Linux |
* The minimum swap space is 1 GB (or twice the size of RAM). On systems with 2 GB or more of RAM, the swap space can be between one and two times the size of RAM. On AIX systems with 1 GB or more of memory, do not increase the swap space more than 2 GB.
For most installations, a minimum of 256 MB of real memory is recommended for the first user to support the Oracle Database Gateway for DRDA.
The total real memory requirement for each concurrent use of the gateway depends on the following factors:
Number of data items being transferred between the gateway and the remote transaction program
Additional factors such as configured network buffer size
To ensure that the system meets the minimum requirements, follow these steps:
To determine the physical RAM size, enter one of the following commands:
Operating System | Command |
---|---|
AIX | # /usr/sbin/lsattr -E -l sys0 -a realmem |
HP-UX Itanium 64 bit | # /usr/sbin/dmesg | grep "Physical:" |
Solaris (SPARC) | # /usr/sbin/prtconf | grep "Memory size" |
Linux x86 | # grep MemTotal /proc/meminfo |
Linux x86 64 bit | # grep MemTotal /proc/meminfo |
Linux Itanium 64 bit | # grep MemTotal /proc/meminfo |
If the size of the physical RAM installed in the system is less than the required size, you must install more memory before continuing.
To determine the size of the configured swap space, enter one of the following commands:
Operating System | Command |
---|---|
AIX | # /usr/sbin/lsps -a |
HP-UX Itanium 64 bit | # /usr/sbin/swapinfo -a |
Solaris (SPARC) | # /usr/sbin/swap -s |
Linux x86 | # grep SwapTotal /proc/meminfo |
Linux x86 64 bit | # grep SwapTotal /proc/meminfo |
Linux Itanium 64 bit | # grep SwapTotal /proc/meminfo |
If necessary, see your operating system documentation for information about how to configure additional swap space.
To determine the amount of disk space available in the /tmp
directory enter the following commands:
Operating System | Command |
---|---|
AIX | # df -k /tmp |
HP-UX Itanium 64 bit | # df -k /tmp |
Solaris (SPARC) | # df -k /tmp |
Linux x86 | # df -k /tmp |
Linux x86 64 bit | # df -k /tmp |
Linux Itanium 64 bit | # df -k /tmp |
To determine the amount of disk space available on the system enter the following commands:
Operating System | Command |
---|---|
AIX | # df -k |
HP-UX Itanium 64 bit | # df -k |
Solaris (SPARC) | # df -k |
Linux x86 | # df -k |
Linux x86 64 bit | # df -k |
Linux Itanium 64 bit | # df -k |
The following section describes the minimum software requirements for Oracle Database Gateway for DRDA.
Table 12-2 lists the minimum operating system version required for Oracle Database Gateway for DRDA. If your operating system is lower than the minimum requirements, upgrade your operating system to meet the specified levels.
Table 12-2 Operating Systems version for Oracle Database Gateway for DRDA
Operating System | Version |
---|---|
AIX |
AIX 5L version 5.3 TL9 or higher, AIX 6.1 |
HP-UX Itanium |
HP-UX 11iv3 (11.31) |
Solaris (SPARC) |
Solaris 10, (Update 6 or later) |
Linux x86 Red Hat |
One of the following operating system versions:
|
Linux x86 64 bit Red Hat |
One of the following operating system versions:
|
Oracle Linux x86 |
One of the following operating system versions:
|
Oracle Linux x86 64 bit |
One of the following operating system versions:
|
Asianux Linux 32 bit |
One of the following operating system versions:
|
Asianux Linux 64 bit |
One of the following operating system versions:
|
SUSE Linux Enterprise Server 32 bit |
SUSE Linux Enterprise Server 10.0 SUSE Linux Enterprise Server 11.0 |
SUSE Linux Enterprise Server 64 bit |
SUSE Linux Enterprise Server 10.0 SUSE Linux Enterprise Server 11.0 |
To ensure that the system meets the minimum requirements, follow these steps:
To determine which version of AIX is installed, enter the following command:
# oslevel -r
To determine which version of Solaris Operating System (SPARC) is installed, enter the following command:
# uname -r
To determine which distribution and version of Linux x86 is installed, enter the following command:
# cat /etc/issue
To determine which distribution and version of Linux x86 64 bit is installed, enter the following command:
# cat /proc/version
The gateway supports DB2 UDB for Linux, Unix and Windows, DB2 UDB for z/OS, and DB2 UDB for iSeries. For the latest versions supported refer to the OTN Web site:
http://www.oracle.com/technetwork/database/gateways/mainframe-certification-129156.pdf
Start the Installer with the following command:
$ ./runInstaller
Table 12-3 describes the installation procedure for Oracle Database Gateway for DRDA.
Table 12-3 The Oracle Universal Installer: Steps for Installing the Gateway
Screen | Response |
---|---|
Oracle Universal Installer: Welcome |
Click Next. |
Oracle Universal Installer: Specify Home Details |
Specify a name for the installation in the Name field. You can also choose not to edit the default setting of the Name field of the Specify Home Details screen. The Path field in the Specify Home Details screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to |
Oracle Universal Installer: Available Product Components |
a. Select Oracle Database Gateway for DRDA 11.2. b. Click Next. |
Oracle Universal Installer: DB2 UDB Server hostname or IP address |
Specify the host name or the IP address of the machine hosting the DB2 UDB database server. This release supports IPv6 format. |
Oracle Universal Installer: DB2 UDB DRDA server listener port |
Specify the port number DB2 DRDA process listens on. |
Oracle Universal Installer: DB2 UDB Database Name |
Specify the DB2 UDB database name. |
Oracle Universal Installer: DB2 UDB target type |
For DB2 UDB running on z/OS specify ZOS. For DB2 UDB running on iSeries or AS/400 machines specify IOS. For DB2 UDB running on Linux, Unix, or Windows platforms specify LUW. |
Oracle Universal Installer: Summary |
The Installation Summary screen enables you to review a tree list of options and components for this installation. Click Install to start installation. |
Oracle Net Configuration Assistant: Welcome |
Click OK. |
Oracle Net Configuration Assistant: |
Click Typical configuration. |
Oracle Universal Installer: Configuration Tools |
Click Exit. |
Exit |
The final screen of the Oracle Universal Installer is the End of Installation screen. Click Exit to exit the installer. |