ALTIBASE® HDB™ Administration

Installation Guide
Release 6.5.1

August 9, 2021
ALTIBASE HDB Administration Installation Guide
Release 6.5.1
Copyright © 2001~2015 Altibase Corporation. All rights reserved.

This manual contains proprietary information of Altibase® Corporation; it is provided under a license agreement containing restric-
tions on use and disclosure and is also protected by copyright patent and other intellectual property law. Reverse engineering of the
software is prohibited.

All trademarks, registered or otherwise, are the property of their respective owners.

Altibase Corporation
10F, Daerung PostTower II, 182-13,
Guro-dong Guro-gu Seoul, 152-847, South Korea
Telephone: +82-2-2082-1000 Fax: 82-2-2082-1099
Homepage: http://www.altibase.com
 Contents
Preface .................................................................................................................................................. v
About This Manual ..................................................................................................... vi
Audience ....................................................................................................... vi
Software Environment ....................................................................................... vi
Organization ................................................................................................... vi
Documentation Conventions ................................................................................ vi
Online Manuals ............................................................................................... vii
Altibase Welcomes Your Comments ....................................................................... vii
1. About the ALTIBASE HDB Package Installer ............................................................................................1
1.1 Altibase Home ....................................................................................................... 2
1.1.1 ALTIBASE HDB Home Directory ......................................................................... 2
1.2 APatch Directory .................................................................................................... 3
1.2.1 Structure and Contents of the APatch Directory..................................................... 3
1.2.2 patchinfo File ............................................................................................. 3
1.2.3 pkg_patch_x_x_x_x.txt File ............................................................................ 4
1.2.4 altibase_base_install.log File .......................................................................... 4
1.2.5 Backup Directory ......................................................................................... 4
2. Installing Products with the ALTIBASE HDB Package Installer ..................................................................7
2.1 Hardware Requirements........................................................................................... 8
2.1.1 Memory .................................................................................................... 8
2.1.2 CPU......................................................................................................... 8
2.1.3 Hard Disk .................................................................................................. 8
2.1.4 Network ................................................................................................... 8
2.2 ALTIBASE HDB Package Installer .................................................................................. 9
2.2.1 Basic Steps for Installing ALTIBASE HDB............................................................... 9
2.2.2 Download the ALTIBASE HDB Package Installer ...................................................... 9
2.2.3 Installation Mode....................................................................................... 10
2.3 Installing ALTIBASE HDB Products on Unix .................................................................... 11
2.3.1 Check the Environment Before Installation ........................................................ 11
2.3.2 Download the Package Installer..................................................................... 12
2.3.3 Set the Installation Mode............................................................................. 13
2.3.4 Start the ALTIBASE HDB Package Installer ........................................................ 13
2.3.5 Enter the Installation Directory and Select the Installation Type ............................................ 14
2.3.6 Check System Parameters............................................................................ 16
2.3.7 Set ALTIBASE HDB Properties ........................................................................ 19
2.3.8 Confirm ALTIBASE HDB Properties .................................................................. 22
2.3.9 Install the ALTIBASE HDB Product.................................................................... 25
2.3.10 Select the ALTIBASE HDB Edition ................................................................... 26
2.3.11 Register or Update the ALTIBASE HDB License Key ...................................................... 26
2.3.12 Preview the ALTIBASE HDB Quick Settings Guide ........................................................ 28
2.3.13 Finish Installation .................................................................................... 32
2.3.14 Post-installation Tasks ............................................................................... 34
2.4 Installing ALTIBASE HDB Products on Windows ............................................................... 35
2.4.1 Check the Environment Before Installation ........................................................ 35
2.4.2 Start the ALTIBASE HDB Package Installer .......................................................... 38
2.4.3 Enter the Installation Directory and Select the Installation Type ............................................. 39
2.4.4 Validate the System Environment ................................................................... 41
2.4.5 Set ALTIBASE HDB Properties ......................................................................... 41
2.4.6 Confirm ALTIBASE HDB Properties ................................................................... 44
2.4.7 Choose Additional Installation Options ............................................................. 45
2.4.8 Install the ALTIBASE HDB Product.................................................................... 48
2.4.9 Select the ALTIBASE HDB Edition .................................................................... 49
2.4.10 Register the ALTIBASE HDB License Key ........................................................... 49
2.4.11 Preview the ALTIBASE HDB Quick Settings Guide ........................................................ 51
2.4.12 Register ALTIBASE HDB as Windows Services ..................................................... 53
2.4.13 Finish Installation .................................................................................... 55

iii
 2.4.14 Post-installation Tasks ...............................................................................56
2.5 Installing ALTIBASE HDB Client Products on Unix .............................................................57
2.5.1 Checking the Environment Before Installation .....................................................57
2.5.2 Downloading the Package Installer ..................................................................57
2.5.3 Setting the Installation Mode .........................................................................57
2.5.4 Starting the ALTIBASE HDB Package Installer .......................................................57
2.5.5 Entering the Installation Directory and Selecting the Installation Type ..................................... 58
2.5.6 Setting ALTIBASE HDB Client Properties .............................................................59
2.5.7 Installing the ALTIBASE HDB Client Product .........................................................61
2.5.8 Finishing Installation ...................................................................................63
2.5.9 Post-installation Tasks .................................................................................63
2.6 Installing ALTIBASE HDB Client Products on Windows ........................................................64
2.6.1 Checking the Environment Before Installation .....................................................64
2.6.2 Starting the ALTIBASE HDB Package Installer .......................................................64
2.6.3 Entering the Installation Directory and Selecting the Installation Type ..................................... 65
2.6.4 Choosing Additional Installation Options ............................................................65
2.6.5 Installing the ALTIBASE HDB Client Product .........................................................66
2.6.6 Finishing Installation ...................................................................................68
3. Uninstalling ALTIBASE HDB ................................................................................................................ 69
3.1 Uninstalling ALTIBASE HDB Products ...........................................................................70
3.1.1 Full Uninstallation ......................................................................................70
3.1.2 Patch Uninstallation ...................................................................................70
4. Patching Products With the ALTIBASE HDB Package Installer ................................................................ 71
4.1 About Patches......................................................................................................72
4.1.1 Installation Types for ALTIBASE HDB Products ......................................................72
4.1.2 Installation Types for ALTIBASE HDB Client Products ............................................................. 72
4.2 Patching ALTIBASE HDB Server Products .......................................................................74
4.2.1 Checking the Environment Before Installation .....................................................74
4.2.2 Downloading the ALTIBASE HDB Package Installer ........................................................74
4.2.3 Setting the Installation Mode .........................................................................74
4.2.4 Starting the ALTIBASE HDB Package Installer .......................................................74
4.2.5 Entering the Installation Directory and Selecting the Installation Type ..................................... 75
4.2.6 Checking the Patch Version ...........................................................................77
4.2.7 Installing the ALTIBASE HDB Product.................................................................79
4.2.8 Finishing Installation ...................................................................................81
4.3 Patching ALTIBASE HDB Client Products .......................................................................82
4.3.1 Checking the Environment Before Installation .....................................................82
4.3.2 Downloading the ALTIBASE HDB Package Installer ........................................................82
4.3.3 Setting the Installation Mode .........................................................................82
4.3.4 Setting the ALTIBASE HDB Package Installer ........................................................82
4.3.5 Entering the Installation Directory and Selecting the Installation Type ..................................... 83
4.3.6 Checking the Patch Version ...........................................................................85
4.3.7 Installing the ALTIBASE HDB Product.................................................................86
4.3.8 Finishing Installation ...................................................................................87
AppendixA. Installation Prerequisites .................................................................................................... 89
Setting User Resource Limit Values .................................................................................89
Setting Kernel Parameters for Different Operating Systems ....................................................89
Solaris ..........................................................................................................90
HP-UX...........................................................................................................90
AIX ..............................................................................................................91
LINUX ...........................................................................................................92
Checking Disk Configuration .........................................................................................92
OS Patch ................................................................................................................92
AIX ..............................................................................................................92

iv
 Preface

v Preface
About This Manual

About This Manual

This manual describes how to install and configure ALTIBASE HDB on UNIX and Microsoft Windows.

Audience
This manual has been prepared for the following ALTIBASE HDB users:

• database managers

• performance managers

• database users

• application developers

• technical support workers

It is recommended that those reading this manual possess the following background knowledge:

• basic knowledge in the use of computers, operating systems, and operating system utilities

• experience in using relational databases and an understanding of database concepts

• computer programming experience

• experience in database server, operating system or network administration

Software Environment
This manual has been prepared assuming that ALTIBASE HDB 6.5.1 is used as the database server.

Organization
This manual is organized as follows:

• Chapter1: About the ALTIBASE HDB Package Installer

• Chapter2: Installing Products with the ALTIBASE HDB Package Installer

• Chapter3: Uninstalling ALTIBASE HDB

• Chapter4: Patching Products With the ALTIBASE HDB Package Installer

• Appendix A. Installation Prerequisites

Documentation Conventions
This section describes the conventions used in this manual. Understanding these conventions will
make it easier to find information in this manual and other manuals in the series.

Installation Guide vi
 About This Manual

Convention Meaning

Italic Indicates book titles, emphasis, or placeholder variables for which

particular values are supplied by the user.
monospace Indicates commands within a paragraph, code in examples, etc.

