Aleph Installation Kit

Version 20 and Later

This guide is for Linux and Solaris servers.
For AIX, refer to the document: Aleph 20 Installation Instructions ‐ AIX.
CONFIDENTIAL INFORMATION
The information herein is the property of Ex Libris Ltd. or its affiliates and any misuse or abuse 
will result in economic loss. DO NOT COPY UNLESS YOU HAVE BEEN GIVEN SPECIFIC 
WRITTEN AUTHORIZATION FROM EX LIBRIS LTD.
This document is provided for limited and restricted purposes in accordance with a binding 
contract with Ex Libris Ltd. or an affiliate. The information herein includes trade secrets and is 
confidential.

DISCLAIMER
The information in this document will be subject to periodic change and updating. Please confirm 
that you have the most current documentation. There are no warranties of any kind, express or 
implied, provided in this documentation, other than those expressly agreed upon in the 
applicable Ex Libris contract. This information is provided AS IS. Unless otherwise agreed, Ex 
Libris shall not be liable for any damages for use of this document, including, without limitation, 
consequential, punitive, indirect or direct damages.
Any references in this document to third‐party material (including third‐party Web sites) are 
provided for convenience only and do not in any manner serve as an endorsement of that third‐
party material or those Web sites. The third‐party materials are not part of the materials for this Ex 
Libris product and Ex Libris has no liability for such materials.

TRADEMARKS
ʺEx Libris,ʺ the Ex Libris bridge , Primo, Aleph, Alephino, Voyager, SFX, MetaLib, Verde, 
DigiTool, Preservation, URM, Voyager, ENCompass, Endeavor eZConnect, WebVoyage, Citation 
Server, LinkFinder and LinkFinder Plus, and other marks are trademarks or registered 
trademarks of Ex Libris Ltd. or its affiliates. 
The absence of a name or logo in this list does not constitute a waiver of any and all intellectual 
property rights that Ex Libris Ltd. or its affiliates have established in any of its products, features, 
or service names or logos. 
Trademarks of various third‐party products, which may include the following, are referenced in 
this documentation. Ex Libris does not claim any rights in these trademarks. Use of these marks 
does not imply endorsement by Ex Libris of these third‐party products, or endorsement by these 
third parties of Ex Libris products.
Oracle is a registered trademark of Oracle Corporation.
UNIX is a registered trademark in the United States and other countries, licensed exclusively 
through X/Open Company Ltd.
Microsoft, the Microsoft logo, MS, MS‐DOS, Microsoft PowerPoint, Visual Basic, Visual C++, 
Win32,
Microsoft Windows, the Windows logo, Microsoft Notepad, Microsoft Windows Explorer, 
Microsoft Internet Explorer, and Windows NT are registered trademarks and ActiveX is a 
trademark of the Microsoft Corporation in the United States and/or other countries.
Unicode and the Unicode logo are registered trademarks of Unicode, Inc.
Google is a registered trademark of Google, Inc.

Copyright Ex Libris Limited, 2011. All rights reserved.
Document released: November 28, 2011

Web address: http://www.exlibrisgroup.com
Table of Contents
Chapter 1 Introduction ................................................................................................ 5
Chapter 2 Pre‐Installation Information.................................................................... 7
Overview...................................................................................................... 7
Supported Topologies................................................................................ 8
Preparing for Installation .......................................................................... 8
Creating the ftp_from_exlibris Directory  ................................................8
Checking System Requirements  ...............................................................8
Downloading the AIK from the FTP Server ........................................... 9
Configuring Oracle SGA Size ................................................................. 10
Chapter 3 Aleph Installation .................................................................................... 11
Introduction............................................................................................... 11
The AIK Main Menu ................................................................................ 12
Step 1: Download Software from FTP Server....................................... 12
Download Aleph Software ......................................................................13
Download Oracle Software  ....................................................................13
Check if Aleph Software Was Downloaded Correctly ............................14
Check if Oracle Software Was Downloaded Correctly ...........................14
Step 2: Pre‐Installation Tasks .................................................................. 14
Pre‐Installation Checks  ..........................................................................15
Inserting Listener Definition to the /etc/services File as root User  .......15
Change System Parameters as root User  ...............................................15
Create Oracle User and DBA Group as root User .................................16
Create aleph User and exlibris Group as root User  ...............................17
Create Aleph and Oracle Directories in the Disk /exlibris as root User  17
Install COBOL Software as root User  ...................................................18
Create System Auto Startup/Shutdown Script and Links as root User  18

November 28, 2011 3

Aleph Installation Kit

Step 3: Oracle Database Installation and Configuration.....................  19
Extract Oracle Software as root User  .................................................... 19
Install Database ...................................................................................... 20
Create listener.ora and tnsnames.ora Files  ............................................ 20
Start Up Oracle Listener ........................................................................ 20
Check Connection to the Database Via Listener  .................................... 21
Create Oracle Start/Stop Scripts (Only on Dedicated Oracle Server)  .. 21
Increase Tablespace Size for Customer Databases  ................................. 22
Step 4: Third‐Party Product Installation ...............................................  22
Extract Binary Product Package ............................................................ 22
Step 5: Aleph Software Installation and Configuration......................  24
Extract Aleph Base ................................................................................. 24
Aleph Software Configuration  ............................................................... 25
Update License  ....................................................................................... 25
Install Service Pack  ................................................................................ 25
Relocate alephe Directory ....................................................................... 26
Update Auto Startup/Shutdown Script ................................................. 26
Step 6: Post‐Installation Tasks ................................................................  26
Update aleph User Logon Menu  ............................................................ 27
Run Test Compilation ............................................................................ 27
Add Tablespace Util  ............................................................................... 27
Startup Aleph Software .......................................................................... 28

Appendixes
Appendix A Manual Database Creation .................................................................... 31
Appendix B Import Demo Libs.................................................................................... 35
Appendix C Create Source Database Files List and Sizes ...................................... 37
Appendix D Relink Other Products/Copies to New Cobol .................................... 39
Appendix E How to Obtain a New Aleph Installation ........................................... 41
Appendix F Two‐Task Installation............................................................................. 43
Appendix G Oracle SGA Sizing................................................................................... 45
Introduction...............................................................................................  45
Checking the SGA Size ............................................................................  45
Increasing the SGA Size...........................................................................  46
Solving an SGA Parameter Error ...........................................................  46

