This chapter describes the tasks that you must complete before you install Oracle Instant Client. It includes the following information:
Before you install the Oracle software, you must complete several tasks as the root
user. To log in as the root
user, complete the following procedure:
If you are installing the software from an X Window System workstation or X terminal, then:
Start a local terminal session (xterm
).
If you are not installing the software on the local system, then enter the following command to enable the remote host to display X applications on the local X server:
$ xhost fully_qualified_remote_host_name
For example,
$ xhost somehost.us.acme.com
If you are not installing the software on the local system, then use the ssh
, rlogin
, or telnet
command to connect to the system where you want to install the software:
$ telnet fully_qualified_remote_host_name
If you are not logged in as the root
user, then enter the following command to switch user to root
:
$ su - root password: #
Note:
Unless you intend to complete a silent-mode installation, you must install the software from an X Window System workstation, an X terminal, or a PC or other system with X server software installed.If you are installing the software from a PC or other system with X server software installed, then:
Start the X server software.
Configure the security settings of the X server software to permit remote hosts to display X applications on the local system.
Connect to the remote system where you want to install the software and start a terminal session on that system, for example, an X terminal (xterm
).
If you are not logged in as the root
user on the remote system, then enter the following command to switch user to root
:
$ su - root password: #
Note:
If necessary, refer to your X server documentation for more information about completing this procedure. Depending on the X server software that you are using, you may need to complete the tasks in a different order.The system must meet the following minimum hardware requirements for Oracle Database Client 12c Release 1 (12.1):
The following are the memory requirements for Oracle Database Client 12c Release 1 (12.1):
256 MB of RAM.
To determine the physical RAM size, enter the following command:
# grep MemTotal /proc/meminfo
If the size of the physical RAM is less than the required size, then you must install more memory before continuing.
The following table describes the relationship between installed RAM and the configured swap space recommendation:
Note:
On Linux on POWER Systems, the HugePages feature allocates non-swappable memory for large page tables using memory-mapped files. If you enable HugePages, then you should deduct the memory allocated to HugePages from the available RAM before calculating swap space.Available RAM | Swap Space Required |
---|---|
Up to 256 MB | 3 times the size of RAM |
Between 257 MB and 512 MB | 2 times the size of RAM |
Between 513 MB and 726 MB | 1.5 times the size of RAM |
More than 726 MB | 0.75 times the size of RAM |
To determine the size of the configured swap space, enter the following command:
# grep SwapTotal /proc/meminfo
If necessary, see the operating system documentation for information about how to configure additional swap space.
To determine the available RAM and swap space, enter the following command:
# free
IMPORTANT:
Oracle recommends that you take multiple values for the available RAM and swap space before finalizing on a value. This is because the available RAM and swap space keep changing depending on the user interactions with the computer.
Contact the operating system vendor for swap space allocation guidance for your server. The vendor guidelines supersede the swap space requirements listed in this guide.
To determine whether the system architecture can run the software, enter the following command:
# uname -m
Note:
This command displays the processor type. Verify that the processor architecture matches the Oracle software release to install. If you do not see the expected output, then you cannot install the software on this system.The following are the disk space requirements for Oracle Database Client 12c Release 1 (12.1):
The minimum disk space requirement for a client install in the /tmp
directory is 120 MB. The minimum disk space requirement in the /tmp
directory depends on the installation type you have selected. The following table lists the minimum disk space requirements for the /tmp
directory in each type of installation.
To determine the amount of disk space available, enter the following command:
# df -k /tmp
If there is less than 120 MB of free space available in the /tmp
directory, then complete one of the following steps:
Delete unnecessary files from the /tmp
directory to meet the space requirement.
Set the TMP
and TMPDIR
environment variables when setting the oracle
user's environment.
Extend the file system that contains the /tmp
directory. If necessary, contact the system administrator for information about extending file systems.
To determine the amount of free disk space on the system, enter the following command:
# df -k
The client install requires 130 MB disk space for software files on Linux on POWER Systems.
The minimum display requirement for Oracle Database 12c Release 1 (12.1) is a resolution of 1024 x 768 or higher.
Depending on the products that you intend to install, verify that the following software is installed on the system:
If you want to use GNU Compiler Collection (GCC) as the primary compiler, see the "Configuring GCC as the Primary Compiler" section for instructions on configuring the primary compiler.
The following procedure describes how to verify and ensure that the system meets these requirements:
To determine which distribution and version of Linux is installed, enter the following command:
# cat /etc/issue
Note:
Only the distributions and versions listed in the previous table are supported. Do not install the software on other versions of Linux on POWER Systems.To determine whether the required kernel is installed, enter the following command:
# uname -r
The following is a sample output displayed by running this command on a Red Hat Enterprise Linux Server 7.1 system:
3.10.0-229.ael7b.ppc64le
In this example, the output shows the kernel version (3.10.0) and errata level (ael17b) on the system.
If the kernel version does not meet the requirement specified earlier in this section, then contact your operating system vendor for information about obtaining and installing kernel updates.
To determine whether the required packages are installed, enter commands similar to the following:
# rpm -q package_name
If a package is not installed, then install it from your Linux distribution media or download the required package version from your Linux vendor's website.
In addition to the requirements described in the preceding section, if you plan to use Instant Client Light, then the applications must use the following languages and character sets:
Language: Any language that is supported by Oracle.
Territory: Any territory that is supported by Oracle.
Single byte
US7ASCII
WE8DEC
WE8MSWIN1252
WE8ISO8859P1
WE8EBCDIC37C
for EBCDIC platforms only
WE8EBCDIC1047
for EBCDIC platforms only
Unicode
UTF8
AL32UTF8
AL16UTF16
The advantage of using Instant Client Light is that it has a smaller footprint than the regular Instant Client. The shared libraries, which an application must load, are only 34 MB as opposed to the 110 MB that regular Instant Client uses. Therefore, the applications use less memory.
The language, territory, and character sets are determined by the NLS_LANG
environment variable.
Note:
Ensure that you set theNLS_LANG
environment variable to the required character set before you run Oracle Database Instant Client.