Online Manuals
Online versions of our manuals (PDF or HTML) are available from Altibase's Customer Support site
(http://support.altibase.com/).

Altibase Welcomes Your Comments

Please let us know what you like or dislike about our manuals. To help us with future versions of our
manuals, please tell us about any corrections or classifications that you would find useful.

Include the following information :

• The name and version of the manual that you are using

• Any comments that you have about the manual

• Your name, address, and phone number

If you need immediate assistance regarding technical issues, please contact Altibase’s Customer
Support site (http://support.altibase.com/).

Thank you. We appreciate your feedback and suggestions.

vii Preface
About This Manual

Installation Guide viii

 1 About the ALTIBASE
HDB Package Installer
The ALTIBASE HDB Package Installer is a Java-based installer that lets you easily install ALTIBASE HDB
products such as the database server, client components, tools, and so on.

This chapter discusses directories and files that are generated after the product has been installed.

1 About the ALTIBASE HDB Package Installer

1.1 Altibase Home

1.1 Altibase Home

When you install ALTIBASE HDB with the ALTIBASE HDB Package Installer, a home directory and
APatch directory are generated.

The ALTIBASE HDB home directory is the default directory wherein ALTIBASE HDB software is
installed.

1.1.1 ALTIBASE HDB Home Directory

When you install ALTIBASE HDB with the ALTIBASE HDB Package Installer, a home directory (wherein
ALTIBASE HDB products are installed) is generated. The ALTIBASE HDB home directory takes the fol-
lowing values by default.

• When installing ALTIBASE HDB Server Products:

$HOME/altibase-HDB-server-<version>

• When installing ALTIBASE HDB Client Products:

$HOME/altibase-HDB-client-<version>

Installation Guide 2
 1.2 APatch Directory

1.2 APatch Directory

Information about ALTIBASE HDB products that were installed with the ALTIBASE HDB Package
Installer is stored in the APatch directory, under the ALTIBASE HDB home directory.

1.2.1 Structure and Contents of the APatch Directory

APatch is the name of the ALTIBASE HDB Package Installer directory and is located in the ALTIBASE
HDB home directory.

This directory contains files that store information about an installed product or a patch version:

• patchinfo File

• pkg_patch_<version>.txt file

• altibase_base_install.log file

• Backup directory

1.2.2 patchinfo File

This file contains:

• Information about the base release1 version and the patch version of the currently installed
ALTIBASE HDB product.

• Information about the environment on which the product (such as the OS, OS patch, C/C++
compiler, and Java compiler) was built.

Ex)
PRODUCT_SIGNATURE=server-6.5.1-64-release
PATCH_VERSION=0_0_0_0

======= OS INFO =======

Linux qar2 2.6.18-164.el5xen #1 SMP Tue Aug 18 15:59:52 EDT 2009 x86_64
x86_64 x86_64 GNU/Linux

======= PATCH INFO =======

2.6.18-164.el5xen

======= COMPILER INFO =======

gcc version 4.1.2 20080704 (Red Hat 4.1.2-46)
glibc 2.5

======= JAVA INFO =======

java version "1.4.2_19"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_19-b04)
Java HotSpot(TM) Client VM (build 1.4.2_19-b04, mixed mode)

1. Base release: The entire package used for initial installation.

3 About the ALTIBASE HDB Package Installer

1.2 APatch Directory

1.2.3 pkg_patch_x_x_x_x.txt File

This file is automatically generated as pkg_patch_<patch_version>.txt whenever a prod-
uct is patched. This file contains the revision number of the source code that was modified to create
the patch.

The following example shows the contents of the APatch directory after installing the base release
6.5.1.0.0:

%$ ls
pkg_patch_0_0_0_0.txt

The following example shows the contents of the APatch directory after installing the patch
6.5.1.0.10:

%$ ls
pkg_patch_0_0_0_0.txt pkg_patch_0_0_0_10.txt

%$cat pkg_patch_0_0_0_10.txt
Repository: /altidev4/tags/altibase_6_1_1_0_10_tag/
Revision: 42850
Last Changed Rev: 42850

1.2.4 altibase_base_install.log File

All operations during the most recent installation are written to this file.

1.2.5 Backup Directory

When installing a new patch, the ALTIBASE HDB Package Installer creates backups of the patched
files and stores them in the $ALTIBASE_HOME/APatch/ directory. This directory contains
backup directories that were generated every time the product was patched. These backup files will
be used to roll back patches in the future.

Also, executable files that are used to uninstall or roll back patches are installed in the
$ALTIBASE_HOME/APatch/ directory whena product is installed or patched.

Caution1: HP platforms do not support automatic backups or rollbacks if the Package Installer is patched.
You need to manually back up data and log files.

Caution2: Only files that are installed with the Package Installer are backed up to this backup directory;
files that are generated after the product has been installed (such as data files and log files) are not
backed up.

The following example shows the contents of the APatch directory, after installing the base release
6.5.1.0.0:

altibase_base_install.log patchinfo
pkg_patch_0_0_0_0.txt uninstall-base

• uninstall-base: the executable file needed to uninstall the base release 6.5.1.0.0.

The following example shows the contents of the APatch directory, after installing the patch
6.5.1.0.10:

Installation Guide 4
 1.2 APatch Directory

altibase_base_install.log pkg_patch_0_0_0_10.txt
uninstall-p0_0_0_10 patchinfo
rollback-p0_0_0_10/ pkg_patch_0_0_0_0.txt
uninstall-base

• uninstall-base: the executable file needed to uninstall the base release 6.5.1.0.0.

• rollback-p0_0_0_10: the directory that contains backups of the files patched with
6.5.1.0.10.

• uninstall-p0_0_0_10: the executable file needed to delete the patch 6.5.1.0.10 and roll
back to the previous version. These files are stored in the rollback-p0_0_0_10 directory.

5 About the ALTIBASE HDB Package Installer

1.2 APatch Directory

Installation Guide 6
2 Installing Products with
the ALTIBASE HDB
Package Installer
This chapter consists of the following sections:

• Hardware Requirements

• ALTIBASE HDB Package Installer

• Installing ALTIBASE HDB Products on Unix

• Installing ALTIBASE HDB Products on Windows

• Installing ALTIBASE HDB Client Products on Unix

• Installing ALTIBASE HDB Client Products on Windows

7 Installing Products with the ALTIBASE HDB

2.1 Hardware Requirements

2.1 Hardware Requirements

The following system requirements must be met to install and operate ALTIBASE HDB.

The requirements and recommendations listed in this chapter assume that your database will be
used for general purposes. If you plan to use your database for a special purpose, contact Altibase’s
Customer Support site (http://support.altibase.com/) for further information about system require-
ments.

2.1.1 Memory
32-bit OS: Minimum 1GB (2GB recommended; maximum 4GB)

64-bit OS: Minimum 1GB (2GB recommended, unlimited)

2.1.2 CPU
1 CPU or more (2 or more CPUs are recommended)

2.1.3 Hard Disk

ALTIBASE HDB requires a disk with sufficient storage space to hold tablespaces (to store data), trans-
action logs, and ALTIBASE HDB software. ALTIBASE HDB software and transaction logs require at
least 1GB of space, respectively.

You should have at least 12GB of free disk space to smoothly run the database.

2.1.4 Network
We recommend that you use a dedicated line when using the replication feature.

Installation Guide 8
 2.2 ALTIBASE HDB Package Installer

2.2 ALTIBASE HDB Package Installer

2.2.1 Basic Steps for Installing ALTIBASE HDB

To install ALTIBASE HDB products, follow the steps below. Further information about each step is
provided in 2.3 Installing ALTIBASE HDB Products on Unix and 2.4 Installing ALTIBASE HDB Products
on Windows.

1. Check the Environment Before Installation

2. Download the ALTIBASE HDB Package Installer

3. Start the ALTIBASE HDB Package Installer

4. Enter the Installation Directory and Select the Installation Type

5. Set ALTIBASE HDB Properties

6. Confirm ALTIBASE HDB Properties

7. Install the ALTIBASE HDB Product

8. Select the ALTIBASE HDB Edition

9. Register the ALTIBASE HDB License Key

10. Preview the ALTIBASE HDB Quick Settings Guide

11. Finish Installation

12. Post-installation Tasks

2.2.2 Download the ALTIBASE HDB Package Installer

You can download the appropriate Package Installer for your operating system from Altibase’s Cus-
tomer Support site (http://support.altibase.com/).

ALTIBASE HDB Package Installer names follow the rule below.

Ex) ALTIBASE HDB Server Package Installer

altibase-HDB-server-6.5.1.0-AIX-POWERPC-64bit-release.run
altibase-HDB-server-6.5.1.0-WINDOWS-X86-64bit-release.exe

Ex) ALTIBASE HDB Client Package Installer

altibase-HDB-client-6.5.1.0-AIX-POWERPC-64bit-release.run
altibase-HDB-client-6.5.1.0-WINDOWS-X86-64bit-release.exe

The ALTIBASE HDB Server Package and Client Package are distributed in separate packages. How-
ever, the ALTIBASE HDB Server Package includes the Client Package.

The ALTIBASE HDB Package Installer is provided for the following operating systems. Use the com-
mand below to view information about the operating system, and then select the appropriate Pack-
age Installer.

9 Installing Products with the ALTIBASE HDB

2.3 ALTIBASE HDB Package Installer

$ uname -a
Linux rhel6-x64 2.6.32-71.el6.x86_64 #1 SMP Wed Sep 1 01:33:01 EDT 2010
x86_64 x86_64 x86_64 GNU/Linux

Bit
OS CPU Version Bit (Client)
(Server)

AIX PowerPC 6.1 tl03 or higher 64-bit 64-bit, 32-bit

HP IA64 11.31 or higher 64-bit 64-bit, 32-bit

LINUX x86, x86-64 redhat 6.0 or higher 64-bit 64-bit, 32-bit
(GNU glibc 2.12 or
higher)
SUN SPARC 2.8 or higher 64-bit 64-bit, 32-bit
WINDOWS x86, x86-64 Windows 2008 64-bit 64-bit, 32-bit
Windows 2012
Windows 7, 8

ALTIBASE HDB 6.5.1. is compatible with JDK 1.4 or higher.

2.2.3 Installation Mode

The ALTIBASE HDB Package Installer runs in one of the following modes:

• Interactive Command-line Mode: If the DISPLAY environment variable has not been set.