4 November 28, 2011

1
Introduction
Ex Libris provides an automated Aleph Installation Kit (AIK) for customer self‐
installation. The installation should be performed by a local System 
Administrator. The installation can take up to a few hours, depending on the 
server.

NOTE:
To ensure that your server is suitable for Aleph v.20, fill out and e‐mail a 
copy of the Aleph ARC Sizing Request Form to 
[email protected]. Ex Libris has created a sizing calculator that 
allows you to do this calculation for your site on your own.

These documents are posted in the Upgrade Express part of the 
Documentation Center. Certification of your server hardware is a 
necessary step before installing the new version.

If you are purchasing new hardware for Aleph, you must receive 
confirmation of your proposed configuration prior to ordering it. Do not 
use the sizing calculator in this case. Instead, contact your sales 
representative, who will work with you and with the Ex Libris Sizing 
Manager to make sure the hardware and operating system you order are 
adequate to run the new release. If you have any questions at all about the 
capability of your hardware configuration, your sales representative can 
help you get definitive answers about it.

NOTES:
„ If you plan to install Oracle or create the Oracle database without 
using the Aleph Installation Kit, you must coordinate this in advance 
with Ex Libris by sending an SI to Aleph Support. Refer to the 
document Database Installation Requirements for RAC and Single 
Database for details on how to perform this type of installation. 
„ Ex Libris offers installation services at a cost to interested customers. 
Contact your local office to obtain a price.

November 28, 2011 5

Aleph Installation Kit

This document provides instructions for the automatic installation of Aleph 20 
using the Aleph Installation Kit (AIK). The package facilitates installation of 
Aleph 20, Oracle 11g, and the creation of an Oracle database.
The AIK includes the following components:
„ Installation package ‐ scripts and init files
„ Aleph software ‐ Aleph application and pre‐generated third‐party products 
(Java, Perl, Apache, and so on)
„ Oracle RDBMS v.11.1 Enterprise edition
„ Oracle database for Oracle RDBMS v.11.1

The Aleph installation using AIK involves the following steps: 
„ Download software from FTP server
„ Pre‐installation tasks
„ Oracle database installation and configuration
„ Third‐party product installation 
„ Aleph software installation and configuration
„ Post‐installation tasks

NOTE:
During the Aleph installation, two reboots of the server are required: one 
for new values of the system parameters to take effect and the other to test 
startup scripts. Other Ex Libris applications on the server that use Oracle 
experience a short downtime as well when the new Oracle 11g listener is 
configured. The downtimes occur during Step 3 of the Oracle installation 
and configuration. For more information, see Step 3: Oracle Database 
Installation and Configuration on page 19.

6 November 28, 2011

2
Pre-Installation Information

This section includes:
„ Overview on page 7
„ Preparing for Installation on page 8
„ Downloading the AIK from the FTP Server on page 9
„ Configuring Oracle SGA Size on page 10

Overview
The AIK can be downloaded from the Ex Libris FTP server or, in special 
circumstances, supplied as a DVD package for customers with strict security 
policies.
Customers should open a support incident (SI) in order to:
„ Obtain the Aleph Installation Kit (AIK) and license 
„ Order an installation based on a contract
„ Order an installation as a professional service
See Appendix E: How to Obtain a New Aleph Installation on page 41 for more 
information.
The Aleph installation is performed in the following standard directories:
„ Aleph software under the directory /exlibris/aleph/a20_<slot>
„ Oracle software under the directory /exlibris/app/oracle/product/11 
A single log file containing confirmation and feedback on the installation, the 
status of each step, and reporting errors is created. This log file is placed under:
/exlibris/ftp_from_exlibris/aik/log/aleph_installation_kit.log

November 28, 2011 7

Aleph Installation Kit

Supported Topologies
The Aleph Installation Kit supports the following two kinds of Aleph 
topologies:
„ All‐in‐one installation – both application and data base are installed at the 
same server
„ TWO‐TASK mode – application and database installed on separate servers. 
For more information, see Appendix F: Two‐Task Installation on page 43.
Coordinate the installation of any other kind of topology with the local support 
office and installation team.

Preparing for Installation

Before the AIK can be installed, the server must meet specific requirements and 
contain a download directory for the installation files.

Creating the ftp_from_exlibris Directory

If you are installing a fresh copy of Aleph 20.01 on a server that does not have an 
earlier version of Aleph, perform the following steps to create the 
ftp_from_exlibris directory:
1 Log on to the server as root.
2 Enter the following commands to create the ftp directory:

cd /exlibris
mkdir ftp_from_exlibris

Checking System Requirements

Before installing Aleph, verify that all operating system components comply 
with the Aleph requirements, as outlined in Requirements for Aleph Installation. 
Check and update the /etc/hosts file as follows, if required:

vi /etc/hosts

Figure 1 shows an example of a /etc/hosts file. When configuring the file:
„ The first active line should be configured exactly as shown.
„ The second line should contain the internal IP address followed by the fully 
qualified name (host name + domain name), and then the short name and 
possible aliases.

8 November 28, 2011

 Chapter 2: Pre-Installation Information

Figure 1:
# Do not remove the following line, or various programs
# that require network functionality will fail.
127.0.0.1 localhost.localdomain localhost
10.1.222.22 aleph-inst.corp.aleph.com aleph-inst

Figure 1: Example of /etc/hosts File

The internal IP address can be found using the following commands.
„ For Sun:

/usr/sbin/ifconfig -a | grep inet | grep -v 127.0.0.1 |

awk
'{print $2}'

„ For Linux:

/sbin/ifconfig -a | grep addr: | grep -v 127.0.0.1 |

awk '{print $2}'

IMPORTANT:
Any changes in the /etc/hosts file should be performed by a qualified 
System Administrator only.

Downloading the AIK from the FTP Server

To download the installation package from the Ex Libris FTP server, execute the 
following commands from your server:

cd /exlibris/ftp_from_exlibris
ftp ftp.exlibrisgroup.com [<username>:aik ; <password>]
ftp prompt> cd scripts
ftp prompt> bin
ftp prompt> get aik.20.<date>.tar
ftp prompt> quit

Enter the following command to extract the AIK package:

tar -xvf aik.2.02.tar

cd aik
./ikit_menu

November 28, 2011 9

Aleph Installation Kit

Configuring Oracle SGA Size

