Call: Practical Installation Process of NewGenLib OSS on Windows XP for Library automation Goutam Biswas Department of Library & Information Science University of Kalyani, Nadia, West Bengal INDIA Mobile No

Call: NOTE The following slides demonstrate the installation of NewGenLib software on a local machine. This presentation is limited to installation only. For further assistance, please refer to NewGenLib User Manual (UserManualAllModules.pdf)UserManualAllModules.pdf available at ib ib

Call: Thanks To Dr. L J Haravu Kesavan Institute of Information and Knowledge Management, Hyderabad Verus Solutions Pvt. Ltd., Hyderabad Everyone else involved in the development of NewGenLib and making it open source

Call: What is NewGenLib? “ NewGenLib is a metadata content management software solution ” An integrated library management software A web-based application that uses RDBMS technology to manage databases Compliant with International Standards: MARC, XML, UNICODE & Dublincore Installable on LAN/Intranet and Standalone computers Uses many open source components NewGenLib is now Open Source !!! Free download at Take a 20-minute multimedia tour at Let ’ s Install & Use it

Call: Files Required for Installation J2SE Software Development Kit (SDK) PostgreSQL for Windows JBoss Application Server newgenlib.ear NewGenLibFiles.zip backupinplain.sql Java Runtime Environment (JRE) (for installation on clients)

Call: Sources of Download Download files 1 to 4 from JBoss Application Server 2. newgenlib.ear 3. NewGenLibFiles 4. backupinplain.sql 5. J2SE Software Development Kit (SDK) PostgreSQL for Windows Java Runtime Environment (JRE)

Call: Installation Summary 1. Install Java 2 SDK 2. Set environment variable for Java 2 SDK 3. Install PostgreSQL for Windows 4. Create newgenlib database 5. Run backupinplain.sql script to create tables 6. Install JBoss Application Server 7. Copy newgenlib.ear file to JBoss Server 8. Extract NewGenLibFiles.zip to C drive 9. Edit Env_Var file & fill in the System Parameters 10. Create a shortcut for JBoss run.bat file on the Desktop 11. Start the JBoss Application Server 12. Access NewGenLib through the Web Browser

Call: Files Required for Installation

Call: Install Java 2 SDK Double Click j2sdk file to launch the installer

Call: Accept the license agreement 1. Click “ I accept the terms in the license agreement ” 2. Click Next > button

Call: Choose installation directory 1. By default, SDK is installed under C:\j2sdkx.x.x folder (where x.x.x represent the version). But for simplicity, the folder name may be changed. Here, it is changed to jdk 2. Click Next > button

Call: Choose installation directory 1. Click Change … button and change the folder name to jdk 2. Click OK button

Call: Choose installation directory 1. Click Next > button

Call: Web Browser Configuration 1. Java 2 SDK automatically identifies the browsers installed. Select the browsers to be configured with Java. 2. Click Install > button

Call: Installation in Progress

Call: Installation Complete 1. Click Finish button

Call: Set Environment Variable for Java 2 SDK 1. Right Click My Computer icon on your Desktop and click Properties

Call: Set Environment Variable for Java 2 SDK 1. In System Properties screen, select Advanced tab & click Environment Variables button

Call: Set Environment Variable for Java 2 SDK 1. In Environment Variables window, Click New button under System Variables

Call: Set Environment Variable for Java 2 SDK 1. In New System Variable window, type JAVA_HOME for Variable name & Java 2 SDK installation path (C:\jdk in this example) for Variable value 2. Click OK

Call: Environment Variable for Java 2 SDK set 1. The Environment Variable for Java 2 SDK can be seen

Call: Install PostgreSQL for Windows 1. Double click the postgresql installer package to launch installation wizard 2. Select the language & click Start > button

Call: Welcome Screen 1. Click Next > button

Call: Installation Notes 1. Click Next > button

Call: Installation Options 1. Leave all the options default (including the installation directory) 2. Click Next > button

Call: Service Configuration 1. Account name: postgres 2. Account domain: accept default value 3. Account password: newgenlib (retype the password) 4. Click Next > button NOTE: DO REMEMBER THIS PASSWORD

Call: Account Creation & Password Warning 1. If Account error window appears, click Yes to create postgres Account 2. If “ Password weak ” warning appears, click No to retain your password (If you click Yes, the installer replaces your password with a random password)

Call: Initialize Database Cluster 1. Type postgres for Superuser name (it may be present already) 2. Type newgenlib for Password and retype the same. 3. Leave the other options unchanged. 4. Click Next > button. NOTE: DO REMEMBER THIS PASSWORD

Call: Select Procedural Language 1. The procedural language PL/pgsql will be selected by default 2. Click Next > button

Call: Select contrib modules (IMPORTANT!) 1. Select DBlink, Fuzzy String Match & Tsearch2 Modules. Admin81 is selected by default. 2. Click Next > button

