How to Install HCL OneDB

Preparing for installation

Before you install OneDB® database server products, you must prepare your system and plan for choices that you must make during the installation process.

About this task

Preparing for installation includes reviewing system requirements, planning how to upgrade, deciding on the installation owner and the installation directory, reviewing installation options, and gathering information if you want to create a database server during installation. It also includes preinstallation tasks such as obtaining the software and reviewing the machine notes.

To prepare for installation:

1. Obtain the software and configure a License Server to obtain licenses to run HCL OneDB. For more information about HCL OneDB visit, https://www.hcltechsw.com/onedb.
2. Review the HCL OneDB components that can be installed with the database server. You can install all or some of them.

3. Ensure that your computer meets the system requirements.

4. Choose a user account with which to install the product. The user account becomes the installation owner.

• UNIX, Linux, Mac OS X: Decide between a non-root owner and an owner with root or administrative privileges.
• If you plan to install as an administrative user, decide on a password for user Informix

5. Choose an installation directory.

If the database server is already installed, decide on the upgrade path.

6. Decide between a typical or custom installation.

1. Choose a typical installation in the following cases:

• For default server features, language support, extensions, and tools.
• To create a configured database during installation with connectivity for JSON applications and multiple storage spaces for data.

      b.   Choose a custom installation if you want to have any of the following options:

• To install a subset of database server components.
• In root-based installation, to set up event auditing for the security policies of your organization.
• To create a configured database server during installation with one storage space for data.
• To prepare a response file for a non-interactive installation.

Depending on your operating system, you can choose other types of installations that have similar options to a custom installation. UNIX, Linux: You can choose the Legacy installation to prepare a script-based installation. Linux: You can choose the RPM installation to generate an RPM package.

Results

Log files are created during the installation process. You can use the log files to troubleshoot installation errors.

1. Below is how your HCL OneDB tar file will look like:

2. Extract the OneDB tar file:

3. You will see the below files when you extract the OneDB tar file

Prerequisites: A Compatible JRE must be available in your system PATH.

4. Start the installer by running the below command and respond to each prompt to proceed to the next step in the installation. If you want to change something on a previous step, type ‘back’

5. Press <Enter> for License Agreement as mentioned below

6. Press <Enter> to Continue as a part of License agreement

7. Press <Enter> to Continue as a part of License agreement

8. Press <Enter> to Continue as a part of License agreement

9. Press <Enter> to Continue as a part of License agreement

10. On accepting the License agreement your installation will begin and you must mention the location where you want to install HCL OneDB

11. You can do the typical installation by pressing <ENTER>. But you can explore other installation options as well.

12. If you want the installer to create an instance for you, select option 1.

Database server configuration during installation

You can choose to create and configure a database server during installation. The database server is configured by the choices that you make in the installation application. After installation is complete, disk space for the database server is initialized and the database server is started.

All mandatory configuration parameters and environment variables are set, and default connectivity information is configured. The database server is also configured to require minimal administration. The database server is configured to automatically tune resources for performance, which include expanding the buffer pool, the logical logs, and the physical log, and increasing virtual processors. You can further customize the database server by setting other configuration parameters and environment variables.

Important: If you plan to use a locale or language other than the default (US English), set the appropriate global language support (GLS) environment variables before you create a database.

For example, to prevent server and collation problems, it is crucial to set the GL_USEGLU environment variable correctly. The same Unicode collation must be used for the database and the client application environment.

The following storage spaces are created for an installation of the database server:

• A root dbspace to contain control and tracking information
• An extendable plogspace for the physical log
• A dbspace for the logical logs
• A temporary dbspace
• An sbspace
• A temporary sbspace
• Dbspaces for data:
  • Typical installation: Three extendable dbspaces with the default page size, and three extendable dbspaces with an 8 KB page size
  • Custom installation: One dbspace with the default page size

The sizes of the spaces are based on the number of expected users that you specify during the installation. The spaces are not encrypted. You can encrypt the storage spaces that are created during installation by enabling storage space encryption, running a backup, and then running a restore that encrypts the spaces. If you run a typical installation, the server is configured with a JSON wire listener for connections to MongoDB applications. The JSON wire listener is started and connected to the database server through the ifxjson user.

You can select option 2 that after installation, you will prepare your own environment file, create dbspaces/chunks and other dbspaces of your own preferred location and size

13. Enter the License server URL

14. Select the number of users

15. Below are the features which will be installed in your HCL OneDB server

16. Press <ENTER> to continue and your product is Ready to Install

17. Press <ENTER> to install

18. Your database server instance is created and below are the environment files you can use based on the shell you have

19. HCL OneDB Installation is successfully completed

Preparing for installation

Before you install OneDB® database server products, you must prepare your system and plan for choices that you must make during the installation process.