To increase the performance of the Oracle database, adjust the Oracle SGA size 
for the created database. For more information, see Appendix G: Oracle SGA 
Sizing on page 45.

10 November 28, 2011

3
Aleph Installation

This section includes:
„ Introduction on page 11
„ Step 1: Download Software from FTP Server on page 12
„ Step 2: Pre‐Installation Tasks on page 14
„ Step 3: Oracle Database Installation and Configuration on page 19
„ Step 4: Third‐Party Product Installation on page 22
„ Step 5: Aleph Software Installation and Configuration on page 24
„ Step 6: Post‐Installation Tasks on page 26

Introduction
Perform all AIK steps in the order displayed in the AIK main menu ‐ that is, first 
complete the functions under Step 1 in the order listed. When those functions 
are completed, proceed to Step 2, and so forth.

NOTE:
Steps that should be performed by the root or oracle user have a 
corresponding note. All other steps should be performed as the aleph 
user.

You can exit the AIK at any stage of the installation. To restart the process, enter 
the following commands:

cd /exlibris/ftp_from_exlibris/aik
./ikit_menu

A single log file, containing confirmation and feedback on the installation, the 
status of each step, and reporting errors can be found under:
/exlibris/ftp_from_exlibris/aik/log/aleph_installation_kit.log

November 28, 2011 11

Aleph Installation Kit

The AIK Main Menu

The AIK main menu (see Figure 1) is used throughout the Aleph installation, 
outlining the main steps of the installation. The main menu has a header that 
includes the current date and operating system used. The Aleph directory and 
the Oracle database fields are populated once the relevant components are 
installed. 
Figure 1:
Aleph Installation Kit
---------------------------------------------------------------------

Date: Sun Feb 04 14:55:20 IST 2007

OS: Linux
Aleph version: 20.00
Aleph directory:
Oracle database:

---------------------------------------------------------------------

- 1. Download software from FTP server

- 2. Pre-installation tasks
- 3. Oracle database installation and configuration
- 4. Third-party products installation
- 5. Aleph software installation and configuration
- 6. Post-installation tasks

Enter key (q to quit)[q]:

Figure 1: The Main AIK Menu

Step 1: Download Software from FTP Server

The first step in the main menu is to download the software from the FTP site.
Enter 1 to display the Download software from FTP server menu (see Figure 2).

NOTE:
Root access is required to perform the download tasks.

12 November 28, 2011

 Chapter 3: Aleph Installation

Figure 2:
Aleph Installation Kit
---------------------------------------------------------------------

Date: Sun Feb 04 14:56:47 IST 2007

OS: Linux
Aleph version: 20.00
Aleph directory:
Oracle database:

---------------------------------------------------------------------
1. Download software from FTP server

- 1. Download Aleph software

- 2. Download Oracle software
- 3. Check if the Aleph software was downloaded correctly
- 4. Check if Oracle software was downloaded correctly

Enter key (q to quit)[q]:

Figure 2: The Download Software from FTP Server Menu

Download Aleph Software

This utility uses the wget client for downloading Aleph software from the Ex 
Libris FTP server.
An e‐mail message is sent to the address you specify when the FTP download 
completes.
Enter 1 to download the Aleph software. The system prompts for the following: 
„ target download directory name — The default is 
/exlibris/ftp_from_exlibris. 
„ Press Y to use passive FTP.
„ e‐mail address for the download confirmation message — Enter your e‐mail 
address.

NOTE:
Ex Libris recommends using the suggested defaults wherever possible to 
avoid changes.

Download Oracle Software

This utility uses the wget client for downloading the Oracle software from the 
Ex Libris FTP server.
An e‐mail is sent to the specified address when the FTP download is complete.   

November 28, 2011 13

Aleph Installation Kit

Enter 2 to download the Oracle software. The system prompts for the following: 
„ target download directory name — The default is 
/exlibris/ftp_from_exlibris.
„ e‐mail address for the download confirmation message — Enter your e‐mail 
address. The default is the e‐mail address you entered in the previous step.

Check if Aleph Software Was Downloaded Correctly

This utility checks whether or not the Aleph software was downloaded 
correctly. When complete, an e‐mail is sent to the specified address.
This step prompts for the following information: 
„ target download directory name – The default directory is 
/exlibris/ftp_from_exlibris.
„ e‐mail address for the download confirmation message – The default is the 
e‐mail address entered previously (see Download Aleph Software on 
page 13).

Check if Oracle Software Was Downloaded Correctly

This utility checks to see whether or not the Oracle software was downloaded 
correctly. When complete, an e‐mail is sent to the specified address.
This step prompts for:
„ target download directory name – The default directory is 
/exlibris/ftp_from_exlibris.
„ e‐mail address for the download confirmation message – The default is the 
e‐mail address entered previously (see Download Aleph Software on 
page 13).
If you encounter a problem with the download and cannot resolve it, contact 
your local support office.

Step 2: Pre-Installation Tasks

This menu (see Figure 3) contains the tasks that must be entered before 
installation.

NOTE:
Root access is required to perform the pre‐installation tasks.

14 November 28, 2011

 Chapter 3: Aleph Installation

Figure 3:
Aleph Installation Kit
---------------------------------------------------------------------

Date: Sun Feb 04 14:57:37 IST 2007

OS: Linux
Aleph version: 20.01
Aleph directory:
Oracle database:

---------------------------------------------------------------------
2. Pre-installation tasks

- 1. Pre-installation checks
- 2. Inserting listener definition to the /etc/services file as root
user
- 3. Change system parameters as root user
- 4. Create oracle user and dba group as root user
- 5. Create aleph user and exlibris group as root user
- 6. Create Aleph and Oracle directories as root user
- 7. Install COBOL software as root user
- 8. Create system auto startup/shutdown script and links as root user

Enter key (q to quit)[q]:

Figure 3: Pre-Installation Tasks Menu

Pre-Installation Checks
This step checks whether the server meets the specifications required for Aleph 
version 20.0 installation.

Inserting Listener Definition to the /etc/services File as root

User
This step inserts the following string into the /etc/services file, if required:

listener 1521/tcp # Oracle listener

Change System Parameters as root User

This step checks the system parameters in the system configuration file.
Open a new session on your server as the root user and check that the system 
variables in the configuration file include the parameters below:

NOTE:
The following system parameters are a required minimum. They can be 
changed later according to the size of the DB on the server.

November 28, 2011 15

