Oracle Instant Client Preinstallation Tasks

Check the System Architecture

To determine whether the system architecture can run the software, enter the following command:

$ arch

This command displays the processor type. The command output must be arm64. If you do not see the expected output, then you cannot install the software on this system.

Disk Space Requirements

The minimum disk space requirement for software files for Oracle Instant Client 23ai is 100 MB.

To determine the amount of free disk space available, enter the following command in a terminal window:

$ df -h

Checking the Software Requirements for Apple macOS (ARM64)

Depending on the products that you intend to install, verify that the following software is installed on your Apple macOS (ARM64) system.

Item	Requirement
Operating system	The following or later versions of the operating system are supported: Apple macOS 13.6 or later
Tools	LLVM Clang version 17.0.6. You can install LLVM Clang 17.0.6 from MacPorts. Java version: 11
Pro*C/C++, Oracle Call Interface, Oracle C++ Call Interface	The version of the Clang compiler listed previously is supported for use with these products.
Oracle JDBC/OCI Drivers	You must use JDBC-OCI 11 or later versions with the JNDI extension.
Oracle ODBC Driver	Download and install unixODBC-2.3.11 or later at http://www.unixodbc.org

Use this procedure to gather information about your system.

To determine the operating system version, enter the following command:
```
$ sw_vers
```
The output of this command is similar to the following:
```
ProductName:    macOS
ProductVersion: 13.6.6
BuildVersion:   22G436
```
Note:

Only the versions listed in the previous table are supported. Do not install the software on other versions of Apple macOS.
To determine if the required version of Clang is installed, enter the following command:
```
$ gcc -v
```
This command returns output similar to the following:
```
Clang version 17.0.6
Target: arm64-apple-darwin22.6.0
Thread model: posix
InstalledDir: /opt/local/libexec/llvm-17/bin
```
https://developer.apple.com/

Oracle Instant Client Basic Light Character Sets

All Oracle Instant Client installations require a Basic or Basic Light package. If you plan to use Oracle Instant Client Basic 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
Character sets:
- Single byte
  - US7ASCII
  - WE8DEC
  - WE8MSWIN1252
  - WE8ISO8859P1
- Unicode
  - UTF8
  - AL16UTF16
  - AL32UTF8
  Oracle Instant Client Basic Light can connect to databases having one of the following database character sets:
  - US7ASCII
  - WE8DEC
  - WE8MSWIN1252
  - WE8ISO8859P1
  - WE8EBCDIC37C
  - WE8EBCDIC1047
  - UTF8
  - AL32UTF8

Oracle Instant Client Basic Light can also operate with the OCI Environment handles created in the OCI_UTF16 mode.

The language, territory, and character sets are determined by the NLS_LANG environment variable.

Note:

Ensure that you set the NLS_LANG environment variable to the required character set before you run your applications that use Oracle Instant Client Libraries.