HDB 6.5.1 Installation Eng

ALTIBASE HDB Administration
Installation Guide
Release 6.5.1
June 11, 2015
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 restrictions 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.............................................................................................................................. 11
2.3.3 Set the Installation Mode ........................................................................................................................................... 12
2.3.4 Start the ALTIBASE HDB Package Installer ........................................................................................................... 12
2.3.5 Enter the Installation Directory and Select the Installation Type ................................................................ 13
2.3.6 Check System Parameters ......................................................................................................................................... 15
2.3.7 Set ALTIBASE HDB Properties ................................................................................................................................... 18
2.3.8 Confirm ALTIBASE HDB Properties ......................................................................................................................... 21
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.4 Choosing Additional Installation Options............................................................................................................65
2.6.5 Installing the ALTIBASE HDB Client Product .......................................................................................................66
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.2 Downloading the ALTIBASE HDB Package Installer .........................................................................................74
4.2.6 Checking the Patch Version ......................................................................................................................................77
4.2.7 Installing the ALTIBASE HDB Product ....................................................................................................................79
4.3 Patching ALTIBASE HDB Client Products ................................................................................................................................82
4.3.2 Downloading the ALTIBASE HDB Package Installer .........................................................................................82
4.3.4 Setting the ALTIBASE HDB Package Installer ......................................................................................................82
4.3.6 Checking the Patch Version ......................................................................................................................................85
4.3.7 Installing the ALTIBASE HDB Product ....................................................................................................................86
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
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
Meaning
Convention
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 Altibases 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.
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 following 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
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.
1.2.3 pkg_patch_x_x_x_x.txt File

This file is automatically generated as pkg_patch_<patch_version>.txt whenever a product 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
%$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
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
altibase_base_install.log
uninstall-p0_0_0_10
rollback-p0_0_0_10/
uninstall-base
patchinfo
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.
Installation Guide
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
7Installing Products with the ALTIBASE HDB Pack-
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 Altibases
Customer Support site (http://support.altibase.com/) for further information about system requirements.
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), transaction 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
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 Altibases Customer 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. However, the ALTIBASE HDB Server Package includes the Client Package.
The ALTIBASE HDB Package Installer is provided for the following operating systems. Use the command below to view information about the operating system, and then select the appropriate Package Installer.
9Installing Products with the ALTIBASE HDB Pack-
$ 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
OS
CPU
Version
Bit
(Server)
Bit (Client)
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
(GNU glibc 2.12 or
higher)
redhat 6.0 or higher
64-bit
64-bit, 32-bit
SUN
SPARC
2.8 or higher
64-bit
64-bit, 32-bit
WINDOWS
x86, x86-64
Windows 2008
Windows 2012
Windows 7, 8
64-bit
64-bit, 32-bit
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

This section explains how to install an ALTIBASE HDB product on Unix.
Download the ALTIBASE HDB Package Installer
Set the Installation Mode
Check System Parameters
Register or Update the ALTIBASE HDB License Key
Finish Installation
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 system, 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 installation.
2.3.2 Download the Package Installer

You can download the appropriate Package Installer for your operating system from Altibases Cus-
11
Installing Products with the ALTIBASE HDB
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.
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 Installers 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 environment 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 DISPLAY=<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.
Installation Guide
12
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.
13
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 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 specified directory first.
Installation Guide
14
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 kernel 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 different 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
shmmni
shmseg
semmap
semmni
semmns
semmnu
=
=
=
=
=
=
=
2147483648
500
200
1001
1000
4096
1000
15
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
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
/usr/sbin/kmtune
-s
-s
-s
-s
-s
-s
-s
-s
-s
-s
-s
-s
-s
-s
shmmax=2147483648
shmmni=500
shmseg=200
semmap=1001
semmni=1000
semmns=4096
semmnu=1000
semume=1000
max_thread_proc=600
maxusers=64
dbc_min_pct=5
dbc_max_pct=5
maxdsiz=1073741824 # applies only to 32-bit applications
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
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
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
Installation Guide
16
= 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
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
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
shminfo_shmmin
shminfo_shmmni
shminfo_shmseg
seminfo_semmns
seminfo_semmni
seminfo_semmsl
seminfo_semmap
seminfo_semmnu
seminfo_semopm
seminfo_semume
=
=
=
=
=
=
=
=
=
=
=
2147483648
1
500
200
8192
5029
2000
5024
1024
512
512
17
rlim_fd_max = 4096
rlim_fd_cur = 2048
= 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.altibase
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
set shmsys:shminfo_shmmax
set shmsys:shminfo_shmmin
set shmsys:shminfo_shmmni
set shmsys:shminfo_shmseg
set semsys:seminfo_semmns
set semsys:seminfo_semmni
set semsys:seminfo_semmsl
set semsys:seminfo_semmap
set semsys:seminfo_semmnu
set semsys:seminfo_semopm
set semsys:seminfo_semume
set rlim_fd_max = 4096
set rlim_fd_cur = 2048
shm-related Parameters
= 2147483648
= 1
= 500
= 200
= 8192
= 5029
= 2000
= 5024
= 1024
= 512
= 512
# 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
Installation Guide
18
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 perform 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 following command: server create [DB Character-set] [National Character-set]
2.3.8.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
19
Database Character Set
Noarchivelog
Archivelog
MS949
US7ASCII
KO16KSC5601
BIG5
GB231280
MS936
UTF-8
SHIFT-JIS
EUC-JP
National Character Set
UTF-16
UTF-8
2.3.8.3 Step 3: Set Database Directories
Default Disk Database Directory
Installation Guide
20
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/altibase.properties file manually.
2.3.9 Confirm ALTIBASE HDB Properties