Aleph Installation Kit

„ Linux Servers — Using any text editor, create or edit the /etc/
sysctl.conf file, and add or edit lines similar to the following. Include 
lines only for the kernel parameter values that you want to change. For the 
semaphore parameters (kernel.sem), you must specify all four values. 
However, if any of the current values are larger than the minimum value, 
then specify the larger value:

fs.file-max = 65536
kernel.shmall = 2097152
kernel.shmmax = 2147483648
kernel.shmmni = 4096
kernel.sem = 250 32000 100 128
net.ipv4.ip_local_port_range = 9000 65500
net.core.rmem_default = 262144
net.core.rmem_max = 4194304
net.core.wmem_default = 262144
net.core.wmem_max = 1048576

Enter the following command to change the current values of the kernel 
parameters:

# /sbin/sysctl -p

„ Sun Solaris 8 and 9 — The following system parameters should be present in 
the 
/etc/system file:

set shmsys:shminfo_shmmax = 4294967295

set shmsys:shminfo_shmmin = 1
set shmsys:shminfo_shmseg = 10
set shmsys:shminfo_shmmni = 100
set semsys:seminfo_semmns = 1530
set semsys:seminfo_semmsl = 400
set semsys:seminfo_semopm = 100
set semsys:seminfo_semvmx = 32767
set semsys:seminfo_semmni = 140
set rlim_fd_max = 4096
set rlim_fd_cur = 1024

„ Sun Solaris 10 – Add the following parameters:
„ projadd group.dba
„ projmod -s -K "project.max-shm-
memory=(privileged,10GB,deny)" group.dba

Create Oracle User and DBA Group as root User

This step creates the dba group and Oracle 11g oracle user with the user home 
set to /exlibris/app/oracle/product/11 and user shell set to /bin/csh.

16 November 28, 2011

 Chapter 3: Aleph Installation

The new oracle user must contain only alphanumeric characters, and use only 
lower‐case alphabetic characters. When creating the new user for Oracle 11g, the 
utility prompts for a new UNIX password.
If the Oracle 10g/9i/8 oracle user already exits in the system, the utility 
prompts for the name of the Oracle 11g user. Give the new Oracle 11g user a 
different name than the Oracle 10g/9i/8 user (such as oracle11).

NOTE:
The new Oracle11g user is created with the same UID as the existing 
Oracle 10g/9i/8 user.

Create aleph User and exlibris Group as root User

This step creates the exlibris group and the aleph user with the user home set 
to /exlibris/aleph and the user shell set to /bin/csh. 
If the aleph user already exists, make sure its home directory is set to
/exlibris/aleph by running the following command:

echo ~aleph

If the home directory for this user is not /exlibris/aleph, delete the user and 
then re‐run this step to recreate it with the correct definitions.

Create Aleph and Oracle Directories in the Disk /exlibris as

root User
This step prompts you for the following:
„ The installation type. Select SW_ONLY if the database already exists or will be 
installed on a remote server. Select DB_ONLY when Aleph 20 SW exists or 
will be installed on a remote server. If you select ALL or DB_ONLY, you are 
also prompted for database datafile locations.
„ The database disk location for archiving [/exlibris] 
„ The database disk location for redo files [/exlibris]
„ The database disk location for data files [/exlibris]
For example: 
„ The database disk location for archiving [/exlibris] /exlibris1
„ The database disk location for redo files [/exlibris] /exlibris2
„ The database disk location for data files [/exlibris] /exlibris1

November 28, 2011 17

Aleph Installation Kit

NOTE:
Directories for DB installation can be installed on three different mount 
points.

This step creates the following directories:
Table 1. Directories

Directory Permissions
/exlibris1/oradata oracle:dba permissions

/exlibris2/oradata oracle:dba permissions

/exlibris1/oradata oracle:dba permissions

/exlibris/app/oracle/product oracle:dba permissions

/exlibris/aleph aleph:exlibris permissions

/exlibris/aleph/ora_aleph aleph:exlibris permissions

/exlibris/aleph/backup_temp aleph:exlibris permissions

/exlibris/tmp aleph:exlibris permissions

/exlibris/startup aleph:exlibris permissions

/exlibris/product aleph:exlibris permissions

Install COBOL Software as root User

This step prompts you to enter the location for the third‐party product 
distribution package (default is /exlibris/ftp_from_exlibris).
„ Linux Servers — COBOL Server Express 5.0 is installed.
„ SUN Servers — COBOL Server Express 2.2 is installed.
If Cobol 4.0.0 is already installed on the server, you are prompted to confirm the 
upgrade. Upgrading is highly recommended but not mandatory.
If another applications installed on the server is using Cobol 4.0.0, you need to 
link that application to the new Cobol version. For instructions, see Appendix 
D: Relink Other Products/Copies to New Cobol on page 39.

Create System Auto Startup/Shutdown Script and Links as

root User
This step creates the main startup/shutdown script in /etc/init.d/exlibris, 
if required.
Required links for automatic startup and shutdown of Aleph and the database 
(when rebooting) are also created.

18 November 28, 2011

 Chapter 3: Aleph Installation

NOTE:
If the startup mechanism already exists, AIK only updates files in the 
/exlibris/startup directory and checks if relevant files and links in the 
system directories exist.

Step 3: Oracle Database Installation and

Configuration

NOTE:
You must run step Extract Oracle Software as root User on page 19 as the 
root user. All later steps can use either the oracle11 user or the root 
user.

Figure 4:
Aleph Installation Kit
---------------------------------------------------------------------

Date: Sun Feb 04 14:57:50 IST 2007

OS: Linux
Aleph version: 20.01
Aleph directory:
Oracle database:

---------------------------------------------------------------------
3. Oracle database installation and configuration

- 1. Extract Oracle software

- 2. Create listener.ora and tnsnames.ora file
* 3. Install database
- 4. Check connection to the database via listener
* 5. Create Oracle start/stop scripts(only on Dedicated Oracle
Server)

Enter key (q to quit)[q]:

Figure 4: Oracle Database Installation and Configuration Menu

Extract Oracle Software as root User

This step prompts you to enter the location of the Oracle 11g software 
distribution package files (default is /exlibris/ftp_from_exlibris).
This step extracts the Oracle software to the following directory:
/exlibris/app/oracle/product/11

November 28, 2011 19

Aleph Installation Kit