• Graphical User Interface (GUI) Mode: If the DISPLAY environment variable has been set.

Installation Guide 10
 2.3 Installing ALTIBASE HDB Products on Unix

2.3 Installing ALTIBASE HDB Products on Unix

This section explains how to install an ALTIBASE HDB product on Unix.

• Check the Environment Before Installation

• Download the ALTIBASE HDB Package Installer

• Set the Installation Mode

• Start the ALTIBASE HDB Package Installer

• Enter the Installation Directory and Select the Installation Type

• Check System Parameters

• Set ALTIBASE HDB Properties

• Confirm ALTIBASE HDB Properties

• Install the ALTIBASE HDB Product

• Select the ALTIBASE HDB Edition

• Register or Update the ALTIBASE HDB License Key

• Preview the ALTIBASE HDB Quick Settings Guide

• Finish Installation

• Post-installation Tasks

2.3.1 Check the Environment Before Installation

Prior to installation, the ALTIBASE HDB Package Installer checks the local environment to see
whether it meets the requirements for a successful installation. This operation is performed without
GUI.

During this operation, the ALTIBASE HDB Package Installer checks the following information about
the server:

• The operating system name and version

• The operating system mode (64-bit or 32-bit)

If you have downloaded an ALTIBASE HDB Package Installer that does not match your operating sys-
tem, an error message is returned and the installation is aborted. This is because detecting system
configuration issues at an early stage reduces the likelihood of encountering problems during instal-
lation.

11 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

Red Hat Enterprise Linux 8

For RHEL 8, libncurses.so.5 and libtinfo.so.5 must be created in order to execute iSQL and
iLoader. In order to do this, the user needs root privileges.

1. Check the ncurses and tinfo library files.

% ls -l /usr/lib64/| grep -e libncurses.so -e libtinfo.so
-rw-r--r-- 1 root root 31 Jan 16 2019 libncurses.so
lrwxrwxrwx. 1 root root 17 Jan 16 2019 libncurses.so.6 ->
libncurses.so.6.1*
-rwxr-xr-x. 1 root root 216912 Jan 16 2019 libncurses.so.6.1*
# ncurses library file
lrwxrwxrwx 1 root root 13 Jan 16 2019 libtinfo.so -> libtinfo.so.6*
lrwxrwxrwx. 1 root root 15 Jan 16 2019 libtinfo.so.6 ->
libtinfo.so.6.1*
-rwxr-xr-x. 1 root root 208616 Jan 16 2019 libtinfo.so.6.1*
# tinfo library file

2. If libncurses.so.5 and libtinfo.so.5 files do not exist, create symbolic links.

% ln -s /usr/lib64/libncurses.so.6.1 /usr/lib64/libncurses.so.5
% ln -s /usr/lib64/libtinfo.so.6.1 /usr/lib64/libtinfo.so.5

3. Check the created symbolic links.

% ls -l /usr/lib64/ | grep -e libncurses.so.5 -e libtinfo.so.5
lrwxrwxrwx 1 root root 17 May 7 16:44 libncurses.so.5 ->
libncurses.so.6.1*
lrwxrwxrwx 1 root root 15 May 7 16:51 libtinfo.so.5 ->
libtinfo.so.6.1*

• If libncurses.so.5 file does not exist, the following error occurs when iSQL is executed.
% isql
isql: error while loading shared libraries: libtinfo.so.5: cannot open
shared object file: No such file or directory

% server create utf8 utf8

/home/dev02/altibase_home/bin/isql: error while loading shared libraries:
libncurses.so.5: cannot open shared object file: No such file or directory

• In RHEL 8, the ncurses (including tinfo) library version has been changed to 6.1. Altibase
requires ncurses 5 version files. The ncurses library guarantees both source-level
compatibility (API) and binary compatibility (ABI) from ncurses 5 to ncurses 6.2.

Reference : Announcing ncurses 6.2 (invisible-island.net)

2.3.2 Download the Package Installer

You can download the appropriate Package Installer for your operating system from Altibase’s Cus-
tomer Support site (http://support.altibase.com/).

Please refer to 2.2.2 Download the ALTIBASE HDB Package Installer for further information about
supported operating systems.

Installation Guide 12
 2.3 Installing ALTIBASE HDB Products on Unix

2.3.3 Set the Installation Mode

The ALTIBASE HDB Package Installer runs in one of the following modes:

• Interactive Command-line Mode: If the DISPLAY environment variable has not been set.

• Graphical User Interface (GUI) Mode: If the DISPLAY environment variable has been set. This

manual assumes that the ALTIBASE HDB Package Installer’s installation mode is set to GUI.

2.3.3.1 Set GUI Mode

Unix users can run the ALTIBASE HDB Package Installer in GUI mode by setting the DISPLAY
environ-ment variable on the host computer as follows:

$ setenv DISPLAY <machine name>:0.0

<machine_name> is the IP address or host name of the computer that is to display the ALTIBASE
HDB Package Installer process. Use the setenv command for Cshell or set export DIS-
PLAY=<machine name>:0.0 for Korn Shell.

Execute the following command on the remote computer to view the ALTIBASE HDB Package
Installer running in GUI mode on another computer (other than the host computer) from a remote
location.

$ xhost +

2.3.4 Start the ALTIBASE HDB Package Installer

To run the ALTIBASE HDB Package Installer, UNIX users need to download the Package Installer and
then change file permissions, using chmod.

$ chmod +x altibase-HDB-server-6.5.1.0.0-LINUX-X86-64bit-release.run

Run the ALTIBASE HDB Package Installer.

$./altibase-HDB-server-6.5.1.0.0-LINUX-X86-64bit-release.run

If the Package Installer is set to GUI mode, the following Setup wizard appears.

13 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix
2.3.5 Enter the Installation Directory and Select the Installation Type
In the following Installation Directory dialog box, enter the ALTIBASE HDB home directory and select
the package installation type.

Installation Guide 14
 2.3 Installing ALTIBASE HDB Products on Unix

To install an ALTIBASE HDB product, click Full Installation in the Installation Type list; to
install apatch for a previously installed version, click Patch Installation in the Installation
Type list.

To add the ALTLIBASE HDB license key, select Add License and enter the license key.

If ALTIBASE HDB Enterprise Edition has already been installed to the specified directory, a
warning message appears. In this case, enter another directory or uninstall the product
installed in the speci-fied directory first.

15 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

2.3.6 Check System Parameters

The next dialog box displays the necessary system kernel parameters and how to set them. System
kernel parameters must be set using the root account. Some systems need to be rebooted after ker-
nel parameters have been set.

Kernel parameters should be manually set before proceeding to the next step. To set them after
installation is complete, please refer to the $ALTIBASE_HOME/install/pre_install.sh
file.

To ensure that ALTIBASE HDB runs properly, you should configure your system environment first. To
do so, you must modify kernel parameter values using root privileges before installing ALTIBASE
HDB. Kernel parameter values may be modified after installation; however, they must be modified
prior to ALTIBASE HDB startup. The following are examples of system kernel parameter values on dif-
ferent operating systems. For further information about kernel parameters for different operating
systems, please refer to Appendix A. Installation Prerequisites.

Ex) HPUX
[ Recommended Kernel Parameter Values ]

shmmax = 2147483648
shmmni = 500
shmseg = 200
semmap = 1001
semmni = 1000
semmns = 4096

Installation Guide 16
 2.3 Installing ALTIBASE HDB Products on Unix

semume = 1000
max_thread_proc = 600
maxusers = 64
dbc_min_pct = 5
dbc_max_pct = 5
maxdsiz = 1073741824
maxdsiz_64bit = 4294967296 # applies only to 32-bit applications

# maxdsiz_64bit
The ALTIBASE HDB server needs sufficient memory space to function properly.
Please set the value to 70% of system memory or greater.

# dbc_min_pct and dbc_max_pct

dbc_min_pct and dbc_max_pct were renamed filecache_min and filecache_max,
respectively, in HP version 11.31 and subsequent releases.

[ How to modify kernel parameter values ]

/usr/sbin/kmtune -s shmmax=2147483648
/usr/sbin/kmtune -s shmmni=500
/usr/sbin/kmtune -s shmseg=200
/usr/sbin/kmtune -s semmap=1001
/usr/sbin/kmtune -s semmni=1000
/usr/sbin/kmtune -s semmns=4096
/usr/sbin/kmtune -s semmnu=1000
/usr/sbin/kmtune -s semume=1000
/usr/sbin/kmtune -s max_thread_proc=600
/usr/sbin/kmtune -s maxusers=64
/usr/sbin/kmtune -s dbc_min_pct=5
/usr/sbin/kmtune -s dbc_max_pct=5
/usr/sbin/kmtune -s maxdsiz=1073741824 # applies only to 32-bit applications
/usr/sbin/kmtune -s maxdsiz_64bit=4294967296

# maxdsiz_64bit
The AlLTIBASE HDB server needs sufficient memory space in order to function
properly.
Please set the value to 70% of system memory or greater.

# dbc_min_pct and dbc_max_pct

dbc_min_pct and dbc_max_pct were renamed filecache_min and filecache_max,
respectively, in HP version 11.31 and subsequent releases.

Ex) LINUX
[ How to modify kernel parameter values ]

echo 512 32000 512 512 > /proc/sys/kernel/sem

echo 872415232 > /proc/sys/kernel/shmall

# shmall
If it is desired to use the ALTIBASE HDB in shared memory mode, the value of
'shmall' must be set. This value determines the maximum size of an Altibase
database.

Ex) AIX
[ Recommended Kernel Parameter Values ]

fsize = -1
data = -1
rss = -1

Maximum number of PROCESSES allowed per user

= greater than the value set using the Altibase property MAX_CLIENT

Size of the File System BufferCache

17 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

= less than 20% of total memory.

AIO = Available

AMO = AIX version 5.2 ML04 and above