The next dialog box displays property values that have been set in the previous step.
21
Ex)
To change these properties after installation is complete, please modify the
following file: /qa_home/qd_team/sdy/altibase-HDB-server-6.5.1/conf/altibase.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]
Step 2: Database creation properties
1) Initial database size
[10M]
2) Database archive logging mode
[noarchivelog]
Installation Guide
22
3) Database character set

[MS949]
4) National character set
[UTF16]
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 :
Directory 2 :
Directory 3 :
After confirming these values, click Forward. The Ready to Install dialog box appears.
23
Click Forward to continue with the installation.
Installation Guide
24
2.3.10 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 necessary 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
2.3.11 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 Altibases Customer Support site (http://support.altibase.com)
and get a license key.
2.3.12 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
27
2.3.13 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 recommended 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
[ 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 ================
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
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
database manually.
to create a
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
31
2.3.14 Finish Installation

After successful installation, the following dialog box appears.
Installation Guide
32
Click Finish, and the following Environment Settings Guide message box appears.
33
2.3.15 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:
3.
Log out and then login again

Execute . ~/.bash_profile or source ~/.bash_profile
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.
If properties for database creation were not set during installation, execute the server
script.
$ sh post_install.sh dbcreate
$ server create utf8 utf8
Installation Guide
34
2.4 Installing ALTIBASE HDB Products on Windows

This section describes how to install an ALTIBASE HDB product.
Validate the System Environment
Choose Additional Installation Options
Register the ALTIBASE HDB License Key
Register ALTIBASE HDB as Windows Services
Finish Installation
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 Security Settings, point to Local Policies, and then click User Rights Assignment.
3.
In the Policy list, double-click Log on as a service.
35
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
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
2.
Move the slider to the bottom and select Never notify.
3.
Reboot Windows (Vista or 7).
4.
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 Registration 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.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
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 specified 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 uninstallation. 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.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
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 perform 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 following command: server create [DB Character-set] [National Character-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
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
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/altibase.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.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
and registry entities
Applies to all users on the system, and overwrites any userspecific settings
Applies to the current user

only, but can be overwritten by
system settings
File permissions
Granted to all users
Granted to the current user

only
Registering as a service
Yes
No
Allowing multiple server

instances
No. If a %ALTIBASE_HOME%
environment variable is set at
system level, then any user specific %ALTIBASE_HOME% is
ignored.
Yes. Each user can install and

configure their own server
instance.
45
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 registry 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
Click Next to install.
47
2.4.8 Install the ALTIBASE HDB Product
Once installation is complete, properties that have been set are written to the altibase.properties 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.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 support.
To upgrade to Enterprise Edition, visit Altibases 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
%$ cp license $ALTIBASE_HOME/conf/
Installation Guide
50
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
The following dialog box displays the execution result of the post_install_win.bat batch file.
Installation Guide
52
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 Windows service registration dialog box appears.
53
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
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

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 ALTIBASE HDB Package Installer starts up the ALTIBASE HDB server automatically.
To start up the ALTIBASE HDB server manually, execute the following command from the command 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

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
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 Altibases Customer Support site (http://support.altibase.com/).
Please refer to 2.2.2 Download the ALTIBASE HDB Package Installer for further information on supported 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 Installation 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.

$./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
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.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 settings file (e.g., .profile, .bash_profile, etc.) in the users account.
59
Installation Guide
60
2.5.7 Installing the ALTIBASE HDB Client Product
61
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
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

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
2.6 Installing ALTIBASE HDB Client Products on Windows

The following section describes how to install an ALTIBASE HDB Client Product on Windows:
Choosing Additional Installation Options

Please refer to 2.4.1 Check the Environment Before Installation.
Installation Guide
64

Type
In the following Installation Directory panel, enter the ALTIBASE HDB home directory, in which ALTIBASE 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
2.6.5 Installing the ALTIBASE HDB Client Product
Click Next to install.
Installation Guide
66
67
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 accounts
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 Uninstaller 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 previous 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 associated with particular versions of ALTIBASE HDB Products. Patches are bug fixes that are made available 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 System Parameters
Entering the Installation Directory
Checking the Patch Version
O
O
Setting ALTIBASE HDB Properties
Confirming the ALTIBASE HDB Properties
Installing the ALTIBASE HDB ODBC Driver
O (Windows Only)
Installing the ALTIBASE HDB Product
Registering the ALTIBASE HDB License Key
Previewing the ALTIBASE HDB Quick Settings

Guide
Registering ALTIBASE HDB as a Windows Service

O (Windows Only)
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
Entering the Installation Directory
Installing the ALTIBASE HDB ODBC Driver
O (Windows Only)
Installation Guide
72
4.1 About Patches
Installation Steps
Full Package
Patch Package
Setting ALTIBASE HDB Properties
73
4.2 Patching ALTIBASE HDB Server Products

The following sections describe how to apply patches for ALTIBASE HDB Server Products:
Downloading the ALTIBASE HDB Package Installer
Setting the Installation Mode
Installing the ALTIBASE HDB Product

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 Altibases Customer Support site (http://support.altibase.com/).

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


$./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

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
Installation Guide
76
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
Installation Guide
78
4.2.7 Installing the ALTIBASE HDB Product
79
Installation Guide
80
81
4.3 Patching ALTIBASE HDB Client Products

This section describes how to apply ALTIBASE HDB client patches.

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 appropriate installer for your operating system from Altibases Customer Support site (http://support.altibase.com/).

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

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

$./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

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 Client 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
Ex) Selecting Patch package
Installation Guide
84
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
4.3.7 Installing the ALTIBASE HDB Product
Installation Guide
86
87
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; however, UNIX users are recommended to set the resource limit values of a users 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 Systems

System Kernel parameter values can be confirmed or changed with a utility provided for each operating 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
File-Cache
Settings for the prevention of memory insufficiency due to the operating systems 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
Shared Memory
Semaphore
Parameter Name
Recommended Value (bytes)
shmmax
2G+1
shmmin
500
shmseg
200
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
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

20% for 8G or less, 10% for 8G
or more)
dbc_min_pct
5%
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 application 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
echo
echo
echo
2147483648 > /proc/sys/kernel/shmmax

4096 > /proc/sys/kernel/shmmni
200 32000 512 5029 > /proc/sys/kernel/sem
30 > /proc/sys/vm/swappiness
Checking Disk Configuration

Redo log files and data files generally experience disk I/O in ALTIBASE HDB. To minimize performance 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
Server 34
Windows 56
Properties 18, 41
ALTIBASE HDB Home Directory 2

Altibase Home 2
altibase_base_install.log File 4
APatch Directory 3
patchinfo File 3
S
System Parameters 15
B
U
Backup Directory 4
User Privileges 35
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 90
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

HDB 6.5.1 Installation Eng

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

HDB 6.5.1 Installation Eng

Uploaded by

Copyright:

Available Formats

ALTIBASE HDB Administration

ALTIBASE HDB Administration Installation Guide

2.4.14 Post-installation Tasks...............................................................................................................................................56

About This Manual

About This Manual

technical support workers

experience in using relational databases and an understanding of database concepts

computer programming experience

experience in database server, operating system or network administration

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

About This Manual

Indicates book titles, emphasis, or placeholder variables for which

Indicates commands within a paragraph, code in examples, etc.

Altibase Welcomes Your Comments

Any comments that you have about the manual

Your name, address, and phone number

About This Manual

1 About the ALTIBASE

About the ALTIBASE HDB Package Installer

1.1 Altibase Home

1.1 Altibase Home

1.1.1 ALTIBASE HDB Home Directory

When installing ALTIBASE HDB Server Products:

When installing ALTIBASE HDB Client Products:

1.2 APatch Directory

1.2 APatch Directory

1.2.1 Structure and Contents of the APatch Directory

1.2.2 patchinfo File

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

Base release: The entire package used for initial installation.

About the ALTIBASE HDB Package Installer

1.2 APatch Directory

1.2.3 pkg_patch_x_x_x_x.txt File

1.2.4 altibase_base_install.log File

1.2.5 Backup Directory

1.2 APatch Directory

About the ALTIBASE HDB Package Installer

1.2 APatch Directory

2 Installing Products with

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

7Installing Products with the ALTIBASE HDB Pack-

2.1 Hardware Requirements

2.1 Hardware Requirements

2.1.3 Hard Disk

2.2 ALTIBASE HDB Package Installer

2.2 ALTIBASE HDB Package Installer

Check the Environment Before Installation

Download the ALTIBASE HDB Package Installer

Start the ALTIBASE HDB Package Installer

Enter the Installation Directory and Select the Installation Type

Set ALTIBASE HDB Properties

Confirm ALTIBASE HDB Properties

Install the ALTIBASE HDB Product

Select the ALTIBASE HDB Edition

Register the ALTIBASE HDB License Key

Preview the ALTIBASE HDB Quick Settings Guide