Install Database
This step prompts you to enter the following parameters:
„ location of the database installation script files — The default is 
/exlibris/ftp_from_exlibris.
„ location of the database media files — The default is 
/exlibris/ftp_from_exlibris.
„ name of the database you want to install —The default is meta4.
„ confirmation of the DB files distribution:
„ location of the database archive files [default is /exlibris]
„ location of the database system files [default is /exlibris]
„ location of the database data files [default is /exlibris]
Figure 5 is an example screen shot:
Install database

Please enter the location of the db_copy scripts [/exlibris/

ftp_from_exlibris] :
Please enter the location of the db files [/exlibris/
ftp_from_exlibris] :
Please enter the name of the database,no longer then 8 chars [aleph20]
:
According to your info Data-Base will be installed on the following:
for each value, enter new value or confirm
Archiving [/exlibris] :
Redo logs and System files [/exlibris] :
Data files [/exlibris1] :

Installing database ... please wait ...

Figure 5: Install Database

Create listener.ora and tnsnames.ora Files

This step adds the created database definitions to the listener.ora and 
tnsnames.ora files.
If this is a remote DB, you are prompted for the following:
Enter the Oracle host [<FQDN>]
Enter the Oracle SID [aleph20]

Start Up Oracle Listener

This step starts up the Oracle 11g listener.

20 November 28, 2011

 Chapter 3: Aleph Installation

If the Oracle 9i/10g listener is already running (for example, if other Ex Libris 
applications are running on this server), instructions for shutting down the 
running listener are provided.

NOTE:
Shutting down the Oracle 9i/10g listener in order to start up the Oracle 11g 
listener, results in a short downtime for all applications on this server that 
are running Oracle.

The following procedure should be used if there is a listener already running:
1 Log on to the server as the running listener user and type: 
lsnrctl stop
The AIK menu takes you through the next steps:
2 Do not close the existing window. Open a new terminal window. In the 
second window, perform a shutdown of the other Ex Libris applications on 
the server that are using currently running listener (using a standard 
shutdown procedure for each application).
3 In this additional terminal window, shut down the currently running Oracle 
listener using UTIL O/2 or standard utility for listener shutdown (as oracle, 
lsnrctl stop).
4 In the first terminal window, re‐run this procedure.
5 In the additional terminal window, start up the other Ex Libris applications 
on this server that were shut down (using the standard startup procedure 
for each application).

NOTE:
Once Oracle 11g is started, all applications running Oracle on this server 
will operate on the new Oracle 11g listener.

Check Connection to the Database Via Listener

This step checks the connection to the created database via the listener.   

NOTE:
Listener status is available after at least two minutes have passed since the 
previous step was executed.

Create Oracle Start/Stop Scripts (Only on Dedicated Oracle

Server)
Creating start/stop scripts should only be done on the Oracle server.

November 28, 2011 21

Aleph Installation Kit

Increase Tablespace Size for Customer Databases

The Aleph Installation Kit provides databases with minimal tablespace sizes. 
Some of these tablespaces should be increased for normal Aleph functionality. 
The following table contains the recommended sizes for TEMP and UNDO 
tablespaces:
Table 2. Tablespace Size Recommendations

DB Size Tablespace Size

UNDO TEMP
DEMO  500MB 1GB

SMALL 1GB 2GB

LARGE  2GB 4GB

Increase the tablespace size with the Aleph UTIL O/13/2 utility. For more 
information on UTIL O, refer to the Aleph System Administration Guide.

Step 4: Third-Party Product Installation

Figure 5:
Aleph Installation Kit
---------------------------------------------------------------------

Date: Sun Feb 04 14:58:23 IST 2007

OS: Linux
Aleph version: 20.01
Aleph directory:
Oracle database:

---------------------------------------------------------------------
4. Third-party product installation

- 1. Extract binary product package

Enter key (q to quit)[q]:

Figure 6: Third-Party Product Installation

Extract Binary Product Package

The utility installs all relevant third‐party products under the 
/exlibris/product directory.
It first prompts you to enter the location of the third‐party product distribution 
package files. The default location is /exlibris/ftp_from_exlibris. 

22 November 28, 2011

 Chapter 3: Aleph Installation

Figure 6:
Installing /exlibris/product directory

Please enter the location of the Aleph software media files [/

exlibris/ftp_from_exlibris] :

Installing /exlibris/product ... please wait ...

/exlibris/ftp_from_exlibris/aik
INFO: Extracting files...
INFO: relocating product dirs...
INFO: apache-ant-1.6.1
INFO: apache-tomcat-5.5.25
INFO: db-4.5.20
INFO: gnu_ghostscript-8.15
INFO: httpd-2.0.61
INFO: ImageMagick-6.4.1
INFO: jakarta-tomcat-5.0.25
INFO: jasper-1.900.1
INFO: jdk1.5.0_14
INFO: jpeg2000.sdk.3.18
INFO: jpeg-6b
………….
……………..
………………..
………………….
INFO: libpng-1.2.18
INFO: libxml2-2.6.29
INFO: libxslt-1.1.21
INFO: linklist
INFO: make-3.80
INFO: md5
INFO: openssl-0.9.8g
INFO: patch-2.5
INFO: perl-5.8.8
INFO: saxon
INFO: tar-1.15.1
INFO: tiff-3.8.2
INFO: wget-1.9
INFO: bin/shutdown.sh
INFO: bin/startup.sh
INFO: bin/tar
INFO: bin/wget
INFO: Fixing product permissions
INFO: Erasing temporary product dir
INFO: Third party product installation done

The binary product package was extracted to the /exlibris/product

Press any key to continue

Figure 7: Extract Binary Product Package

November 28, 2011 23

Aleph Installation Kit

Step 5: Aleph Software Installation and

Configuration
For a completely new installation of Aleph, you must run the first step (Extract 
Aleph software) as user root.                                                                                                             
If the Aleph installation exists on the same server, this step can be performed as 
user aleph.
The rest of the steps can be performed as user aleph or continued as user root.
Figure 7:
Aleph Installation Kit
---------------------------------------------------------------------

Date: Sun Feb 04 14:58:39 IST 2007

OS: Linux
Aleph version: 20.01
Aleph directory:
Oracle database:

---------------------------------------------------------------------
5. Aleph software installation and configuration

- 1. Extract Aleph Base

- 2. Aleph software configuration
- 3. Update license
- 4. Install Service Pack
- 5. Relocate alephe directory
- 6. Update auto startup/shutdown script