lru_file_repage=0
strict_maxclient%=0
= Versions prior to AIX version 5.2 ML04
lru_file_repage=0

[ How to modify kernel parameter values ]

Edit /etc/security/limits file

Set fsize, data and rss variables.

Run 'smit'
1) System Environments
System Environments -> Change / Show Characteristics Of
Operating System

Change :
Maximum number of PROCESSES allowed per user
= bigger than the value set using the Altibase property
MAX_CLIENT
Size of the File System BufferCache
= less than 20% of total memory.
2) AIO
Device -> Asynchronous I/O -> Posix Asynchronous I/O
-> Configure Defined Asynchronous I/O
Change : posix_aio0=Available

3) AMO
Performance & Resource Scheduling -> Tuning Kernel & Network
Parameters

-> Tuning Virtual Memory Manager, File System and Logical Volume
Manager Params ->
+ List All Characteristics of Current Parameters --- Check
+ Change / Show Current Parameters --- Current Change
+ Change / Show Parameters for Next Boot --- Change upon Reboot

The case of AIX version 5.2 ML04 and above :

Change : lru_file_repage=0
strict_maxclient%=0
The case of Versions prior to AIX version 5.2 ML04 :
Change : lru_file_repage=0

Ex) SunOS
[ Recommended Kernel Parameter Values ]

When the ALTIBASE HDB uses the filesystem cache rather than direct I/O, the
priority_paging parameter (related to the Sun system's filesystem cache) must
be set in order to prevent issues related to excessive memory use.
(Applies only to SunOS version 5.7 and above.)

shminfo_shmmax = 2147483648
shminfo_shmmin = 1
shminfo_shmmni = 500
shminfo_shmseg = 200
seminfo_semmns = 8192
seminfo_semmni = 5029
seminfo_semmsl = 2000
seminfo_semmap = 5024
seminfo_semmnu = 1024
seminfo_semopm = 512
seminfo_semume = 512

Installation Guide 18
 2.3 Installing ALTIBASE HDB Products on Unix

rlim_fd_max = 4096
rlim_fd_cur = 2048

[ How to modify kernel parameter values ]

= Solaris 10 =
cf) projadd -U [user name] -K "project.max-sem-ids=(priv,5029,deny)"
user.[user name]
cf) projmod -a -K "project.max-shm-memory=(priv, real memory max value,deny)"
user.[user name]

# Default Values for sem- and shm-related Parameters

projadd -U altibase -K "project.max-sem-ids=(priv,5029,deny)"user.alti-
base
projmod -a -K "project.max-shm-memory=(priv, real memory max value,deny)"
user.altibase
projmod -a -K "process.max-sem-nsems=(priv,2000,deny)" user.altibase
projmod -a -K "process.max-sem-ops=(priv,512,deny)" user.altibase
projmod -a -K "project.max-shm-ids=(priv,1024,deny)" user.altibase

# Message Queue-related Parameters

projmod -a -K "project.max-msg-messages=(priv,100,deny)" user.altibase
projmod -a -K "project.max-msg-ids=(priv,100,deny)" user.altibase
projmod -a -K "process.max-msg-qbytes=(priv,1048576,deny)"
user.altibase

= is not Solaris 10 =
Edit /etc/system file.

# Default Values for sem- and shm-related Parameters

set shmsys:shminfo_shmmax = 2147483648
set shmsys:shminfo_shmmin = 1
set shmsys:shminfo_shmmni = 500
set shmsys:shminfo_shmseg = 200
set semsys:seminfo_semmns = 8192
set semsys:seminfo_semmni = 5029
set semsys:seminfo_semmsl = 2000
set semsys:seminfo_semmap = 5024
set semsys:seminfo_semmnu = 1024
set semsys:seminfo_semopm = 512
set semsys:seminfo_semume = 512
set rlim_fd_max = 4096
set rlim_fd_cur = 2048

# Message Queue-related Parameters

projmod -a -K "project.max-msg-messages=(priv,100,deny)" user.altibase
projmod -a -K "project.max-msg-ids=(priv,100,deny)" user.altibase
projmod -a -K "process.max-msg-qbytes=(priv,1048576,deny)"
user.altibase

These values must be set in order for the ALTIBASE HDB to operate properly.
They must be set so they are suitable for the system configuration.

2.3.7 Set ALTIBASE HDB Properties

ALTIBASE HDB properties can be set by following these three steps.

• Step 1: Basic Database Operation Properties

• Step 2: Database Creation Properties

• Step 3: Set Database Directories

19 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

2.3.7.1 Step 1: Basic Database Operation Properties

• Database Name

• Connection Port Number

• Maximum size of Memory Database

• Buffer Area Size

• Choose whether or not to create a SQL script to create a new database (whether or not to per-
form step 2). If you click YES, step 2 is performed; otherwise, step 2 is skipped. Regardless of
whether or not a SQL script is created in this step, a new database can be created with the
fol-lowing command: server create [DB Character-set] [National
Charac- ter-set]

2.3.7.2 Step 2: Database Creation Properties

The SQL script created in step 2 is stored in the $ALTIBASE_HOME/install/
post_install.sh file.

• Initial Database Size

• Database Archive Logging Mode

Installation Guide 20
 2.3 Installing ALTIBASE HDB Products on Unix

— Noarchivelog
— Archivelog

• Database Character Set

— MS949
— US7ASCII
— KO16KSC5601
— BIG5
— GB231280
— MS936
— UTF-8
— SHIFT-JIS
— EUC-JP

• National Character Set

— UTF-16
— UTF-8

2.3.7.3 Step 3: Set Database Directories

• Default Disk Database Directory

21 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

• Memory Database Directory

• Archive Log Directory

• Transaction Log Directory

• Log Anchor Files Directory

To set the values of properties excluded in this step, or to later change the values of properties that
have been set in step 1 or are to be set in step 3, edit the $ALTIBASE_HOME/conf/alti-
base.properties file manually.

2.3.8 Confirm ALTIBASE HDB Properties

The next dialog box displays property values that have been set in the previous step.

Installation Guide 22
 2.3 Installing ALTIBASE HDB Products on Unix

Ex)
To change these properties after installation is complete, please
modify thefollowing file: /qa_home/qd_team/sdy/altibase-HDB-server-
6.5.1/conf/alti- base.properties.

1. ALTIBASE HDB Property Settings:

Step 1: Basic database operation properties

1) Database name:[mydb]

2) ALTIBASE HDB connection port number(1024-65535): [20300]

3) Maximum size of memory database:[2G]

4) Buffer area size for caching disk-based database pages:

[128M]

2. ALTIBASE HDB Property Settings:

Step 2: Database creation properties

1) Initial database size

[10M]

2) Database archive logging mode

[noarchivelog]

23 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

3) Database character set

[MS949]

4) National character set

[UTF16]

3. ALTIBASE HDB Property Settings:

Step 3: Database Directory properties

The database will not operate properly if one or more of these directories
are removed

1) Disk Database Directory:

[/home1/sdy/altibase-HDB-server-6.5.1/dbs]

2) Memory Database Directory:

[/home1/sdy/altibase-HDB-server-6.5.1/dbs]

3) Archive Log Directory:

[/home1/sdy/altibase-HDB-server-6.5.1/arch_logs]

4) Transaction Log Directory:

[/home1/sdy/altibase-HDB-server-6.5.1/logs]

5) Log Anchor file Directories:

Directory 1 :
[/home1/sdy/altibase-HDB-server-6.5.1/logs]

Directory 2 :
[/home1/sdy/altibase-HDB-server-6.5.1/logs]

Directory 3 :
[/home1/sdy/altibase-HDB-server-6.5.1/logs]

After confirming these values, click Forward. The Ready to Install dialog box appears.

Click Forward to continue with the installation.

Installation Guide 24
 2.3 Installing ALTIBASE HDB Products on Unix

2.3.9 Install the ALTIBASE HDB Product

When installation is completed, the Package Installer performs the following operations without
GUI:

• Updates the properties which have been set to the altibase.properties file.

• Creates the altibase_user.env file (this file contains commands needed to set the neces-
sary environment variables for ALTIBASE HDB startup) in the $ALTIBASE_HOME/conf
directory. Adds a command to execute this file to a shell configuration file (e.g., .bashrc,
.bash_profile, or .profile, etc.).

The following are examples of the altibase_user.env file and the .bash_profile file.

### altibase_user.env
ALTIBASE_HOME=/qa_home/qd_team/sdy/altibase-HDB-server-6.5.1;export
ALTIBASE_HOME
PATH=${ALTIBASE_HOME}/bin:${PATH};export PATH
LD_LIBRARY_PATH=${ALTIBASE_HOME}/lib:${LD_LIBRARY_PATH};export
LD_LIBRARY_PATH
CLASSPATH=${ALTIBASE_HOME}/lib/Altibase.jar:${CLASSPATH};export CLASSPATH

### .bash_profile
# ALTIBASE_ENV
. /qa_home/qd_team/sdy/altibase-HDB-server- 6.5.1/conf/altibase_user.env

25 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

2.3.10 Select the ALTIBASE HDB Edition

ALTIBASE HDB Community Edition is a free version of ALTIBASE HDB.

Community Edition provides the same functions, features and tools as Enterprise Edition but has
data size limitations of 4GB in-memory and 8GB on disk. You can visit the Community Forum for
support.

