Installation of NewGenLib on Linux

Please note the below points before going ahead with the installation of NewGenLib on Linux

System requirements

Min requirements of the Server

Hardware: Pentium 4 or equivalent, 1GB RAM and 40GB Hard disk

Software: Linux

Min requirements of the Client

Hardware: Pentium 3 or equivalent, 128MB RAM, and 1 GB of min hard disk

Software: Windows 98/ME/2000prof/2000adv server/XP home/XP Prof/2003/Red hat Linux 8.0/9.0/10/Enterprise edition, Fedora, Suse, Debian

NewGenLib Server Installation

  1. Open the terminal

  2. Login as postgres by using this command without the quotes “su – postgres”

  3. Create a database named newgenlib using this command without the quotes “createdb newgenlib”

  4. Create a user named newgenlib using this command without the quotes “createuser -P newgenlib”. The system will prompt you to enter the password, enter the password. The system will prompt you with a series of questions. Enter 'yes' for all the questions. Advanced Postgresql database administrators may make sure that 'newgenlib' user has all the right to 'newgenlib' database only

  5. Connect to 'newgenlib' database using this command without the quotes “psql newgenlib”. While connected make sure

  6. Install dbsize from contrib modules using this command without the quotes “\i /usr/share/pgsql/contrib/dbsize.sql” (please check the location of your dbsize.sql and execute the command accordingly). Also this step needs to be executed if you are using Postgresql 8.0 and not 8.1

  7. Install tsearch2 from contrib modules using this command without the quotes “\i /usr/share/pgsql/contrib/tsearch2.sql” (please check the location of your tsearch2.sql and execute the command accordingly).

  8. Install tables, functions, indexes and all other configuration required by NewGenLib. For this should have already downloaded backupinplain.sql from NewGenLib related downloads from sourceforge.net. Execute this command without the quotes “\i /usr/ backupinplain.sql”. Please note that you must be connected to newgenlib as you were connected from steps 5 through 8. If you are already connected then just execute the command. This step will create all the NewGenLib related database tables.

  9. Download the jboss-3.2.1_tomcat-4.1.24.zip from NewGenLib related downloads from sourceforge.net. Extract the contents of this zip file into /usr directory. You must now see a directory named jboss-3.2.1_tomcat-4.1.24 in the /usr directory.

  10. Download the NewGenLibFilesLinux.zip from NewGenLib related downloads from sourceforge.net. Extract the contents of this zip file into /usr directory.

  11. Edit postgresql.conf file in /var/lib/pgsql/data directory. Uncomment the line listen='localhost' and port='5432' and restart postgres service.

  12. In the jboss-3.2.1_tomcat-4.1.24/server/default/deploy directory you will find a file named 'postgres-ds.xml' file. Edit the file using you favorite editor. Make changes of the user name and password in this file in accordance with user name and password created in step 4.

  13. Download newgenlib.ear from NewGenLib downloadable files in sourceforge.net website. Copy the downloaded file into jboss-3.2.1_tomcat-4.1.24/server/default/deploy directory.

How to run the server?

  1. First set the environment variable JAVA_HOME to do this execute this command without double quotes "export JAVA_HOME=/usr/java/j2sdk1.4.2_12". Here it is assumed that java SDK is installed in /usr/java directory and update 12 is used. Please export JAVA_HOME parameter accordingly.
  2. Now your server is all set to run. Execute this command without double quotes "/usr/jboss-3.2.1_tomcat-4.1.24/bin/./run.sh". This will start your JBoss Server and the NewGenLib application successfully deployed into it.

Client installation (Librarian's interface)

Web based Online Public Access Catalogue (Web OPAC)