Enter key (q to quit)[q]:

Figure 8: Aleph Software Installation and Configuration

Extract Aleph Base

This step has two phases:
„ The first prompts you to enter the:
„ location of Aleph software files [default is /exlibris/
ftp_from_exlibris]
„ copy number of Aleph installation [default 1]
„ The second phase prompts for selecting cataloging formats. You can choose 
from the following [mab, uni, usm] or no default. At least one must be 
chosen. When installing more than one format, enter each one in a different 
line (with ENTER between formats). See the following example:

24 November 28, 2011

 Chapter 3: Aleph Installation

Figure 8:
Please choose format, insert preferable one first, the available
Formats are: mab,uni,usm:(q to quit) usm
Please choose format, insert preferable one first, the available
Formats are: mab,uni,usm:(q to quit) uni
Please choose format, insert preferable one first, the available
Formats are: mab,uni,usm:(q to quit) q

Figure 9: Extract Aleph Base

Selecting all three is also acceptable.

IMPORTANT:
The first format entered is the main format of the installation.

Aleph Software Configuration

This step prompts you to enter:
„ The server WWW server name (FQDN)
„ The Oracle server short hostname
„ Additional languages to install (fre/ger) and if it should be the main 
language

Update License
This step asks the installer to update the Aleph 20 license files using the UNIX vi 
text editor.
The license files are located at:
„  /exlibris/aleph/a20_<slot>/alephe/tab/license
„ /exlibris/aleph/a20_<slot>/alephe/tab/license.www_x

IMPORTANT:
This is a mandatory step. If it fails, do not continue with the installation.

Install Service Pack

This step installs the Aleph 20 Service Pack (if applicable). It prompts you to 
enter the location of the Aleph Service Pack distribution package files. The 
default is 
/exlibris/ftp_from_exlibris.
A failure message may be displayed during SP installation if the installed 
version is equal or higher than the SP package. This is not actually an 
installation failure.

November 28, 2011 25

Aleph Installation Kit

For example:

Error: Your Service Pack level is 2261. sp.utility not

found. Exiting.
Error: failed to install the service pack

Relocate alephe Directory

This step:
„ deletes unnecessary language files
„ deletes unused DB users, according to the selected formats
„ relocates the alephe directory and creates the u tree

Update Auto Startup/Shutdown Script

This step creates the startup scripts and the init.dat file under the /exlibris/
startup directory.

Step 6: Post-Installation Tasks

This menu contains the post‐installation tasks (see Figure 10).
Figure 9:
Aleph Installation Kit
---------------------------------------------------------------------

Date: Sun Feb 04 15:00:21 IST 2007

OS: Linux
Aleph version: 20.01
Aleph directory:
Oracle database:

---------------------------------------------------------------------
6. Post-installation tasks

- 1. Update aleph user login menu

- 2. Run test compilation
- 3. Add table spaces util
- 4. Startup Aleph software

Enter key (q to quit)[q]:

Figure 10: Post-Installation Tasks

26 November 28, 2011

 Chapter 3: Aleph Installation

Update aleph User Logon Menu

This step adds the newly installed Aleph software to the aleph user login menu. 
The files /exlibris/aleph/def_aleph.dat and /exlibris/aleph/
def_version are updated. 

Run Test Compilation

This step checks if the installed Aleph software is configured correctly and is 
ready for future Aleph 20 Service Pack installations.

Add Tablespace Util

To add the tablespace utility:

1 In order to add data files to the new Aleph 20 database, you need to get a list 
of data files and sizes from the previous Aleph version. Get the list of data 
files by using the sdbdesc.sh util or util O1 4 8 as described in Appendix 
C: Create Source Database Files List and Sizes on page 37.
2 If the /exlibris/ftp_from_exlibris/sdbdesc/tmp/src_ts_list.list 
file exists, the system uses it automatically; otherwise, enter the mount 
points for the database files at the prompt, for example: 
/exlibris,/exlibris1.
If you have a remote database, enter the mount points and available space 
for each.
3 Enter the first mount point name than press ENTER. Enter the second mount 
point name and press ENTER and so on. To quit press q.

NOTE:
Make sure that for every mount point entered there is there is a /
oradata/<ORACLE_SID> directory.

4 Select one of the following tablespaces: TS1D, TS2D, TS3D, or TS4D.
5 For each tablespace enter the size in GB. Only whole numbers are valid. For 
each tablespace, the system automatically generates an Index table one third 
the size of the tablespace (1GB minimum). 
The system prints the data and generates an SQL file with proper 
commands.

NOTE:
You can view or change the SQL under ./log file name: 
CreateAddDataFiles.sql.

November 28, 2011 27

Aleph Installation Kit

The system executes the command in the background and sends an e‐mail 
notification when completed. 

Startup Aleph Software

This step starts Apache and the Aleph 20 software.

28 November 28, 2011

Appendixes
This guide contains the following appendixes:
„ Appendix A:  Manual Database Creation on page 31
„ Appendix B:  Import Demo Libs on page 35
„ Appendix C:  Create Source Database Files List and Sizes on page 37
„ Appendix D:  Relink Other Products/Copies to New Cobol on page 39
„ Appendix E:  How to Obtain a New Aleph Installation on page 41
„ Appendix F:  Two‐Task Installation on page 43
Aleph Installation Kit

30 November 28, 2011

A
Manual Database Creation
To manually create a database:

1 Log on as an Oracle 11 user and extract the create db scripts:

cd /exlibris/ftp_from_exlibris
tar xzvf install_ora.tar.gz
cd oracle/11

2 Execute the install db script and follow the instructions:

oracle11@il-inst03(aleph20)oracle/11$csh -f
pre_db_creation.csh
Enter some parameters ...
Oracle SID: aleph20
Server short Host Name (without domain name): [il-
inst03] il-inst03
Host's Domain [corp.exlibrisgroup.com]:
corp.exlibrisgroup.com
Set environment parameter ORACLE_BASE to determine the
location of DB creation scripts and logs
Enter ORACLE_BASE path or default to [/exlibris/app/
oracle]: /exlibris/app/oracle
ORACLE_HOME is set to /exlibris/app/oracle/product/11
Is this correct?
If not, correct the environment of oracle11 before you
continue
Continue ? [y]: y

3 Enter the data files locations.