To upgrade to Enterprise Edition, visit Altibase’s Customer Support site (http://support.altibase.com)

and get a license key.

2.3.11 Register or Update the ALTIBASE HDB License Key

The following dialog box is where you register your ALTIBASE HDB Enterprise Edition license key. You
will be skipping this step if you install Community Edition. You can register the license key with the
ALTIBASE HDB Package Installer by either:

• Entering the license key directly

• Selecting a file containing license key information

• Postponing license registration: If you have not obtained the license key yet, you can copy a
new license file to the $ALTIBASE_HOME/conf directory after you have obtained one. However,
if you do not enter the license key at this step, the Package Installer does not ask whether or
not to create a database at the next step.

$ cp license $ALTIBASE_HOME/conf/

A user using the Community Edition can enter a license key to update his or her license, without
stopping the server.

Only a user with the SYSDBA system privilege can update a license. Prior to license update, the previous
license in the $ALTIBASE_HOME/conf/license file must be dropped or prefixed with the number sign
(#) to change it to a comment; a new license key should be entered afterward.

The following conditions must be met for a successful license update:

• The host ID and MAC address are the same.

• The new value for the MEM_MAX_DB_SIZE property is larger than or equal to the current
value.

• The new value for the DISK_MAX_DB_SIZE property is larger than or equal to the current
value.

$ is -sysdba
iSQL(sysdba)> EXEC UPDATE_LICENSE;
Validating new license...
System HostID (0x00001111) and License HostID(0x00001111)match. PASS
System MAC Address(11:11:11:11:11:11) and License MAC
Address(11:11:11:11:11:11) match. PASS
MEM_MAX_DB_SIZE limit was updated from 16G to 128G.
DISK_MAX_DB_SIZE limit was updated from 128G to 256G.
Expiration date was updated from 2015. 12. 31. to 2016. 12. 31.
License update completed successfully with new Standard Edition License.

Installation Guide 26
 2.3 Installing ALTIBASE HDB Products on Unix

27 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

2.3.12 Preview the ALTIBASE HDB Quick Settings Guide

The ALTIBASE HDB Quick Settings Guide dialog box shows you how to start ALTIBASE HDB, after it
has been installed successfully.

The ALTIBASE HDB Package Installer provides the following two shell scripts to allow users to easily
set system kernel parameters and environment variables.

• $ALTIBASE_HOME/install/pre_install.sh

This script contains the minimum set of essential system kernel parameters, their recom-
mended values, and explains how to set them.

• $ALTIBASE_HOME/install/post_install.sh

This script contains a SQL script for creating a new database (if step 2 was performed for Set
ALTIBASE HDB Properties).

If you select the check box in the next dialog box, the ALTIBASE HDB Package Installer creates a new
database and this will prolong installation time. If you do not select the check box, you will need to
manually create a database, after the product has been installed.

Installation Guide 28
 2.3 Installing ALTIBASE HDB Products on Unix

[ Installation complete ]
Please refer to the file listed below to verify the Altibase HDB version.
/qa_home/qd_team/sdy/altibase-HDB-server-6.5.1/APatch/patchinfo
[ Quick Guide to Making Settings in ALTIBASE HDB ]

1. Set kernel variables using the root user account.

run the '/qa_home/qd_team/sdy/altibase-HDB-server-6.5.1/install/
pre_install.sh' file
- This script helps you make kernel parameter settings.

================ LINUX ================

[ How to modify kernel parameter values ]

echo 512 32000 512 512 > /proc/sys/kernel/sem

echo 872415232 > /proc/sys/kernel/shmall

# shmall
If you desire to use ALTIBASE HDB in shared memory mode, the value of 'shmall'
must be set. This value determines the maximum size of an Altibase database.

These values must be set in order for ALTIBASE HDB to operate properly.
They must be set so they are suitable for the system configuration.

=====================================

2. Provide a license.

Please rename and locate the license file as shown below. /qa_home/
qd_team/sdy/altibase-HDB-server-6.5.1/conf/license If no license file has

29 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

been issued, or if the license file has expired, ALTIBASE HDB services will
not start. In this case, please visit http://support.altibase.com

3. Configure user environment variables (using the user account with which
ALTIBASE HDB was installed).
Run the '/qa_home/qd_team/sdy/altibase-HDB-server-6.5.1/install/
post_install.sh' file
under the account with which ALTIBASE HDB was installed.

This script performs necessary post-installation configuration.

1) Create the ALTIBASE HDB user environment file and apply it to the user
profile. (/qa_home/qd_team/sdy/altibase-HDB-server-6.5.1/conf/
altibase_user.env)
2) Create a database.

If you selected 'YES' in response to the question about whether to create a

database after installation, at "ALTIBASE HDB Property setting step 1", a
database will be automatically created.

If you selected 'NO' in response to this question, you need to create a

database manually.

shell> server create [DB Character Set] [National Character Set]

4.Start up and Shut down the server

shell> server start
shell> server stop

5.Connect to the database using iSQL

shell> isql -s 127.0.0.1 -u SYS -p MANAGER

The following message appears while a database is being created.

Installation Guide 30
 2.3 Installing ALTIBASE HDB Products on Unix

31 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

2.3.13 Finish Installation

After successful installation, the following dialog box appears.

Installation Guide 32
 2.3 Installing ALTIBASE HDB Products on Unix

Click Finish, and the following Environment Settings Guide message box appears.

33 Installing Products with the ALTIBASE HDB

2.3 Installing ALTIBASE HDB Products on Unix

2.3.14 Post-installation Tasks

After successful installation, you need to:

1. Set the parameters manually if system kernel parameters have not been set during installation.
Please refer to the $ALTIBASE_HOME/install/pre_install.sh file.

2. Perform either of the following to invoke a login shell:

• Log out and then login again
• Execute . ~/.bash_profile or source ~/.bash_profile

3. Create a database as below, if a database was not created during installation:

• If properties for database creation were set during installation, execute the
$ALTIBASE_HOME/install/post_install.sh script.
$ sh post_install.sh dbcreate
• If properties for database creation were not set during installation, execute the server
script.
$ server create utf8 utf8

Installation Guide 34
 2.4 Installing ALTIBASE HDB Products on Windows

2.4 Installing ALTIBASE HDB Products on Windows

This section describes how to install an ALTIBASE HDB product.

• Check the Environment Before Installation

• Start the ALTIBASE HDB Package Installer

• Enter the Installation Directory and Select the Installation Type

• Validate the System Environment

• Set ALTIBASE HDB Properties

• Confirm ALTIBASE HDB Properties

• Choose Additional Installation Options

• Install the ALTIBASE HDB Product

• Select the ALTIBASE HDB Edition

• Register the ALTIBASE HDB License Key

• Preview the ALTIBASE HDB Quick Settings Guide

• Register ALTIBASE HDB as Windows Services

• Finish Installation

• Post-installation Tasks

2.4.1 Check the Environment Before Installation

To install an ALTIBASE HDB product on Windows with the Package Installer, you must be logged on
as an administrator. This is because only an account with administrator privileges can register the
ODBC driver, register the driver in Windows, and start Windows Services.

2.4.1.1 Grant User Privileges

If you do not have sufficient privileges to log on to the service, any attempt to start the service fails
and the error message “The service did not start due to a logon failure.” appears.

You can check whether your account has sufficient privileges to log on to the service and then
grant appropriate privileges by following these steps:

1. Open the Local Group Policy Editor property sheet (On the taskbar, click Start, click Run, and
then type gpedit.msc.)

2. On the left menu, click Computer Configuration, point to Windows Settings, point to Secu-
rity Settings, point to Local Policies, and then click User Rights Assignment.

3. In the Policy list, double-click Log on as a service.

35 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

4. Check whether the user account that is currently being used is on the list. If not, add the user,
and then click Ok.

5. Close Local Security Settings property sheet.

Installation Guide 36
 2.4 Installing ALTIBASE HDB Products on Windows

Due to enhanced security, creating a database and registering ALTIBASE HDB as a service can be
tricky on Windows Vista and Windows 7. To avoid this problem, set the User Account Control (UAC)
before installation. For further information about UAC, please refer to http://support.microsoft.com/
kb/922708/en-us.

1. In Control Panel, click User Accounts, and then click Change User Account Control settings.

37 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

2. Move the slider to the bottom and select Never notify.

3. Reboot Windows (Vista or 7).

4. Run the ALTIBASE HDB Package Installer.

If you did not create a database or register ALTIBASE HDB as a service during installation, a UAC
prompt appears when you create a database or register ALTIBASE HDB as a service. Follow these
steps to avoid seeing this prompt:

5. Right-click Database Creation and click Run as administrator. Right-click Service Registra-
tion and click Run as administrator

Note: To run executable files from the command prompt, start the command prompt with the “Run
as administrator” option.

6. Type the administrator password and click Continue.

2.4.2 Start the ALTIBASE HDB Package Installer

After checking that the system is ready for installation, run the ALTIBASE HDB Package Installer. The
following Setup wizard appears.

Installation Guide 38
 2.4 Installing ALTIBASE HDB Products on Windows

2.4.3 Enter the Installation Directory and Select the Installation Type
In the following Installation Directory dialog box, enter the ALTIBASE HDB home directory and select
the package installation type.

To install an ALTIBASE HDB product, click Full Installation in the Installation Type list; to install a
patch for a previously installed version, click Patch Installation in the Installation Type list.

To add an ALTIBASE HDB license key, select Add license and enter the license key.

39 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

If ALTIBASE HDB Enterprise Edition has already been installed to the specified directory, a warning
message appears. In this case, enter another directory or uninstall the product installed in the speci-
fied directory first.

If an ALTIBASE HDB product was previously installed in the specified directory, and then uninstalled,
the above warning message appears. This means that some files were not deleted during uninstalla-
tion. These files can remain in the dbs or logs directories. If you ignore this warning and install a
new product, the product will be installed but you will be unable to create a new database. ALTIBASE
HDB will start only if its version is compatible with the remaining files. To create a new database,
delete all remaining files in the dbs or logs directories first.

Installation Guide 40
 2.4 Installing ALTIBASE HDB Products on Windows

2.4.4 Validate the System Environment

The following dialog box displays the Pre-installation Guide described above.

2.4.5 Set ALTIBASE HDB Properties

ALTIBASE HDB properties can be set by following these three steps.

• Step 1: Basic Database Operation Properties

• Step 2: Database Creation Properties

• Step 3: Set Database Directories

41 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

