Installing From Downloaded Files
- Last Updated: April 5, 2026
- 5 minute read
- OpenAccess SDK
- Version 9.0
- Documentation
The tar file you download from the Progress DataDirect Web site depends on the environment in which you will use OpenAccess SDK Server:
- oaserver32_unixos_version.tar for 32-bit environment
- oaserver64_unixos_version.tar for 64-bit environment
where unixos is the UNIX or Linux operating system, for example, sunos, and version is the OpenAccess SDK version number. When you run the installation script, you will be prompted for choices you need to make and information you need to enter. Default answers to questions are enclosed in square brackets, [ ]. To accept the default value, press ENTER.
Note: The examples in this procedure show the information that displays when you install OpenAccess SDK Server on a 32-bit UNIX machine.
To install OpenAccess SDK Server and IP SDK from files downloaded from the Web:
-
Log on to your UNIX system as root or another user. See User Login for Installation for more information.
-
Download the OpenAccess SDK Server tar file from the Progress DataDirect Web site. Download instructions are available on the Progress DataDirect Web site.
If you are downloading to a machine other than the target machine, you will need to transfer the file (in binary format) to your UNIX workstation. How you transfer files from another system to your UNIX workstation depends on your TCP/IP product and your system’s operating system. For more information about transferring files, refer to the documentation supplied with your TCP/IP product.
Important: Transfer the file in binary format. If you transfer the file in the wrong format, the installation will fail.
-
On your UNIX server, access the downloaded tar file and extract it. For example, enter:
tar -xvof oaserver32_unixos_version.tar
where unixos is the UNIX or Linux operating system, for example, sunos, and version is the OpenAccess SDK version number.
-
If you logged on to your UNIX system as:
-
root, enter the following command:
ksh install.sh
-
Another user, enter the following command:
ksh install.sh -po
When you run the installation script, it prompts you for choices you need to make and information you need to supply. Default answers to questions are enclosed within square brackets, [ ]. To accept the default, press ENTER.
-
-
Select the product to install.
Select the product that you want to install: 1) OpenAccess SDK 9.0 Server and IP SDK (32-bit) ----------------------------------------------- Select product ? [1] -
Verify the product to install.
You are installing the product: OpenAccess SDK 9.0 Server and IP SDK (32-bit) on AIX 5.3 or higher ----------------------------------------------- Do you want to continue (Y/N) ? [Y]Enter Y to continue the installation. Enter N to stop the installation; no software is installed.
-
Enter the installation directory, or press ENTER to accept the default installation directory. If the directory does not exist, it will be created for you.
-
You are prompted for information that is required to create the OpenAccess SDK Agent. The OpenAccess SDK Agent allows the OpenAccess SDK administrator to configure, manage, and monitor this OpenAccess SDK Server using the OpenAccess SDK Manager. See User Login for Installation for more information.
To create an OpenAccess SDK Agent service:
-
If you are installing as a root, enter the user ID of the OpenAccess SDK administrator account, or press ENTER to accept the default.
Please enter the Unix account name which will be allowed to remotely administer this OpenAccess SDK Server [root] : -
If you are installing as another user, enter a client IP address that can access the agent, or enter * to allow any machine to access the agent.
Please enter the TCP/IP network identifier for the host which will be allowed to remotely administer this OpenAccess SDK Server : (Wildcards * and ? are allowed)
-
-
Enter the name of the OpenAccess SDK Agent service, or press ENTER to accept the default.
Enter the name of this OpenAccess Agent service [OpenAccessSDKAgent900]:
-
Enter the TCP/IP port that the OpenAccess SDK Agent service will use to listen for connection requests.
Enter the TCP/IP port for your OpenAccess Agent service [20091]:Enter an available unique port, or press ENTER to accept the default. The installer creates the OpenAccess SDK Agent.
Note: The port you choose must be unique (not used by another service). If the port you choose is not unique, the installation will fail. No software will be installed.
-
Enter the fully-qualified name of the directory containing the JRE (for example /usr/java/jre). If you do not plan to use the OpenAccess SDK Java service, enter /usr/java. Follow the instructions presented by the installer.
The services for Java will not start unless a JVM can be located at the specified location. You modify the JVM location after installation. Refer to the OpenAccess SDK Administrator’s Guide for information about using the OpenAccess SDK Management Command line to set the service attribute ServiceJVMLocation.
-
Review the installation settings.
Ready to start installation with the following settings: OpenAccess SDK home directory : /home/george/oaserver900 OpenAccess SDK Agent settings: Administrator : root Service name : OpenAccessSDKAgent900 TCP/IP port : 20091 OpenAccess SDK services settings : TCP/IP port : Service name : 20092 OpenAccessSDK900_C 20093 OpenAccessSDK900_C_SQL 20094 OpenAccessSDK900_Java 20095 OpenAccessSDK900_Java_SQL Java Runtime Environment(JRE) directory: /usr/java/jre You will need approx. 30000 kBytes free diskspace in your OpenAccess SDK home directory (depending on your platform and configuration). ----------------------------------------------- 1) Start installation with these settings 2) Change OpenAccess SDK home directory 3) Change OpenAccess SDK Agent settings 4) Change OpenAccess SDK Services names 5) Change OpenAccess SDK Services TCP/IP ports 6) Set Java Runtime Environment(JRE) directory 7) Abort installation Enter your choice [1] ?You can choose to continue with the installation using these settings, change any settings, or end the installation. Enter the appropriate choice, or press ENTER to start the installation with the current settings.
-
You are prompted for your product registration. Enter your name, company name, serial number, and IPE key. For a licensed installation, use the serial number and IPE key provided to you by Progress DataDirect. If you are installing an evaluation copy of OpenAccess SDK Server, leave the Key field empty.
-
The installer prompts you to review the information. Enter C to change the information, or press ENTER to continue.
-
The license agreement is displayed. Press ENTER to advance through the license agreement. Then, enter YES to accept the license agreement or NO to decline the agreement and end the installation.
-
The installer prompts you to continue with the installation. Press ENTER to continue. The installer installs the files.
-
When the installation of the OpenAccess SDK Agent is complete, the installer prompts you to start the OpenAccess SDK Agent service.
----------------------------------------------- Starting OpenAccess SDK Agent service ----------------------------------------------- Would you like the installer to start the OpenAccess SDK Agent (Y/N) ? [Y]Enter Y to start the OpenAccess SDK Agent service. Enter N if you do not want to start the service at this time. You can start the OpenAccess SDK Agent at a later time.
-
The installer prompts you to start the OpenAccess SDK C/C++ Service data access service.
Would you like the installer to start the OpenAccess SDK C Service (Y/N) ? [Y]Enter Y to start this service. Enter N if you do not want to start the service at this time. You can start the service at a later time.
A message appears when an OpenAccess SDK Service successfully starts and publishes itself on the TCP/IP port.
Test your OpenAccess SDK environment by establishing a connection between the OpenAccess SDK Client and the OpenAccess SDK data access service. See Testing the Client Installation for instructions on testing your OpenAccess SDK environment.
You may need to tune your OpenAccess SDK Server after installation. For information on tuning the OpenAccess SDK Server, refer to the OpenAccess SDK Administrator’s Guide.