November 28, 2011 31

Aleph Installation Kit

4 Insert each disk. For each disk you insert, make sure that it has oradata 
directory with oracle:dba permissions.

Enter Disk 1 Name or Enter to end of list [/exlibris]:

/exlibris
Enter Disk 2 Name or Enter to end of list: /exlibris2
Enter Disk 3 Name or Enter to end of list:
******************************************************
******************
Enter Exlibris Product
1 - ALEPH <- default
2 - METALIB
3 - DIGITOOL
4 - VERDE
5 - ARC
6 - PRIMO
7 - DPS
8 - URM
[1]:1

5 Type 1 for Aleph DB installation.

Date tablespaces definition: Service tablespaces definition:

---------+--------+---------+---------- ---------+--------+--------+---------
-
Table- Count* Type Seg. space Table- Count* Type Seg. space
space Size management space Size management
---------+--------+---------+----------| ---------+--------+--------+--------
-- DEMO database: |
ts0 1*4000Mb System Auto | For All Sizes
ts1 1*4000Mb System Auto |---------+--------+--------+----------
temp 1*1G system Uf.(1Mb) | system 1*640Mb System Manual
undo 1*500Mb system Auto | users 1*200Mb Uf.(40K) Auto
SMALL database: | tslob 1*70Mb System Auto
ts0 1*4000Mb System Auto | sysaux 1*640M System Auto
ts1 1*4000Mb System Auto | log 1*64M System Auto
ts1d 1*1000Mb System Auto |---------+--------+--------+----------
ts2d 1*4000Mb System Auto |
ts3d 1*6000Mb System Auto |
ts4d 1*2000Mb System Auto |
ts1x 1*1000Mb System Auto |

32 November 28, 2011

 Appendix A: Manual Database Creation

ts2x 1*4000Mb System Auto |

ts3x 1*4000Mb System Auto |
temp 1*1G system Uf.(1Mb) |
undo 1*1G system Auto |
LARGE database: |
ts0 1*4000Mb System Auto |
ts1 1*4000Mb System Auto |
ts1d 1*4000Mb System Auto |ts1x 1*2000Mb System Auto
ts2d 1*4000Mb system Auto |ts2x 1*4000Mb System Auto
ts3d 1*8Gb System Auto |ts3x 1*8000Mb System Auto
ts4d 1*16Gb System Auto |ts4x 1*16Gb System Auto
temp 1*3G system Uf.(1Mb) |
undo 1*2G system Auto |
---------+--------+---------+-------------------+--------+---------+----------
Enter database size DEMO/SMALL/MEDIUM/LARGE/HUGE [DEMO]: SMALL

6 Choose the size you need according to the above. In this example a small 
size is chosen.

************************************************************************
Mirror redo log files can be created in a database where more than one DISK is
specified. Otherwise the database only uses one group of the redo logs.
Configuration parameters:
-----------------------------------------------------------------------Product
ALEPH
Oracle SID aleph20
DB Character Set UTF8
Oracle Owner oracle11
Oracle Group dba
Oracle Home /exlibris/app/oracle/product/11
Oracle Global Name aleph20.il-inst03.corp.exlibrisgroup.com
Database size SMALL
Mirroring of the redo logs is Yes
Tablespaces:
------------------------------------------------------------------------------
--SYSTEM,TEMP tbs., REDOLOG files /exlibris
INDEX tbs. /exlibris2
Mirror Redo Log files /exlibris2
UNDO tbs. /exlibris2
DATA tbs. /exlibris

November 28, 2011 33

Aleph Installation Kit

Continue ? [y]:y
Starting preparations for DB Creation ...
** If you want to change tablespace files location/size further, please
open additional terminal,
correct /exlibris/ftp_from_exlibris/oracle/11/tbs.ini file
and continue installation
Continue ? [y]: y
The Oracle network files(listener.ora and tnsnames.ora) were created correctly
******************************************************************************
**Note:
** All Database creation scripts were created in :
/exlibris/app/oracle/admin/aleph20/scripts
** You can review/change the files,
as user oracle11 on another window and then continue
or exit and submit the creation script later, by issuing :
csh -f /exlibris/app/oracle/admin/aleph20/scripts/aleph20.csh
** If you want to change tablespace files location/size , please review
/exlibris/app/oracle/admin/aleph20/scripts/CreateDB.sql
/exlibris/app/oracle/admin/aleph20/scripts/CreateDBFiles.sql
/exlibris/app/oracle/admin/aleph20/scripts/CreateDBFilesAdd.sql
/exlibris/app/oracle/admin/aleph20/scripts/CreateDBFilesMirrRedo.sql
******************************************************************************
**Enter Exit/Continue [Continue]:
******************************************************************************
**Note:
** Database creation will start now in the background,
use tail -f /exlibris/app/oracle/admin/aleph20/log/db_creation.log to view
creation progress
**After creation ends please check all log files at:
/exlibris/app/oracle/admin/aleph20/log
******************************************************************************
**To continue press Enter:
[1] 17429

To increase the performance of the Oracle database, adjust the Oracle SGA size 
for the created database. For more information, see Appendix G: Oracle SGA 
Sizing on page 45.
Now database creation is running in the background. After database installation 
completes successfully, continue with Appendix B: Import Demo Libs on 
page 35.

34 November 28, 2011

B
Import Demo Libs
NOTES:
„ VIR01 is normally a DEMO library. If the DEMO libraries import is  
done on a server where customer data has already been loaded and is 
in use, shut down Aleph (or at least the pc_server and www_servers)  
while the importing is running in order to avoid conflicts in the use of 
the vir01 tables. 
„ If your usr_library or pw_library in aleph_start is set to USR00, this 
process deletes your patron and password data. (It is our strong 
recommendation that the USR00 not be used as your usr_library or 
pw_library).

Perform the following steps after the Aleph software is installed and configured:
1 Download the aleph20 dump file from the FTP:

cd /exlibris/ftp_from_exlibris wget "ftp://