2.4.5.1 Step 1: Basic Database Operation Properties

• Database Name

• Connection Port Number

• Maximum size of memory database

• Buffer area size

• Choose whether or not to create a SQL script to create a new database (whether or not to per-
form step 2). If you click YES, step 2 is performed; otherwise, step 2 is skipped. Regardless of
whether or not a SQL script is created in this step, a new database can be created with the fol-
lowing command: server create [DB Character-set] [National Charac-
ter-set]

2.4.5.2 Step 2: Database Creation Properties

The SQL script created in step 2 is stored in the $ALTIBASE_HOME/install/
post_install.sh file.

• Initial Database Size

• Database archive logging mode

— NoArchivelog
— Archivelog

Installation Guide 42
 2.4 Installing ALTIBASE HDB Products on Windows

• Database Character Set

— MS949
— US7ASCII
— KO16KSC5601
— BIG5
— GB231280
— MS936
— UTF-8
— SHIFT-JIS
— EUC-JP

• National Character Set

— UTF-16
— UTF-8

2.4.5.3 Step 3: Set Database Directories

• Default Disk Database Directory

• Memory Database Directory

• Archive Log Directory

• Transaction Log directory

43 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

To set the values of properties excluded in this step, or to later change the values of properties that
have been set in step 1 or are to be set in step 3, edit the $ALTIBASE_HOME/conf/alti-
base.properties file manually.

2.4.6 Confirm ALTIBASE HDB Properties

The next dialog box displays property values that have been set in the previous step.

Installation Guide 44
 2.4 Installing ALTIBASE HDB Products on Windows

2.4.7 Choose Additional Installation Options

At this step, you decide whether to install ALTIBASE HDB at system level or user level, and whether or
not to install the ALTIBASE HDB ODBC Driver.

On a Windows platform, the level at which ALTIBASE HDB is installed has a significant impact. Please
review the following table to see the difference.

Option All Users (System) Current User

Environment variables Applies to all users on the sys- Applies to the current user
and registry entities tem, and overwrites any user- only, but can be overwritten by
specific settings system settings

File permissions Granted to all users Granted to the current user

only
Registering as a service Yes No

Allowing multiple server No. If a %ALTIBASE_HOME% Yes. Each user can install and
instances environment variable is set at configure their own server
system level, then any user spe- instance.
cific %ALTIBASE_HOME% is
ignored.

45 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

The next option for you to select is whether or not to install the ALTIBASE HDB ODBC Driver
(altiodbc.dll). If you choose “Yes”, the ALTIBASE HDB Package Installer adds information about the
ALTIBASE HDB ODBC Driver, such as the driver name (ALTIBASE_HDB_ODBC_32/64bit), to the regis-
try and copies the ALTIBASE HDB ODBC driver file (altiodbc.dll) to the following directory:

• When installing a 64-bit package on 64-bit operating systems: C:\WINDOWS\system32

• When installing a 32-bit package on 64-bit operating systems: C:\WINDOWS\SysWOW64

• When installing a 32-bit package on 32-bit operating systems: C:\WINDOWS\system32

Note: The 64-bit package cannot be installed on a 32-bit operating system.

After installing the ALTIBASE HDB ODBC Driver, the Ready to Install dialog box appears.

Installation Guide 46
 2.4 Installing ALTIBASE HDB Products on Windows

Click Next to install.

47 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

2.4.8 Install the ALTIBASE HDB Product

Once installation is complete, properties that have been set are written to the altibase.prop-
erties file, and a SQL script for creating a new database is included in the
post_instal_win.bat file. These operations are performed without GUI.

Installation Guide 48
 2.4 Installing ALTIBASE HDB Products on Windows

2.4.9 Select the ALTIBASE HDB Edition

ALTIBASE HDB Community Edition is a free version of ALTIBASE HDB.

Community Edition provides the same functions, features and tools as Enterprise Edition but has
data size limitations of 4GB in-memory and 8GB on disk. You can visit the Community Forum for sup-
port.