Call: Ready to Install 1. Click Next > button to start installation

Call: Installation in Progress

Call: Installation Complete 1. Click Finish > button

Call: Create newgenlib database 1. Go to Start > Programs > PostgreSQL > PgAdmin III

Call: Connect to PostgreSQL Database Server 1. Right Click on PostgreSQL Database Server & click Connect

Call: Enter Password to connect to server 1. Enter the password for user postgres (password is newgenlib) 2. Click OK button

Call: Create New Database 1. Right click on Databases & click New Database

Call: Create newgenlib database 1. In New Database Window, enter newgenlib for Name, select posgres for Owner, UTF8 for Encoding & pg_default for Tablespace 2. Click OK button

Call: newgenlib database created 1. newgenlib database can be seen in Database list 2. Close pgAdmin III

Call: Copy backupinplain.sql file to C drive 1. Copy backupinplain.sql file to C drive

Call: Go to Command Prompt 1. To go to command prompt, click Start > Run & type cmd

Call: Change directory to PostgreSQL\bin 1. At the command prompt, type cd C:\Program Files\PostgreSQL\x.x\bin (where x.x is the version directory. In this example, it is 8.1) 2. Press Enter

Call: Access newgenlib database for user postgres 1. type psql -d newgenlib – U postgres 2. Press Enter 3. Type postgres account password (password is newgenlib) (NOTE: While typing the password, no characters appear on screen. The cursor will not move) 4. Press Enter

Call: Run backupinplain.sql script 1. On successful access, the prompt changes to database name 2. Type \i c:/backupinplain.sql & Press Enter (Note the use of forward slash after C:)

Call: Table creation in progress

Call: Table creation complete 1. The table creation is complete 2. Close the command prompt

Call: Install JBoss Application Server 1. Extract jboss-3.2.1_tomcat zip file to C drive directly

Call: Select location for extraction 1. Select C drive as location for extraction 2. Click Extract button

Call: Extraction Complete 1. When extraction completes, the jboss folder can be seen in C drive

Call: Copy newgenlib.ear file to JBoss Server 1. Copy newgenlib.ear file to C:\jboss- xxx\server\default\deploy directory

Call: Extract NewGenLibFiles.zip file to C drive 1. Extract NewGenLibFiles.zip file to C drive directly

Call: Extract NewGenLibFiles.zip file to C drive 1. Select C drive as the location for extracting NewGenLibFiles.zip file

Call: Extraction Complete 1. When extraction completes, the NewGenLibFiles directory can be seen in C drive

Call: Edit Env_Var file to fill System Parameters 1. Go to C:\NewGenLibFiles\SystemFiles directory & open Env_Var file using any text editor.

Call: Edit Env_Var file to fill System Parameters 1. Change JBOSS_HOME from D drive to C drive (as JBoss is installed in C drive in this example). Enter the IPADDRESS of the server machine (localhost or for local installation), Port on which this server should be accessed and DEFAULT_SEARCH option. 2. Save the file & Close.

Call: Create Shortcut for JBoss run.bat file on Desktop 1. Go to C:\jboss-xx\bin folder. Right click, hold the right mouse button on run.bat file and drag it on to the Desktop. Select Create Shortcuts Here from the context menu.

Call: Rename the Shortcut to “ NewGenLib Server ” 1. For easy understanding & usage, rename the shortcut to NewGenLib Server.

Call: Start the JBoss Application Server 1. Double Click NewGenLib Server on the Desktop to start JBoss Application Server Server Starting Server Started

Call: Open Web Browser & type URL to start NewGenLib 1. Open Internet Explorer & type

Call: Unblock in Windows Security Alert 1. If Windows Firewall gives Security Alert, click Unblock button

Call: Java Starting …

Call: Starting NewGenLib Application

Call: Verifying Digital Signature 1. Click Run button to run the application. You may check Always trust content from this publisher to avoid this screen from repeat.

Call: Enter Server Details 1. Enter the IP address of the server & port number 2. Click OK

Call: The Login Screen 1. (select the library) Enter the user id and password to login 2. Click Login NOTE: Default user id: 1 Default Password: abc

Call: The Login Screen 1. Default User id is 1 & Default Password is abc 2. Click Login NOTE: Default user id: 1 Default Password: abc

Call: Welcome Screen with Pending Job List

Call: NewGenLib Menu The preliminary configuration can be done under Administration > Configure system

Call: General Configuration of Library Details The library details can be configured at Administration > Configure system > General > Library

Call: General Configuration of Library Details Click OK to update. An appropriate dialog is displayed.

Call: OPAC Interface Open Internet Explorer, type to access OPAC.

Call: OPAC Interface

Call: NewGenLib User Manual for assistance on installation available at

Call: Thanks Please send in your comments & suggestions to Website: goutambiswasresearch.yolasite.com