ALTIBASE HDB AdministrationInstallation GuideRelease 6.5.1June 11, 2015ALTIBASE HDB Administration Installation GuideRelease 6.5.1Copyright 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 Corporation10F, Daerung PostTower II, 182-13,Guro-dong Guro-gu Seoul, 152-847, South KoreaTelephone: +82-2-2082-1000Fax: 82-2-2082-1099Homepage: http://www.altibase.comiiiContentsPreface ............................................................................................................................................................................ vAbout This Manual ...................................................................................................................................................................................viAudience.......................................................................................................................................................................................viSoftware Environment.............................................................................................................................................................viOrganization................................................................................................................................................................................viDocumentation Conventions ...............................................................................................................................................viOnline Manuals ........................................................................................................................................................................ viiAltibase Welcomes Your Comments................................................................................................................................ vii1. About the ALTIBASE HDB Package Installer ............................................................................................................ 11.1 Altibase Home .....................................................................................................................................................................................21.1.1 ALTIBASE HDB Home Directory ..................................................................................................................................21.2 APatch Directory.................................................................................................................................................................................31.2.1 Structure and Contents of the APatch Directory..................................................................................................31.2.2 patchinfo File.....................................................................................................................................................................31.2.3 pkg_patch_x_x_x_x.txt File .........................................................................................................................................41.2.4 altibase_base_install.log File.......................................................................................................................................41.2.5 Backup Directory..............................................................................................................................................................42. Installing Products with the ALTIBASE HDB Package Installer .............................................................................. 72.1 Hardware Requirements..................................................................................................................................................................82.1.1 Memory ...............................................................................................................................................................................82.1.2 CPU........................................................................................................................................................................................82.1.3 Hard Disk.............................................................................................................................................................................82.1.4 Network...............................................................................................................................................................................82.2 ALTIBASE HDB Package Installer ...................................................................................................................................................92.2.1 Basic Steps for Installing ALTIBASE HDB..................................................................................................................92.2.2 Download the ALTIBASE HDB Package Installer...................................................................................................92.2.3 Installation Mode.......................................................................................................................................................... 102.3 Installing ALTIBASE HDB Products on Unix........................................................................................................................... 112.3.1 Check the Environment Before Installation......................................................................................................... 112.3.2 Download the Package Installer.............................................................................................................................. 112.3.3 Set the Installation Mode........................................................................................................................................... 122.3.4 Start the ALTIBASE HDB Package Installer ........................................................................................................... 122.3.5 Enter the Installation Directory and Select the Installation Type................................................................ 132.3.6 Check System Parameters ......................................................................................................................................... 152.3.7 Set ALTIBASE HDB Properties................................................................................................................................... 182.3.8 Confirm ALTIBASE HDB Properties ......................................................................................................................... 212.3.9 Install the ALTIBASE HDB Product .......................................................................................................................... 252.3.10 Select the ALTIBASE HDB Edition ......................................................................................................................... 262.3.11 Register or Update the ALTIBASE HDB License Key....................................................................................... 262.3.12 Preview the ALTIBASE HDB Quick Settings Guide.......................................................................................... 282.3.13 Finish Installation........................................................................................................................................................ 322.3.14 Post-installation Tasks .............................................................................................................................................. 342.4 Installing ALTIBASE HDB Products on Windows .................................................................................................................. 352.4.1 Check the Environment Before Installation......................................................................................................... 352.4.2 Start the ALTIBASE HDB Package Installer ........................................................................................................... 382.4.3 Enter the Installation Directory and Select the Installation Type................................................................ 392.4.4 Validate the System Environment .......................................................................................................................... 412.4.5 Set ALTIBASE HDB Properties................................................................................................................................... 412.4.6 Confirm ALTIBASE HDB Properties ......................................................................................................................... 442.4.7 Choose Additional Installation Options................................................................................................................ 452.4.8 Install the ALTIBASE HDB Product .......................................................................................................................... 482.4.9 Select the ALTIBASE HDB Edition............................................................................................................................ 492.4.10 Register the ALTIBASE HDB License Key............................................................................................................ 492.4.11 Preview the ALTIBASE HDB Quick Settings Guide ......................................................................................... 512.4.12 Register ALTIBASE HDB as Windows Services.................................................................................................. 532.4.13 Finish Installation........................................................................................................................................................ 55iv2.4.14 Post-installation Tasks...............................................................................................................................................562.5 Installing ALTIBASE HDB Client Products on Unix ...............................................................................................................572.5.1 Checking the Environment Before Installation..................................................................................................572.5.2 Downloading the Package Installer........................................................................................................................572.5.3 Setting the Installation Mode...................................................................................................................................572.5.4 Starting the ALTIBASE HDB Package Installer.....................................................................................................572.5.5 Entering the Installation Directory and Selecting the Installation Type...................................................582.5.6 Setting ALTIBASE HDB Client Properties ..............................................................................................................592.5.7 Installing the ALTIBASE HDB Client Product .......................................................................................................612.5.8 Finishing Installation....................................................................................................................................................632.5.9 Post-installation Tasks .................................................................................................................................................632.6 Installing ALTIBASE HDB Client Products on Windows......................................................................................................642.6.1 Checking the Environment Before Installation..................................................................................................642.6.2 Starting the ALTIBASE HDB Package Installer.....................................................................................................642.6.3 Entering the Installation Directory and Selecting the Installation Type...................................................652.6.4 Choosing Additional Installation Options............................................................................................................652.6.5 Installing the ALTIBASE HDB Client Product .......................................................................................................662.6.6 Finishing Installation....................................................................................................................................................683. Uninstalling ALTIBASE HDB ....................................................................................................................................693.1 Uninstalling ALTIBASE HDB Products.......................................................................................................................................703.1.1 Full Uninstallation.........................................................................................................................................................703.1.2 Patch Uninstallation.....................................................................................................................................................704. Patching Products With the ALTIBASE HDB Package Installer.............................................................................714.1 About Patches...................................................................................................................................................................................724.1.1 Installation Types for ALTIBASE HDB Products...................................................................................................724.1.2 Installation Types for ALTIBASE HDB Client Products......................................................................................724.2 Patching ALTIBASE HDB Server Products................................................................................................................................744.2.1 Checking the Environment Before Installation..................................................................................................744.2.2 Downloading the ALTIBASE HDB Package Installer .........................................................................................744.2.3 Setting the Installation Mode...................................................................................................................................744.2.4 Starting the ALTIBASE HDB Package Installer.....................................................................................................744.2.5 Entering the Installation Directory and Selecting the Installation Type...................................................754.2.6 Checking the Patch Version ......................................................................................................................................774.2.7 Installing the ALTIBASE HDB Product ....................................................................................................................794.2.8 Finishing Installation....................................................................................................................................................814.3 Patching ALTIBASE HDB Client Products ................................................................................................................................824.3.1 Checking the Environment Before Installation..................................................................................................824.3.2 Downloading the ALTIBASE HDB Package Installer .........................................................................................824.3.3 Setting the Installation Mode...................................................................................................................................824.3.4 Setting the ALTIBASE HDB Package Installer ......................................................................................................824.3.5 Entering the Installation Directory and Selecting the Installation Type...................................................834.3.6 Checking the Patch Version ......................................................................................................................................854.3.7 Installing the ALTIBASE HDB Product ....................................................................................................................864.3.8 Finishing Installation....................................................................................................................................................87AppendixA. Installation Prerequisites .......................................................................................................................89Setting User Resource Limit Values..................................................................................................................................................89Setting Kernel Parameters for Different Operating Systems ..................................................................................................89Solaris...........................................................................................................................................................................................90HP-UX...........................................................................................................................................................................................90AIX.................................................................................................................................................................................................91LINUX ...........................................................................................................................................................................................92Checking Disk Configuration..............................................................................................................................................................92OS Patch.....................................................................................................................................................................................................92AIX.................................................................................................................................................................................................92v PrefacePrefaceAbout This ManualInstallation Guide viAbout This ManualThis manual describes how to install and configure ALTIBASE HDB on UNIX and Microsoft Windows. AudienceThis manual has been prepared for the following ALTIBASE HDB users: database managers performance managers database users application developers technical support workersIt 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 administrationSoftware EnvironmentThis manual has been prepared assuming that ALTIBASE HDB 6.5.1 is used as the database server.OrganizationThis 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 PrerequisitesDocumentation ConventionsThis 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.About This Manualvii PrefaceOnline ManualsOnline versions of our manuals (PDF or HTML) are available from Altibase's Customer Support site (http://support.altibase.com/).Altibase Welcomes Your CommentsPlease 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 numberIf 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.Convention MeaningItalic 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.About This ManualInstallation Guide viii 1 About the ALTIBASE HDB Package Installer 1 About the ALTIBASEHDB Package InstallerThe 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.1 Altibase HomeInstallation Guide 21.1 Altibase HomeWhen 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 DirectoryWhen you install ALTIBASE HDB with the ALTIBASE HDB Package Installer, a home directory (whereinALTIBASE 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- When installing ALTIBASE HDB Client Products:$HOME/altibase-HDB-client-1.2 APatch Directory3 About the ALTIBASE HDB Package Installer1.2 APatch DirectoryInformation 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 DirectoryAPatch 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_.txt file altibase_base_install.log file Backup directory1.2.2 patchinfo FileThis 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-releasePATCH_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 APatch DirectoryInstallation Guide 41.2.3 pkg_patch_x_x_x_x.txt FileThis file is automatically generated aspkg_patch_.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.txtThe 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.txtpkg_patch_0_0_0_10.txt%$cat pkg_patch_0_0_0_10.txtRepository: /altidev4/tags/altibase_6_1_1_0_10_tag/Revision: 42850Last Changed Rev: 428501.2.4 altibase_base_install.log FileAll operations during the most recent installation are written to this file.1.2.5 Backup DirectoryWhen 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 tomanually back updata 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.logpatchinfopkg_patch_0_0_0_0.txtuninstall-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:1.2 APatch Directory5 About the ALTIBASE HDB Package Installeraltibase_base_install.log pkg_patch_0_0_0_10.txtuninstall-p0_0_0_10 patchinforollback-p0_0_0_10/ pkg_patch_0_0_0_0.txtuninstall-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.1.2 APatch DirectoryInstallation Guide 6 7Installing Products with the ALTIBASE HDB Pack- 2 Installing Products withthe ALTIBASE HDBPackage InstallerThis 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 Windows2.1 Hardware RequirementsInstallation Guide 82.1 Hardware RequirementsThe 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 require-ments.2.1.1 Memory32-bit OS: Minimum 1GB (2GB recommended; maximum 4GB)64-bit OS: Minimum 1GB (2GB recommended, unlimited)2.1.2 CPU1 CPU or more (2 or more CPUs are recommended)2.1.3 Hard DiskALTIBASE 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 NetworkWe recommend that you use a dedicated line when using the replication feature.2.2 ALTIBASE HDB Package Installer9Installing Products with the ALTIBASE HDB Pack-2.2 ALTIBASE HDB Package Installer2.2.1 Basic Steps for Installing ALTIBASE HDBTo 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 Installation2. Download the ALTIBASE HDB Package Installer3. Start the ALTIBASE HDB Package Installer4. Enter the Installation Directory and Select the Installation Type5. Set ALTIBASE HDB Properties6. Confirm ALTIBASE HDB Properties7. Install the ALTIBASE HDB Product8. Select the ALTIBASE HDB Edition9. Register the ALTIBASE HDB License Key10. Preview the ALTIBASE HDB Quick Settings Guide11. Finish Installation12. Post-installation Tasks2.2.2 Download the ALTIBASE HDB Package InstallerYou can download the appropriate Package Installer for your operating system from Altibases Cus-tomer Support site (http://support.altibase.com/). ALTIBASE HDB Package Installer names follow the rule below.Ex) ALTIBASE HDB Server Package Installeraltibase-HDB-server-6.5.1.0-AIX-POWERPC-64bit-release.runaltibase-HDB-server-6.5.1.0-WINDOWS-X86-64bit-release.exeEx) ALTIBASE HDB Client Package Installeraltibase-HDB-client-6.5.1.0-AIX-POWERPC-64bit-release.runaltibase-HDB-client-6.5.1.0-WINDOWS-X86-64bit-release.exeThe 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. 2.2 ALTIBASE HDB Package InstallerInstallation Guide 10$ uname -aLinux 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/LinuxALTIBASE HDB 6.5.1.is compatible with JDK 1.4 or higher. 2.2.3 Installation ModeThe 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.OS CPU VersionBit (Server)Bit (Client)AIX PowerPC 6.1 tl03 or higher 64-bit 64-bit, 32-bitHP IA64 11.31 or higher 64-bit 64-bit, 32-bitLINUX x86, x86-64 (GNU glibc 2.12 or higher)redhat 6.0 or higher 64-bit 64-bit, 32-bitSUN SPARC 2.8 or higher 64-bit 64-bit, 32-bitWINDOWS x86, x86-64Windows 2008Windows 2012Windows 7, 864-bit 64-bit, 32-bit2.3 Installing ALTIBASE HDB Products on Unix11 Installing Products with the ALTIBASE HDB 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 Tasks2.3.1 Check the Environment Before InstallationPrior 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.2.3.2 Download the Package InstallerYou can download the appropriate Package Installer for your operating system from Altibases Cus-2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 12tomer 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 ModeThe 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 ModeUnix 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 :0.0 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=: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 InstallerTo 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.runRun the ALTIBASE HDB Package Installer.$./altibase-HDB-server-6.5.1.0.0-LINUX-X86-64bit-release.runIf the Package Installer is set to GUI mode, the following Setup wizard appears.2.3 Installing ALTIBASE HDB Products on Unix13 Installing Products with the ALTIBASE HDB 2.3.5 Enter the Installation Directory and Select the Installation TypeIn the following Installation Directory dialog box, enter the ALTIBASE HDB home directory and select the package installation type.2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 14To 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 speci-fied directory first.2.3 Installing ALTIBASE HDB Products on Unix15 Installing Products with the ALTIBASE HDB 2.3.6 Check System ParametersThe 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 = 2147483648shmmni = 500 shmseg = 200 semmap = 1001semmni = 1000semmns = 4096semmnu = 10002.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 16semume = 1000max_thread_proc = 600maxusers = 64dbc_min_pct = 5dbc_max_pct = 5maxdsiz = 1073741824maxdsiz_64bit = 4294967296# applies only to 32-bit applications# maxdsiz_64bitThe 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_64bitThe 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/semecho 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 = -1data = -1rss = -1Maximum number of PROCESSES allowed per user = greater than the value set using the Altibase property MAX_CLIENTSize of the File System BufferCache2.3 Installing ALTIBASE HDB Products on Unix17 Installing Products with the ALTIBASE HDB = less than 20% of total memory.AIO = AvailableAMO = AIX version 5.2 ML04 and abovelru_file_repage=0strict_maxclient%=0 = Versions prior to AIX version 5.2 ML04 lru_file_repage=0[ How to modify kernel parameter values ]Edit /etc/security/limits fileSet fsize, data and rss variables.Run 'smit'1) System EnvironmentsSystem Environments -> Change / Show Characteristics Of Operating SystemChange : Maximum number of PROCESSES allowed per user = bigger than the value set using the Altibase property MAX_CLIENTSize 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/OChange : posix_aio0=Available3) 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 RebootThe case of AIX version 5.2 ML04 and above : Change : lru_file_repage=0 strict_maxclient%=0The case of Versions prior to AIX version 5.2 ML04 : Change : lru_file_repage=0Ex) 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 = 2147483648shminfo_shmmin = 1shminfo_shmmni = 500shminfo_shmseg = 200seminfo_semmns = 8192seminfo_semmni = 5029seminfo_semmsl = 2000seminfo_semmap = 5024seminfo_semmnu = 1024seminfo_semopm = 512seminfo_semume = 5122.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 18rlim_fd_max = 4096rlim_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 Parametersprojadd -U altibase -K "project.max-sem-ids=(priv,5029,deny)" user.alti-baseprojmod -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 Parametersprojmod -a -K "project.max-msg-messages=(priv,100,deny)" user.altibase projmod -a -K "project.max-msg-ids=(priv,100,deny)" user.altibaseprojmod -a -K "process.max-msg-qbytes=(priv,1048576,deny)" user.altibase = is notSolaris 10=Edit /etc/system file.# Default Values for sem- and shm-related Parametersset shmsys:shminfo_shmmax = 2147483648set shmsys:shminfo_shmmin = 1set shmsys:shminfo_shmmni = 500 set shmsys:shminfo_shmseg = 200set semsys:seminfo_semmns = 8192 set semsys:seminfo_semmni = 5029 set semsys:seminfo_semmsl = 2000 set semsys:seminfo_semmap = 5024 set semsys:seminfo_semmnu = 1024set semsys:seminfo_semopm = 512 set semsys:seminfo_semume = 512set rlim_fd_max = 4096 set rlim_fd_cur = 2048# Message Queue-related Parametersprojmod -a -K "project.max-msg-messages=(priv,100,deny)" user.altibase projmod -a -K "project.max-msg-ids=(priv,100,deny)" user.altibaseprojmod -a -K "process.max-msg-qbytes=(priv,1048576,deny)" user.altibaseThese 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 PropertiesALTIBASE 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 Directories2.3 Installing ALTIBASE HDB Products on Unix19 Installing Products with the ALTIBASE HDB 2.3.7.1Step 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.8.2 Step 2: Database Creation PropertiesThe SQL script created in step 2 isstored in the $ALTIBASE_HOME/install/post_install.sh file. Initial Database Size Database Archive Logging Mode2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 20 Noarchivelog Archivelog Database Character Set MS949 US7ASCII KO16KSC5601 BIG5 GB231280 MS936 UTF-8 SHIFT-JIS EUC-JP National Character Set UTF-16 UTF-82.3.8.3 Step 3: Set Database Directories Default Disk Database Directory2.3 Installing ALTIBASE HDB Products on Unix21 Installing Products with the ALTIBASE HDB Memory Database Directory Archive Log Directory Transaction Log Directory Log Anchor Files DirectoryTo 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.9 Confirm ALTIBASE HDB PropertiesThe next dialog box displays property values that have been set in the previous step.2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 22Ex) 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/alti-base.properties.1. ALTIBASE HDB Property Settings:Step 1: Basic database operation properties1) 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 properties1) Initial database size [10M]2) Database archive logging mode [noarchivelog]2.3 Installing ALTIBASE HDB Products on Unix23 Installing Products with the ALTIBASE HDB 3) Database character set [MS949]4) National character set [UTF16]3. ALTIBASE HDB Property Settings:Step 3: Database Directory propertiesThe database will not operate properly if one or more of these directories are removed1) 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.2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 24Click Forward to continue with the installation.2.3 Installing ALTIBASE HDB Products on Unix25 Installing Products with the ALTIBASE HDB 2.3.10 Install the ALTIBASE HDB ProductWhen 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.envALTIBASE_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.env2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 262.3.11 Select the ALTIBASE HDB EditionALTIBASE 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 Altibases Customer Support site (http://support.altibase.com) and get a license key.2.3.12 Register or Update the ALTIBASE HDB License KeyThe 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 previ-ous 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_SIZEproperty is larger than or equal to the current value. The new value for the DISK_MAX_DB_SIZEproperty is larger than or equal to the current value. $ is -sysdbaiSQL(sysdba)> EXEC UPDATE_LICENSE;Validating new license...System HostID (0x00001111) and License HostID(0x00001111) match. PASSSystem MAC Address(11:11:11:11:11:11) and License MACAddress(11:11:11:11:11:11) match. PASSMEM_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.2.3 Installing ALTIBASE HDB Products on Unix27 Installing Products with the ALTIBASE HDB 2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 282.3.13 Preview the ALTIBASE HDB Quick Settings GuideThe 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.shThis 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.shThis 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.2.3 Installing ALTIBASE HDB Products on Unix29 Installing Products with the ALTIBASE HDB [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/semecho 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 2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 30been issued, or if the license file has expired, ALTIBASE HDB services will not start. In this case, please visit http://support.altibase.com3. 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 needto create a database manually.shell> server create [DB Character Set] [National Character Set]4. Start up and Shut down the servershell> server startshell> server stop5. Connect to the database using iSQLshell> isql -s 127.0.0.1 -u SYS -p MANAGERThe following message appears while a database is being created.2.3 Installing ALTIBASE HDB Products on Unix31 Installing Products with the ALTIBASE HDB 2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 322.3.14 Finish InstallationAfter successful installation, the following dialog box appears.2.3 Installing ALTIBASE HDB Products on Unix33 Installing Products with the ALTIBASE HDB Click Finish, and the following Environment Settings Guide message box appears. 2.3 Installing ALTIBASE HDB Products on UnixInstallation Guide 342.3.15 Post-installation TasksAfter 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 utf82.4 Installing ALTIBASE HDB Products on Windows35 Installing Products with the ALTIBASE HDB 2.4 Installing ALTIBASE HDB Products on WindowsThis 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 Tasks2.4.1 Check the Environment Before InstallationTo 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 PrivilegesIf 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 serviceand 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.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 364. 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.2.4 Installing ALTIBASE HDB Products on Windows37 Installing Products with the ALTIBASE HDB 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.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 382. 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 administratorNote: 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 InstallerAfter checking that the system is ready for installation, run the ALTIBASE HDB Package Installer. The following Setup wizard appears.2.4 Installing ALTIBASE HDB Products on Windows39 Installing Products with the ALTIBASE HDB 2.4.3 Enter the Installation Directory and Select the Installation TypeIn 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.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 40If 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.2.4 Installing ALTIBASE HDB Products on Windows41 Installing Products with the ALTIBASE HDB 2.4.4 Validate the System EnvironmentThe following dialog box displays the Pre-installation Guide described above.2.4.5 Set ALTIBASE HDB PropertiesALTIBASE 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 Directories2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 422.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 PropertiesThe SQL script created in step 2 isstored in the $ALTIBASE_HOME/install/post_install.sh file. Initial Database Size Database archive logging mode NoArchivelog Archivelog2.4 Installing ALTIBASE HDB Products on Windows43 Installing Products with the ALTIBASE HDB Database Character Set MS949 US7ASCII KO16KSC5601 BIG5 GB231280 MS936 UTF-8 SHIFT-JIS EUC-JP National Character Set UTF-16 UTF-82.4.5.3 Step 3: Set Database Directories Default Disk Database Directory Memory Database Directory Archive Log Directory Transaction Log directory2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 44To 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 PropertiesThe next dialog box displays property values that have been set in the previous step.2.4 Installing ALTIBASE HDB Products on Windows45 Installing Products with the ALTIBASE HDB 2.4.7 Choose Additional Installation OptionsAt 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 UserEnvironment variables and registry entitiesApplies to all users on the sys-tem, and overwrites any user- specific settingsApplies to the current user only, but can be overwritten by system settingsFile permissions Granted to all users Granted to the current user onlyRegistering as a service Yes NoAllowing multiple server instancesNo. If a %ALTIBASE_HOME% environment variable is set at system level, then any user spe-cific %ALTIBASE_HOME% is ignored. Yes. Each user can install and configure their own server instance.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 46The 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\system32Note: 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. 2.4 Installing ALTIBASE HDB Products on Windows47 Installing Products with the ALTIBASE HDB Click Next to install.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 482.4.8 Install the ALTIBASE HDB ProductOnce 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.2.4 Installing ALTIBASE HDB Products on Windows49 Installing Products with the ALTIBASE HDB 2.4.9 Select the ALTIBASE HDB EditionALTIBASE 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 Altibases Customer Support site (http://support.altibase.com) and get a license key.2.4.10 Register the ALTIBASE HDB License KeyThe 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. 2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 50%$ cp license $ALTIBASE_HOME/conf/2.4 Installing ALTIBASE HDB Products on Windows51 Installing Products with the ALTIBASE HDB 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.batThis 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.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 52The following dialog box displays the execution result of the post_install_win.bat batch file.2.4 Installing ALTIBASE HDB Products on Windows53 Installing Products with the ALTIBASE HDB 2.4.12 Register ALTIBASE HDB as Windows ServicesAt 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.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 54The 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.2.4 Installing ALTIBASE HDB Products on Windows55 Installing Products with the ALTIBASE HDB After registering ALTIBASE HDB as a Windows service, the ALTIBASE HDB Package Installer starts the service.2.4.13 Finish InstallationAfter successful installation, the following dialog box appears.2.4 Installing ALTIBASE HDB Products on WindowsInstallation Guide 562.4.14 Post-installation TasksAfter 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_charset2. 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 startNote: 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).2.5 Installing ALTIBASE HDB Client Products on Unix57 Installing Products with the ALTIBASE HDB 2.5 Installing ALTIBASE HDB Client Products on UnixThe 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 Tasks2.5.1 Checking the Environment Before InstallationPlease refer to 2.3.1 Check the Environment Before Installation.2.5.2 Downloading the Package InstallerYou can download the appropriate Package Installer for your operating system from Altibases 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 ModeTo 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 InstallerTo 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.runRun the ALTIBASE HDB Package Installer.$./altibase-HDB-client-6.5.1.0.0-LINUX-X86-64bit-release.runIf the installation mode is set to GUI mode, the following start panel appears.2.5 Installing ALTIBASE HDB Client Products on UnixInstallation Guide 582.5.5 Entering the Installation Directory and Selecting the Installation TypeIn 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. 2.5 Installing ALTIBASE HDB Client Products on Unix59 Installing Products with the ALTIBASE HDB 2.5.6 Setting ALTIBASE HDB Client PropertiesIn 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 users account. 2.5 Installing ALTIBASE HDB Client Products on UnixInstallation Guide 602.5 Installing ALTIBASE HDB Client Products on Unix61 Installing Products with the ALTIBASE HDB 2.5.7 Installing the ALTIBASE HDB Client Product2.5 Installing ALTIBASE HDB Client Products on UnixInstallation Guide 62During 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 again2.5 Installing ALTIBASE HDB Client Products on Unix63 Installing Products with the ALTIBASE HDB reapply the shell environment by executing . ~/.profile or source ~/.profile. The following is an example of .profile.# ALTIBASE_ENVexport ALTIBASE_HOME=/qa_home/qd_team/sdy/altibase-HDB-client-6.5.1export ALTIBASE_PORT_NO=20300export PATH=$ALTIBASE_HOME/bin:$PATHexport LD_LIBRARY_PATH=${ALTIBASE_HOME}/lib:${LD_LIBRARY_PATH}export CLASSPATH=${ALTIBASE_HOME}/lib/Altibase.jar:${CLASSPATH}2.5.8 Finishing Installation2.5.9 Post-installation TasksIf 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.2.6 Installing ALTIBASE HDB Client Products on WindowsInstallation Guide 642.6 Installing ALTIBASE HDB Client Products on Win-dowsThe 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 Installation2.6.1 Checking the Environment Before InstallationPlease refer to 2.4.1 Check the Environment Before Installation.2.6.2 Starting the ALTIBASE HDB Package Installer2.6 Installing ALTIBASE HDB Client Products on Windows65 Installing Products with the ALTIBASE HDB 2.6.3 Entering the Installation Directory and Selecting the Installation TypeIn 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 OptionsPlease refer to 2.4.7 Choose Additional Installation Options.2.6 Installing ALTIBASE HDB Client Products on WindowsInstallation Guide 662.6.5 Installing the ALTIBASE HDB Client ProductClick Next to install.2.6 Installing ALTIBASE HDB Client Products on Windows67 Installing Products with the ALTIBASE HDB 2.6 Installing ALTIBASE HDB Client Products on WindowsInstallation Guide 682.6.6 Finishing Installation 69 Uninstalling ALTIBASE HDB 3 Uninstalling ALTIBASEHDBALTIBASE 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 Uninstallation3.1 Uninstalling ALTIBASE HDB ProductsInstallation Guide 703.1 Uninstalling ALTIBASE HDB ProductsALTIBASE 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 UninstallationALTIBASE 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 UninstallationPatches installed using the ALTIBASE HDB Package Installer can be rolled back by running the Unin-staller named according to the convention uninstall-p. 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. 71 Patching Products With the ALTIBASE HDB 4 Patching Products Withthe ALTIBASE HDBPackage InstallerThis chapter consists of the following sections: About Patches Patching ALTIBASE HDB Server Products Patching ALTIBASE HDB Client Products4.1 About PatchesInstallation Guide 724.1 About PatchesA 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 ProductsTable 4-1 Full Package vs. Patch Package4.1.2 Installation Types for ALTIBASE HDB Client ProductsTable 4-2 Full Package vs. Patch PackageInstallation Steps Full Package Patch PackageChecking the Environment Before Installation O OStarting the ALTIBASE HDB Package Installer O OChecking System Parameters OEntering the Installation Directory O OChecking the Patch Version OSetting ALTIBASE HDB Properties OConfirming the ALTIBASE HDB Properties OInstalling the ALTIBASE HDB ODBC Driver O (Windows Only)Installing the ALTIBASE HDB Product O ORegistering the ALTIBASE HDB License Key OPreviewing the ALTIBASE HDB Quick Settings Guide ORegistering ALTIBASE HDB as a Windows Service O (Windows Only)Finishing Installation O OInstallation Steps Full Package Patch PackageChecking the Environment Before Installation O OStarting the ALTIBASE HDB Package Installer O OEntering the Installation Directory O OInstalling the ALTIBASE HDB ODBC Driver O (Windows Only)Checking the Patch Version O4.1 About Patches73 Patching Products With the ALTIBASE HDB Setting ALTIBASE HDB Properties OInstalling the ALTIBASE HDB Client Product O OFinishing Installation O OInstallation Steps Full Package Patch Package4.2 Patching ALTIBASE HDB Server ProductsInstallation Guide 744.2 Patching ALTIBASE HDB Server ProductsThe 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 Installation4.2.1 Checking the Environment Before InstallationPlease 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 InstallerAltibase 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 Sup-port site (http://support.altibase.com/). 4.2.3 Setting the Installation ModeTo 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 InstallerTo 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.runIf the installation mode is set to GUI mode, the following Start panel is displayed.4.2 Patching ALTIBASE HDB Server Products75 Patching Products With the ALTIBASE HDB 4.2.5 Entering the Installation Directory and Selecting the Installation TypeIn 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 package4.2 Patching ALTIBASE HDB Server ProductsInstallation Guide 764.2 Patching ALTIBASE HDB Server Products77 Patching Products With the ALTIBASE HDB Ex) Selecting Patch package4.2.6 Checking the Patch VersionThis 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.4.2 Patching ALTIBASE HDB Server ProductsInstallation Guide 784.2 Patching ALTIBASE HDB Server Products79 Patching Products With the ALTIBASE HDB 4.2.7 Installing the ALTIBASE HDB Product4.2 Patching ALTIBASE HDB Server ProductsInstallation Guide 804.2 Patching ALTIBASE HDB Server Products81 Patching Products With the ALTIBASE HDB 4.2.8 Finishing Installation4.3 Patching ALTIBASE HDB Client ProductsInstallation Guide 824.3 Patching ALTIBASE HDB Client ProductsThis section describes how to apply ALTIBASE HDB client patches. 4.3.1 Checking the Environment Before InstallationPlease refer to 4.2.1 Checking the Environment Before Installation.4.3.2 Downloading the ALTIBASE HDB Package InstallerAltibase 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 Altibases Customer Support site (http://support.alti-base.com/). 4.3.3 Setting the Installation ModeTo 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 InstallerTo 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.runRun the ALTIBASE HDB Package Installer.$./altibase-HDB-client-6.5.1.0.7-LINUX-X86-64bit-release.runIf the installation mode is set to GUI mode, the following Start panel is displayed.4.3 Patching ALTIBASE HDB Client Products83 Patching Products With the ALTIBASE HDB 4.3.5 Entering the Installation Directory and Selecting the Installation TypeIn 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 package4.3 Patching ALTIBASE HDB Client ProductsInstallation Guide 84Ex) Selecting Patch package4.3 Patching ALTIBASE HDB Client Products85 Patching Products With the ALTIBASE HDB 4.3.6 Checking the Patch VersionThis 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.4.3 Patching ALTIBASE HDB Client ProductsInstallation Guide 864.3.7 Installing the ALTIBASE HDB Product4.3 Patching ALTIBASE HDB Client Products87 Patching Products With the ALTIBASE HDB 4.3.8 Finishing Installation4.3 Patching ALTIBASE HDB Client ProductsInstallation Guide 88Setting User Resource Limit Values89 Installation PrerequisitesAppendix A. Installation PrerequisitesSetting User Resource Limit ValuesUser resource limit values can be confirmed or changed with the OS command, ulimit. File SizeThe maximum file size creatable by the processor. Data Segment SizeThe maximum size of logical memory the process can use (vsz field).Max Memory SizeThe 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 MemoryThe 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 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 Sys-temsSystem 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 MemorySettings related to the number of shared memory segments and its maximum size.Setting Kernel Parameters for Different Operating SystemsODBC Reference 90 File-CacheSettings for the prevention of memory insufficiency due to the operating systems file-cache. SemaphoreSemaphore settings for IPC connection. Other SettingsSolarisSetting 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 ValuesHP-UXSetting Kernel Parameters on HP-UXHP 11.31 or above: Kernel parameters can be set with the /usr/sbin/kctune utility.Classification Parameter Name Recommended Value (bytes)Shared Memory shmmax 2G+1shmmin 500shmseg 200Semaphore semmns 8192smmni 5029semmsl 2000semmap 5024semmnu 1024semopm 512semume 512semvmx 32767Setting Kernel Parameters for Different Operating Systems91 Installation PrerequisitesRecommended ValuesThe same values for shared memory and semaphore on Solaris are also recommended for HP-UX.AIXSetting Kernel Parameters on AIX HP 11i: Kernel parameters can be set with the /usr/bin/smit utility.Recommended ValuesThe same values for shared memory and semaphore on Solaris are also recommended for AIX.Setting File-CacheDepending 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 = 0Setting Posix AIOAIX provides the Posix AIO interfaces for improved disk I/O improvement which must be manually activated. However from AIX6.1 and higher, the interfaces are activated by default. 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 2GBmaxdsiz_64bit The amount of memory which is predicted that ALTIBASE HDB will usemax_thread_proc 600 or moremaxfiles 2048 or morenproc 6142maxusers 124Checking Disk ConfigurationODBC Reference 92Posix 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. LINUXSetting Kernel Parameters on LinuxKernel parameters can be set in the sem, shmmax, shmmni, swapiness files at the /proc/sys/kernel path.Recommended ValuesThe 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/shmmaxecho 4096 > /proc/sys/kernel/shmmniecho 200 32000 512 5029 > /proc/sys/kernel/semecho 30 > /proc/sys/vm/swappinessChecking Disk ConfigurationRedo 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 PatchAIXWhen 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).93 IndexIndexAALTIBASE HDB Home Directory 2Altibase Home 2altibase_base_install.log File 4APatch Directory 3patchinfo File 3BBackup Directory 4Ddatabase creation 28, 34Download 9FFull Uninstallation 70GGUI Mode 12HHardware Requirements 8home directory 13IInstallation Directory 13Installation Mode 10, 12Installation Type 13, 72Installing ALTIBASE HDB Client Products 57, 64Installing ALTIBASE HDB Products 11, 35KKernel Parameters 90LLicense 26, 49OOS 11OS Patch 92PPatch Uninstallation 70Patching Altibase HDB Client Products 82Patching Altibase HDB Server Products 74pkg_patch_x_x_x_x.txt File 4Post-installation TaskClient 63Server 34Windows 56Properties 18, 41SSystem Parameters 15UUser Privileges 35Index 94