To upgrade to Enterprise Edition, visit Altibase’s Customer Support site (http://support.altibase.com)

and get a license key.

2.4.10 Register the ALTIBASE HDB License Key

The following dialog box is where you register your ALTIBASE HDB Enterprise Edition license key. You
will be skipping this step if you install Community Edition. You can register the license key with the
ALTIBASE HDB Package Installer by either:

• Entering the license key directly

• Selecting a file containing license key information

• Postponing license registration: If you have not obtained the license key yet, you can copy a
new license file to the $ALTIBASE_HOME/conf directory after you have obtained one. However,
if you do not enter the license key at this step, the Package Installer does not ask whether or
not to create a database at the next step.

49 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

%$ cp license $ALTIBASE_HOME/conf/

Installation Guide 50
 2.4 Installing ALTIBASE HDB Products on Windows

2.4.11 Preview the ALTIBASE HDB Quick Settings Guide

The ALTIBASE HDB Quick Settings Guide dialog box shows you how to start ALTIBASE HDB, after it
has been installed successfully.

The ALTIBASE HDB Package Installer provides the following batch file to allow users to easily set
ALTIBASE HDB and create a database.

• %ALTIBASE_HOME%\install\post_install_win.bat

This batch file contains a SQL script for creating a new database, if you have performed step 2
for Set ALTIBASE HDB Properties.

If you select the check box in the next dialog box, the ALTIBASE HDB Package Installer creates a
new database and this will prolong installation time. If you do not select the check box, you
will need to manually create a database, after the product has been installed.

51 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

The following dialog box displays the execution result of the post_install_win.bat batch file.

Installation Guide 52
 2.4 Installing ALTIBASE HDB Products on Windows

2.4.12 Register ALTIBASE HDB as Windows Services

At this step, you choose whether or not to register ALTIBASE HDB as a Windows service. If you select
No, you will be unable to register ALTIBASE HDB services on Windows later on.

If you select Yes, the following dialog box with information on how to add the “Log on as a service”
privilege to start ALTIBASE HDB as a Windows service appears. After that, an ALTIBASE HDB Win-
dows service registration dialog box appears.

53 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

The Service Name for ALTIBASE HDB is “ALTIBASE_551_SERVICE” by default. This name can be
changed as desired.

By default, the Windows ID is the same as the user name of the account with which this package was
installed. To start a Windows service, this user account must have a password. If the account does
not have a password, you must create a password for the account.

Installation Guide 54
 2.4 Installing ALTIBASE HDB Products on Windows

After registering ALTIBASE HDB as a Windows service, the ALTIBASE HDB Package Installer starts the
service.

2.4.13 Finish Installation

After successful installation, the following dialog box appears.

55 Installing Products with the ALTIBASE HDB

2.4 Installing ALTIBASE HDB Products on Windows

2.4.14 Post-installation Tasks

After successful installation, you need to:

1. Create a database:

If a database was not created during installation, a new database can be created by either:

• Run the %ALTIBASE_HOME%\install\post_install_win.bat file (If a SQL

script for creating a new database was generated.)
• Use the server command in the %ALTIBASE_HOME%\bin directory (If a SQL script
for creating a new database was not generated.)
C:\> server create db_charset national_charset

2. Start the ALTIBASE HDB server:

If a database was created and ALTIBASE HDB was registered as a Windows service, the ALTI-
BASE HDB Package Installer starts up the ALTIBASE HDB server automatically.

To start up the ALTIBASE HDB server manually, execute the following command from the com-
mand prompt:

C:\> server start

Note: On Windows Vista and Windows 7, if you did not set the User Account Control (UAC) properly, you
must execute the post_install_win.bat file from a windows command prompt that was opened
with administrator privileges (i.e. the command prompt window must be opened with the Run as
administrator menu item).

Installation Guide 56
 2.5 Installing ALTIBASE HDB Client Products on Unix

2.5 Installing ALTIBASE HDB Client Products on Unix

The following sections describe how to install an ALTIBASE HDB Client Product:

• Checking the Environment Before Installation

• Downloading the Package Installer

• Setting the Installation Mode

• Starting the ALTIBASE HDB Package Installer

• Entering the Installation Directory and Selecting the Installation Type

• Setting ALTIBASE HDB Client Properties

• Installing the ALTIBASE HDB Client Product

• Finishing Installation

• Post-installation Tasks

2.5.1 Checking the Environment Before Installation

Please refer to 2.3.1 Check the Environment Before Installation.

2.5.2 Downloading the Package Installer

You can download the appropriate Package Installer for your operating system from Altibase’s Cus-
tomer Support site (http://support.altibase.com/).

Please refer to 2.2.2 Download the ALTIBASE HDB Package Installer for further information on sup-
ported operating systems.

2.5.3 Setting the Installation Mode

To start the ALTIBASE HDB Package Installer in GUI mode on UNIX, please refer to 2.3.3 Set the Instal-
lation Mode.

2.5.4 Starting the ALTIBASE HDB Package Installer

To run the ALTIBASE HDB Package Installer, UNIX users must download the Package Installer and
then change the permissions of the file, using chmod.

$ chmod +x altibase-HDB-server-6.5.1.0.0-LINUX-X86-64bit-release.run

Run the ALTIBASE HDB Package Installer.

$./altibase-HDB-client-6.5.1.0.0-LINUX-X86-64bit-release.run

If the installation mode is set to GUI mode, the following start panel appears.

57 Installing Products with the ALTIBASE HDB

2.5 Installing ALTIBASE HDB Client Products on Unix

2.5.5 Entering the Installation Directory and Selecting the Installation

Type
In the following Installation Directory panel, enter the ALTIBASE HDB home directory (the directory
to which an ALTIBASE HDB client package is to be installed) and select the Client Package installation
type.

To install an ALTIBASE HDB Client Product, select “Full Installation”; to install a patch for a previously
installed version, select “Patch Installation”.

Installation Guide 58
 2.5 Installing ALTIBASE HDB Client Products on Unix

2.5.6 Setting ALTIBASE HDB Client Properties

In the ALTIBASE HDB Client Properties panel, enter the communication port number to be used by
clients when connecting to the server via TCP/IP. This port number is saved in an environment set-
tings file (e.g., .profile, .bash_profile, etc.) in the user’s account.

59 Installing Products with the ALTIBASE HDB

2.5 Installing ALTIBASE HDB Client Products on Unix

Installation Guide 60
 2.5 Installing ALTIBASE HDB Client Products on Unix

2.5.7 Installing the ALTIBASE HDB Client Product

61 Installing Products with the ALTIBASE HDB

2.5 Installing ALTIBASE HDB Client Products on Unix

During this procedure, the environment variables related to ALTIBASE HDB Client Products (which
are shown in the above dialog box) are added to the environment file for your login shell (e.g.,
default environment file for the standard Bourne shell (sh) is .profile). The altibase_user.env file,
which is generated when an ALTIBASE HDB Server Product is installed, is not generated. To apply
new environment variables to your shell, perform one of the following actions:

• log out and then re-log in again

Installation Guide 62
 2.5 Installing ALTIBASE HDB Client Products on Unix

• reapply the shell environment by executing . ~/.profile or source ~/.profile.

The following is an example of .profile.

# ALTIBASE_ENV
export ALTIBASE_HOME=/qa_home/qd_team/sdy/altibase-HDB-client-6.5.1
export ALTIBASE_PORT_NO=20300
export PATH=$ALTIBASE_HOME/bin:$PATH
export LD_LIBRARY_PATH=${ALTIBASE_HOME}/lib:${LD_LIBRARY_PATH}
export CLASSPATH=${ALTIBASE_HOME}/lib/Altibase.jar:${CLASSPATH}

2.5.8 Finishing Installation

2.5.9 Post-installation Tasks

If you did not apply new environment variables to your shell during the above procedure, do it now.
For more information, please refer to 2.5.7 Installing the ALTIBASE HDB Client Product.

63 Installing Products with the ALTIBASE HDB

2.6 Installing ALTIBASE HDB Client Products on Windows

2.6 Installing ALTIBASE HDB Client Products on Win-

dows
The following section describes how to install an ALTIBASE HDB Client Product on Windows:

• Checking the Environment Before Installation

• Starting the ALTIBASE HDB Package Installer

• Entering the Installation Directory and Selecting the Installation Type

• Choosing Additional Installation Options

• Installing the ALTIBASE HDB Client Product

• Finishing Installation

2.6.1 Checking the Environment Before Installation

Please refer to 2.4.1 Check the Environment Before Installation.

2.6.2 Starting the ALTIBASE HDB Package Installer

Installation Guide 64
 2.6 Installing ALTIBASE HDB Client Products on Windows

2.6.3 Entering the Installation Directory and Selecting the Installation

Type
In the following Installation Directory panel, enter the ALTIBASE HDB home directory, in which ALTI-
BASE HDB is to be installed, and select the Client Package installation type.

To install an ALTIBASE HDB product, select “Full Installation”; to install a patch for a previously
installed version, select “Patch Installation”.

2.6.4 Choosing Additional Installation Options

Please refer to 2.4.7 Choose Additional Installation Options.

65 Installing Products with the ALTIBASE HDB

2.6 Installing ALTIBASE HDB Client Products on Windows

2.6.5 Installing the ALTIBASE HDB Client Product

Click “Next” to install.

Installation Guide 66
2.6 Installing ALTIBASE HDB Client Products on Windows

67 Installing Products with the ALTIBASE HDB

2.6 Installing ALTIBASE HDB Client Products on Windows

2.6.6 Finishing Installation

Installation Guide 68
3 Uninstalling ALTIBASE
HDB
ALTIBASE HDB products can be uninstalled or rolled back using the Uninstaller which is installed
with the product.

This chapter explains how to uninstall a previously installed product or patch using the Package
Installer.

• Full Uninstallation

• Patch Uninstallation

69 Uninstalling ALTIBASE HDB

3.1 Uninstalling ALTIBASE HDB Products

3.1 Uninstalling ALTIBASE HDB Products

ALTIBASE HDB products can be uninstalled or rolled back using the Uninstaller which is installed
with the product. Target files for rollback are files that were installed with the Package Installer; other
files including database files and log files are excluded. The Uninstaller associated with a base
release (a full package used for an initial installation) uninstalls the entire product; the Uninstaller
which is installed when a patch is applied can be used either to uninstall the entire product or to roll
back the corresponding patch.

Note: On the HP-UX platform, the Uninstaller provided with the ALTIBASE HDB Package Installer can only
uninstall the entire product; it cannot roll back patches. Therefore, you are recommended to manually
back up the previously installed product, before applying a patch.

3.1.1 Full Uninstallation

ALTIBASE HDB products or patches which are installed using the ALTIBASE HDB Package Installer can
be uninstalled with the Uninstaller that is provided with the product to be removed.

However, the Uninstaller cannot delete environment variables in the UNIX environment. Therefore,
the user must manually delete ALTIBASE HDB-related environment variables from the account’s
environment variables file. To remove ALTIBASE HDB products, perform the following steps:

1. Select the Uninstaller (e.g., uninstall-base) associated with the product to be removed
from the $ALTIBASE_HOME/APatch directory.

2. Run the Uninstaller.

3.1.2 Patch Uninstallation

Patches installed using the ALTIBASE HDB Package Installer can be rolled back by running the Unin-
staller named according to the convention “uninstall-p<patch_version>”. However, only the most
recently installed patch can be rolled back. During uninstallation, a patch is removed and the previ-
ous version is restored from the backup.

To roll back a patch, perform the following steps:

1. Select the Uninstaller (e.g., uninstall-p0_0_0_1 ) associated with the patch to be

removed from the $ALTIBASE_HOME/APatch directory.

2. Run the Uninstaller.

Installation Guide 70
4 Patching Products With
the ALTIBASE HDB
Package Installer
This chapter consists of the following sections:

• About Patches

• Patching ALTIBASE HDB Server Products

• Patching ALTIBASE HDB Client Products

71 Patching Products With the ALTIBASE HDB

4.1 About Patches

4.1 About Patches

A patch is a small collection of files that is used to overwrite an existing installation. Patches are asso-
ciated with particular versions of ALTIBASE HDB Products. Patches are bug fixes that are made avail-
able to customers in response to specific bugs. They require a particular base release or patchset to
be installed before being applied.

4.1.1 Installation Types for ALTIBASE HDB Products

Table 4-1 Full Package vs. Patch Package

Installation Steps Full Package Patch Package

Checking the Environment Before Installation O O

Starting the ALTIBASE HDB Package Installer O O

Checking System Parameters O

Entering the Installation Directory O O

Checking the Patch Version O

Setting ALTIBASE HDB Properties O

Confirming the ALTIBASE HDB Properties O

Installing the ALTIBASE HDB ODBC Driver O (Windows Only)

Installing the ALTIBASE HDB Product O O

Registering the ALTIBASE HDB License Key O

Previewing the ALTIBASE HDB Quick Settings O

Guide
Registering ALTIBASE HDB as a Windows Service O (Windows Only)
Finishing Installation O O

4.1.2 Installation Types for ALTIBASE HDB Client Products

Table 4-2 Full Package vs. Patch Package

Installation Steps Full Package Patch Package

Checking the Environment Before Installation O O

Starting the ALTIBASE HDB Package Installer O O

Entering the Installation Directory O O

Installing the ALTIBASE HDB ODBC Driver O (Windows Only)

Checking the Patch Version O

Installation Guide 72
 4.1 About Patches

Installation Steps Full Package Patch Package

Setting ALTIBASE HDB Properties O

Installing the ALTIBASE HDB Client Product O O

Finishing Installation O O

73 Patching Products With the ALTIBASE HDB

4.2 Patching ALTIBASE HDB Server Products

4.2 Patching ALTIBASE HDB Server Products

The following sections describe how to apply patches for ALTIBASE HDB Server Products:

• Checking the Environment Before Installation

• Downloading the ALTIBASE HDB Package Installer

• Setting the Installation Mode

• Starting the ALTIBASE HDB Package Installer

• Entering the Installation Directory and Selecting the Installation Type

• Checking the Patch Version

• Installing the ALTIBASE HDB Product

• Finishing Installation

4.2.1 Checking the Environment Before Installation

Please refer to 2.3.1 Check the Environment Before Installation (Unix) or 2.4.1 Check the Environment
Before Installation (Windows).

4.2.2 Downloading the ALTIBASE HDB Package Installer

Altibase does not offer a separate installation file for patches. When you start the Package Installer,
you can select the installation type - either the “Full package” or “Patch package”.

Please download the appropriate installer for your operating system from Altibase’s Customer Sup-
port site (http://support.altibase.com/).

4.2.3 Setting the Installation Mode

To install the Package Installer in GUI mode, please refer to 2.3.3 Set the Installation Mode.

4.2.4 Starting the ALTIBASE HDB Package Installer

To run the ALTIBASE HDB Package Installer, UNIX users must download the Package Installer and
then change the permissions of the file, using chmod.

$ chmod +x altibase-HDB-server-6.5.1.0.7-LINUX-X86-64bit-release.run

Run the ALTIBASE HDB Package Installer.

$./altibase-HDB-server-6.5.1.0.7-LINUX-X86-64bit-release.run

If the installation mode is set to GUI mode, the following Start panel is displayed.

Installation Guide 74
 4.2 Patching ALTIBASE HDB Server Products

4.2.5 Entering the Installation Directory and Selecting the Installation

Type
In the Installation Directory panel, enter the Altibase home directory containing the product to be
patched and select “Patch Installation” for the installation type.

Patches require a base release to be installed before being applied. If an ALTIBASE HDB product has
not been installed to the directory specified by the user, a warning message is displayed in a dialog
box.

However, if you select “Full package” for the Installation Type, the installation steps are identical to
those for ALTIBASE HDB Server Products. Please refer to 2.3 Installing ALTIBASE HDB Products on
Unix or 2.4 Installing ALTIBASE HDB Products on Windows.

Ex) Selecting “Full package”

75 Patching Products With the ALTIBASE HDB

4.2 Patching ALTIBASE HDB Server Products

Installation Guide 76
 4.2 Patching ALTIBASE HDB Server Products

Ex) Selecting “Patch package”

4.2.6 Checking the Patch Version

This panel shows the patch version applied to the ALTIBASE HDB product that is currently installed in
the selected directory and the patch version to be applied.

77 Patching Products With the ALTIBASE HDB

4.2 Patching ALTIBASE HDB Server Products

Installation Guide 78
 4.2 Patching ALTIBASE HDB Server Products

4.2.7 Installing the ALTIBASE HDB Product

79 Patching Products With the ALTIBASE HDB

4.2 Patching ALTIBASE HDB Server Products

Installation Guide 80
 4.2 Patching ALTIBASE HDB Server Products

4.2.8 Finishing Installation

81 Patching Products With the ALTIBASE HDB

4.3 Patching ALTIBASE HDB Client Products

4.3 Patching ALTIBASE HDB Client Products

This section describes how to apply ALTIBASE HDB client patches.

4.3.1 Checking the Environment Before Installation

Please refer to 4.2.1 Checking the Environment Before Installation.

4.3.2 Downloading the ALTIBASE HDB Package Installer

Altibase does not offer a separate installation file for patches. When you start the Package Installer,
you can select the installation type - either the “Full package “or “Patch”. Please download the appro-
priate installer for your operating system from Altibase’s Customer Support site (http://support.alti-
base.com/).

4.3.3 Setting the Installation Mode

To install the Package Installer in GUI mode, please refer to 2.3.3 Set the Installation Mode.

4.3.4 Setting the ALTIBASE HDB Package Installer

To run the ALTIBASE HDB Package Installer, UNIX users must download the Package Installer and
then change the permissions of the file, using chmod.

$ chmod +x altibase-HDB-client-6.5.1.0.7-LINUX-X86-64bit-release.run

Run the ALTIBASE HDB Package Installer.

$./altibase-HDB-client-6.5.1.0.7-LINUX-X86-64bit-release.run

If the installation mode is set to GUI mode, the following Start panel is displayed.

Installation Guide 82
 4.3 Patching ALTIBASE HDB Client Products

4.3.5 Entering the Installation Directory and Selecting the Installation

Type
In the Installation Directory panel, enter the Altibase home directory containing the product to be
patched and select “Patch Package” for the installation type. Patches require a base release to be
installed before being applied. If an ALTIBASE HDB product has not been installed to the directory
specified by the user, a warning message is displayed in a dialogue box. However, if you select “Full
package” for the installation type, the installation steps are identical to those for ALTIBASE HDB Cli-
ent Products. Please refer to 2.5 Installing ALTIBASE HDB Client Products on Unix or 2.6 Installing
ALTIBASE HDB Client Products on Windows.

Ex) Selecting “Full package”

