Install NewGenLib on Windows XP

Installation of NewGenLib on Windows XP Rupesh Kumar A Research Scholar Department of Library & Information Science Bangalore University, Bangalore 560056 INDIA [email_address] [email_address]

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 )

available at

http://www.sourceforge.net/projects/newgenlib

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

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 http://www.sourceforge.net/projects/newgenlib

Take a 20-minute multimedia tour at www.newgenlib.com

Let’s Install & Use it

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)

Sources of Download

Download files 1 to 4 from http://www.sourceforge.net/projects/newgenlib

JBoss Application Server

newgenlib.ear

NewGenLibFiles

backupinplain.sql

J2SE Software Development Kit (SDK) http://java.sun.com/j2se/1.4.2/download.html

PostgreSQL for Windows

http://www.postgresql.org

Java Runtime Environment (JRE) http://java.sun.com/j2se/1.4.2/download.html

Installation Summary

Install Java 2 SDK

Set environment variable for Java 2 SDK

Install PostgreSQL for Windows

Create newgenlib database

Run backupinplain.sql script to create tables

Install JBoss Application Server

Copy newgenlib.ear file to JBoss Server

Extract NewGenLibFiles.zip to C drive

Edit Env_Var file & fill in the System Parameters

Create a shortcut for JBoss run.bat file on the Desktop

Start the JBoss Application Server

Access NewGenLib through the Web Browser

Files Required for Installation

Install Java 2 SDK

Double Click j2sdk file to launch the installer

Accept the license agreement

Click “I accept the terms in the license agreement”

Click Next > button

Choose installation directory

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

Click Next > button

Click Change… button and change the folder name to jdk

Click OK button

Click Next > button

Web Browser Configuration

Java 2 SDK automatically identifies the browsers installed. Select the browsers to be configured with Java.

Click Install > button

Installation in Progress

Installation Complete

Click Finish button

Set Environment Variable for Java 2 SDK

Right Click My Computer icon on your Desktop and click Properties

In System Properties screen, select Advanced tab & click Environment Variables button

In Environment Variables window, Click New button under System Variables

In New System Variable window, type JAVA_HOME for Variable name & Java 2 SDK installation path ( C:jdk in this example) for Variable value

Click OK

Environment Variable for Java 2 SDK set

The Environment Variable for Java 2 SDK can be seen

Install PostgreSQL for Windows

Double click the postgresql installer package to launch installation wizard

Select the language & click Start > button

Welcome Screen

Click Next > button

Installation Notes

Click Next > button

Installation Options

Leave all the options default (including the installation directory)

Click Next > button

Service Configuration

Account name: postgres

Account domain: accept default value

Account password: newgenlib (retype the password)

Click Next > button

NOTE: DO REMEMBER THIS PASSWORD

Account Creation & Password Warning

If Account error window appears, click Yes to create postgres Account

If “Password weak” warning appears, click No to retain your password (If you click Yes , the installer replaces your password with a random password)

Initialize Database Cluster

Type postgres for Superuser name (it may be present already)

Type newgenlib for Password and retype the same.

Leave the other options unchanged.

Click Next > button.

NOTE: DO REMEMBER THIS PASSWORD

Select Procedural Language

The procedural language PL/pgsql will be selected by default

Click Next > button

Select contrib modules (IMPORTANT!)

Select DBlink , Fuzzy String Match & Tsearch2 Modules. Admin81 is selected by default.

Click Next > button

Ready to Install

Click Next > button to start installation

Installation in Progress

Installation Complete

Click Finish > button

Go to Start > Programs > PostgreSQL > PgAdmin III

Connect to PostgreSQL Database Server

Right Click on PostgreSQL Database Server & click Connect

Enter Password to connect to server

Enter the password for user postgres (password is newgenlib )

Click OK button

Create New Database

Right click on Databases & click New Database

In New Database Window, enter newgenlib for Name, select posgres for Owner, UTF8 for Encoding & pg_default for Tablespace

Click OK button

newgenlib database created

newgenlib database can be seen in Database list

Close pgAdmin III

Copy backupinplain.sql file to C drive

Copy backupinplain.sql file to C drive

Go to Command Prompt

To go to command prompt, click Start > Run & type cmd

Change directory to PostgreSQLin

At the command prompt, type cd C:Program FilesPostgreSQLx.xin (where x.x is the version directory. In this example, it is 8.1)

Press Enter

Access newgenlib database for user postgres

type psql -d newgenlib –U postgres

Press Enter

Type postgres account password (password is newgenlib)

(NOTE: While typing the password, no characters appear on screen. The cursor will not move)

Press Enter

Run backupinplain.sql script

On successful access, the prompt changes to database name

Type i c:/backupinplain.sql & Press Enter (Note the use of forward slash after C:)

Table creation in progress

Table creation complete

The table creation is complete

Close the command prompt

Install JBoss Application Server

Extract jboss-3.2.1_tomcat-4.1.24.zip file to C drive directly

Select location for extraction

Select C drive as location for extraction

Click Extract button

Extraction Complete

When extraction completes, the jboss folder can be seen in C drive

Copy newgenlib.ear file to JBoss Server

Copy newgenlib.ear file to C:jboss-xxxserverdefaultdeploy directory

Extract NewGenLibFiles.zip file to C drive

Extract NewGenLibFiles.zip file to C drive directly

Extract NewGenLibFiles.zip file to C drive

Select C drive as the location for extracting NewGenLibFiles.zip file

Extraction Complete

When extraction completes, the NewGenLibFiles directory can be seen in C drive

Edit Env_Var file to fill System Parameters

Go to C:NewGenLibFilesSystemFiles directory & open Env_Var file using any text editor.

Edit Env_Var file to fill System Parameters

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 127.0.0.1 for local installation), Port on which this server should be accessed and DEFAULT_SEARCH option.

Save the file & Close.

Create Shortcut for JBoss run.bat file on Desktop

Go to C:jboss-xxin 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.

Rename the Shortcut to “NewGenLib Server”