ver20:[email protected]/dpdump/*" cat
aleph20_demo.dmp.gz_* | gzip -dc > aleph20_demo.dmp
aleph20_demo.dmp

2 Create the dumpdir directory and run the import: 

sqlplus ALEPH_DBA/ALEPH_DBA as sysdba CREATE or replace

DIRECTORY dumpdir AS '/exlibris/ ftp_from_exlibris'; GRANT
READ,WRITE ON DIRECTORY dumpdir TO ALEPH_ADMIN; exit set
DLIBS=`echo $DEMO_LIBS | sed 's/ /,/g'` set DD=`date +%y%m%d`
impdp $ALEPH_ADMIN schemas=$DLIBS DIRECTORY=dumpdir
DUMPFILE=aleph20_demo_libs.dmp LOGFILE=aleph20_libs.$DD.log
>& /dev/null &

November 28, 2011 35

Aleph Installation Kit

36 November 28, 2011

C
Create Source Database Files List and
Sizes
To create a list of files and sizes, use sdbdesc.sh or to Util O 14 8 in the 
source Aleph copy. 
Create a file to describe the database files and sizes.

To create he file:

1 Log on to the Source DB server as aleph user:

cd /exlibris/ftp_from_exlibris

NOTE:
Make sure that the aleph user has write permissions.

2 Download the DB description util:

wget -c "ftp://ver20:[email protected]/
scripts/sdbdesc.sh"

3 Execute the util:

sh sdbdesc.sh

When the util is successfully completed, a file is created under /exlibris/
ftp_from_exlibris/sdbdesc/tmp/src_ts_list.list
This output file describe the source dabase files and the sizes that are required 
when adding files to the new Aleph 20 database. 
If the source server and target server are different, copy the file to a specific 
folder on the target server (the location of the aik directory):

November 28, 2011 37

Aleph Installation Kit

To copy the file to a specific folder:

1 Create a folder on the target server:

mkdir -p sdbdesc/tmp

2 Create the src_ts_list.list file however you want. (for example, scp,
cut&paste). The DB files creation step requires this file.

38 November 28, 2011

D
Relink Other Products/Copies to New
Cobol
If there are other copies or applications installed on the server that use 
cobol_4.0.0, re‐link the Cobol to the new Cobol software that comes with the kit.
For example, when Aleph 20 is installed in parallel with Aleph 19.01, do the 
following:
1 Log on to Aleph 19.01.
2 Go to the local product:

cd $aleph_product/local
rm cobol
ln -s /exlibris/product/cobol5 cobol

November 28, 2011 39

Aleph Installation Kit

40 November 28, 2011

E
How to Obtain a New Aleph Installation
To obtain a new Aleph installation, log on to Pivotal and open a support 
incident.
Figure 10:

Figure 11: How to Obtain a New Aleph Installation

November 28, 2011 41

Aleph Installation Kit

Fill in the form according to the following table:
Table 3. How to Obtain a New Aleph Installation

Field Response
What product do you  Enter your current Aleph version.
need help with?

How would you rate the  Leave the default Normal.
priority of this incident?

What kind of difficult are  Upgrade
you experiencing?

Category Upgrade

Subject Enter one of the following:
„ AIK
„ By contract
„ Paid service

Incident Title Enter one of the following:
„ We would like to use Aleph Installation Kit.
„ We would like to schedule Aleph Installation 
according to our contract.
„ We would like to order Aleph Installation from Ex 
Libris as a professional service.

Problems Details „ Indicate if the required license is for Test server or 
Production server.
„ Enter the IP of the server where you are going to 
install Aleph 20.

If you have chosen as the subject Ex Libris installation according to contract or 
We request that Ex Libris install Aleph as a paid service, add to the SI the 
following documents, as appropriate: 
„ Request for Aleph Installation Form
„ 03_Aleph ARC Sizing Request Form 
„ 04_Automated_Server_Sizing_Check_For_Upgrade_Compatibility

42 November 28, 2011

F
Two-Task Installation
To configure two‐task installation mode:
1 On the DB server, install the Oracle Client and the Aleph database. For 
information on how to do this, see Step 3: Oracle Database Installation and 
Configuration on page 19.
2 On the application server, run a full installation, but skip the install database 
and startup Oracle listener steps.
3 Insert the Oracle host name (database server name) in Step 5: Aleph 
Software Installation and Configuration. For more infomration, see  Step 5: 
Aleph Software Installation and Configuration on page 24.

November 28, 2011 43

Aleph Installation Kit

44 November 28, 2011

G
Oracle SGA Sizing

Introduction
By default, the database is created with an SGA size of 700MB (the memory in 
Oracle Shared Global Area for this database). To increase Oracle performance, 
increase this value. 
According to Oracle directives, the cumulative amount of SGA sizes for all 
running databases on the server should be less than server RAM / 3. So, 
according to SGA sizes defined for all the present databases, as well as the 
server RAM, you can increase the DB SGA.

Checking the SGA Size

To check the SGA size:

1 Log on as the oracle user.
2 Enter the following commands to check the SGA size for database 
<DB_NAME>. In the following example, the SGA size for the connected 
database is 700 MB:

idle> show parameter memory

**** Hit return to continue ****
NAME TYPE VALUE
-------------------------- ------------- --------------------
memory_max_target big integer 700M
memory_target big integer 700M

November 28, 2011 45

Aleph Installation Kit

Increasing the SGA Size

CAUTION:
Oracle SGA resizing should be performed by an Oracle expert only. When 
performing an upgrade, we recommend referencing the parameters of the 
DB used in a previous version (the version to be upgraded).

1 To increase SGA size to 2000 MB (for example) for database <DB_NAME> for 
Oracle 11, type the following, as the oracle user:

> setenv ORACLE_SID <DB_NAME>

> sqlplus /nolog idle> connect /as sysdba
idle> alter system set MEMORY_MAX_TARGET=2000M SCOPE=spfile;
idle> alter system set MEMORY _TARGET=2000M SCOPE=spfile;

2 Restart the database by entering the following commands:

idle> shutdown immediate

idle> startup

Solving an SGA Parameter Error

On Solaris 10, since a classic system parameter change in the /etc/system file 
has no effect, you may encounter problems when increasing the SGA size after a 
DB restart: 

ORA-27102: out of memory

SVR4 Error: 22: Invalid argument

In this case, change the relevant OS memory parameter as the root user and run 
the following:

# projmod -s -K "project.max-shm-memory=(privileged,
10GB,deny)" group.dba

If a problem occurs while setting this SGA parameter, define the appropriate 
Solaris project for Oracle by running the following commands as the root user:

# projadd group.dba
# projmod -s -K "project.max-shm-memory=(privileged,
10GB,deny)" group.dba

When this has been completed, restart the database.

46 November 28, 2011