83 Patching Products With the ALTIBASE HDB

4.3 Patching ALTIBASE HDB Client Products

Ex) Selecting “Patch package”

Installation Guide 84
 4.3 Patching ALTIBASE HDB Client Products

4.3.6 Checking the Patch Version

This panel shows the patch version applied to the ALTIBASE HDB product that is currently installed in
the selected directory and the patch version to be applied.

85 Patching Products With the ALTIBASE HDB

4.3 Patching ALTIBASE HDB Client Products

4.3.7 Installing the ALTIBASE HDB Product

Installation Guide 86
 4.3 Patching ALTIBASE HDB Client Products

4.3.8 Finishing Installation

87 Patching Products With the ALTIBASE HDB

4.3 Patching ALTIBASE HDB Client Products

Installation Guide 88
 Setting User Resource Limit Values

Appendix A. Installation
Prerequisites
Setting User Resource Limit Values
User resource limit values can be confirmed or changed with the OS command, “ulimit”.

• File Size

The maximum file size creatable by the processor.

• Data Segment Size

The maximum size of logical memory the process can use (vsz field).

• Max Memory Size

The maximum size of physical memory the process can use (RSS field).

• Open Files (descriptor)

The maximum number of files and sockets simultaneously accessable by the process.

• Virtual Memory

The maximum size of virtual memory usable by the process.

Windows operating systems do not require manual configuration of user resource limit values; how-
ever, UNIX users are recommended to set the resource limit values of a user’s account to “unlimited”
(caution is required that the core file size is not set to “unlimited”). In the event where the ALTIBASE
HDB server abnormally terminates and a core dump occurs, disk space can become scarce when the
core file size is set to “unlimited”, as the entire memory database is saved to core files.

Setting Kernel Parameters for Different Operating Sys-

tems
System Kernel parameter values can be confirmed or changed with a utility provided for each oper-
ating system.

System kernel parameters can be classified into the following:

• Shared Memory

Settings related to the number of shared memory segments and its maximum size.

89 Installation Prerequisites
Setting Kernel Parameters for Different Operating Systems

• File-Cache

Settings for the prevention of memory insufficiency due to the operating system’s file-cache.

• Semaphore

Semaphore settings for IPC connection.

• Other Settings

Solaris

Setting Kernel Parameters on Solaris

• Solaris 2.8 and 2.9 : Kernel parameters can be set in the /etc/system file.

• Solaris 2.10 : Kernel parameters can be set with the /usr/sbin/projadd or /usr/sbin/projmod
utility.

Recommended Values

Classification Parameter Name Recommended Value (bytes)

Shared Memory shmmax 2G+1

shmmin 500
shmseg 200

Semaphore semmns 8192

smmni 5029

semmsl 2000
semmap 5024
semmnu 1024

semopm 512

semume 512

semvmx 32767

HP-UX

Setting Kernel Parameters on HP-UX

• HP 11.31 or above: Kernel parameters can be set with the /usr/sbin/kctune utility.

ODBC Reference 90
 Setting Kernel Parameters for Different Operating Systems

Recommended Values
The same values for shared memory and semaphore on Solaris are also recommended for HP-UX.

Classification Parameter Name Recommended Value (bytes)

File-Cache (HP recommends dbc_min_pct 5%

20% for 8G or less, 10% for 8G
or more) dbc_max_pct 5~20%

Others maxdsiz 2GB

maxdsiz_64bit The amount of memory which

is predicted that ALTIBASE HDB
will use

max_thread_proc 600 or more

maxfiles 2048 or more

nproc 6142

maxusers 124

AIX

Setting Kernel Parameters on AIX

• HP 11i: Kernel parameters can be set with the /usr/bin/smit utility.

Recommended Values
The same values for shared memory and semaphore on Solaris are also recommended for AIX.

Setting File-Cache

Depending on the file caching policy for AIX, the file system can swap-out memory from the applica-
tion program heap, although the system has free memory, and use it as file-cache (this is called
stealing).

For AIX 5.2 or higher, kernel parameters can be set as below to prevent the system from stealing:

minperm = 5%
lru_file_repage = 0 ( Can only be set on AIX 5.2 ML4 or higher )
strict_maxclient = 0

Setting Posix AIO

AIX provides the Posix AIO interfaces for improved disk I/O improvement which must be manually
activated. However from AIX 6.1 and higher, the interfaces are activated by default.

91 Installation Prerequisites
Checking Disk Configuration

Posix AIO can be activated as below:

• Change “Configure Defined Asynchronous I/O” to Available through smit.

• Change “STATE to be configured at system restarted” to Available through smit.

The installation and start up of ALTIBASE HDB is impossible on AIX if the system is not set as above.

LINUX

Setting Kernel Parameters on Linux

Kernel parameters can be set in the sem, shmmax, shmmni, swapiness files at the /proc/sys/kernel
path.

Recommended Values
The same values for shared memory and semaphore on Solaris are also recommended for Linux.

However, sessions using the IPC connection can be abruptly cut off, if the Linux kernel version is
lower than 2.5.

To set kernel parameters automatically when the server boots, add the following to the /etc/rc.d/
rc.local file.

echo 2147483648 > /proc/sys/kernel/shmmax

echo 4096 > /proc/sys/kernel/shmmni
echo 200 32000 512 5029 > /proc/sys/kernel/sem
echo 30 > /proc/sys/vm/swappiness

Checking Disk Configuration

Redo log files and data files generally experience disk I/O in ALTIBASE HDB. To minimize perfor-
mance loss due to disk I/O, we recommend that you segregate redo log files and data files onto a
separate physical disk.

OS Patch

AIX
When using ALTIBASE HDB on AIX, memory usage increases (hearpmin library bug). In this case, C/
C++ compilers of the appropriate version must be patched from the IBM Support Portal (http://
http://www-01.ibm.com/support/docview.wss?uid=swg21110831).

ODBC Reference 92
Index
A Client 63
ALTIBASE HDB Home Directory 2 Server 34
Altibase Home 2 Windows 56
altibase_base_install.log File 4 Properties 18, 41
APatch Directory 3
patchinfo File 3
S
System Parameters 15
B
Backup Directory 4
U
User Privileges 35
D
database creation 28, 34
Download 9

F
Full Uninstallation 70

G
GUI Mode 12

H
Hardware Requirements 8
home directory 13

I
Installation Directory 13
Installation Mode 10, 12
Installation Type 13, 72
Installing ALTIBASE HDB Client Products 57, 64
Installing ALTIBASE HDB Products 11, 35

K
Kernel Parameters 89

L
License 26, 49

O
OS 11
OS Patch 92

P
Patch Uninstallation 70
Patching Altibase HDB Client Products 82
Patching Altibase HDB Server Products 74
pkg_patch_x_x_x_x.txt File 4
Post-installation Task

93 Index
Index 94