Date post: | 09-Dec-2014 |
Category: |
Technology |
Upload: | shiba-bhue |
View: | 2,429 times |
Download: | 3 times |
Installation of NewGenLib on Windows XP
Rupesh Kumar A
Research Scholar
Department of Library & Information Science
Bangalore University, Bangalore 560056
INDIA
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
1. JBoss Application Server2. newgenlib.ear3. NewGenLibFiles4. backupinplain.sql5. J2SE Software Development Kit (SDK)
http://java.sun.com/j2se/1.4.2/download.html6. PostgreSQL for Windows 7. http://www.postgresql.org8. Java Runtime Environment (JRE)
http://java.sun.com/j2se/1.4.2/download.html
Installation Summary
1. Install Java 2 SDK2. Set environment variable for Java 2 SDK3. Install PostgreSQL for Windows4. Create newgenlib database5. Run backupinplain.sql script to create tables6. Install JBoss Application Server7. Copy newgenlib.ear file to JBoss Server8. Extract NewGenLibFiles.zip to C drive9. Edit Env_Var file & fill in the System Parameters10. Create a shortcut for JBoss run.bat file on the Desktop11. Start the JBoss Application Server12. 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 agreement1. Click “I accept the terms in the license agreement” 2. Click Next > button
Choose installation directory1. 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 jdk2. Click Next > button
Choose installation directory1. Click Change… button and change the folder name to jdk2. Click OK button
Choose installation directory1. Click Next > button
Web Browser Configuration1. Java 2 SDK automatically identifies the browsers installed. Select the browsers to be configured with
Java.2. Click Install > button
Installation in Progress
Installation Complete1. Click Finish button
Set Environment Variable for Java 2 SDK1. Right Click My Computer icon on your Desktop and click
Properties
Set Environment Variable for Java 2 SDK1. In System Properties screen, select Advanced tab & click
Environment Variables button
Set Environment Variable for Java 2 SDK1. In Environment Variables window, Click New button under
System Variables
Set Environment Variable for Java 2 SDK1. In New System Variable window, type JAVA_HOME for Variable name & Java 2 SDK installation path (C:\
jdk in this example) for Variable value2. Click OK
Environment Variable for Java 2 SDK set1. The Environment Variable for Java 2 SDK can be seen
Install PostgreSQL for Windows
1. Double click the postgresql installer package to launch installation wizard2. Select the language & click Start > button
Welcome Screen
1. Click Next > button
Installation Notes
1. Click Next > button
Installation Options
1. Leave all the options default (including the installation directory)2. Click Next > button
Service Configuration
1. Account name: postgres2. Account domain: localhost (in case of local installation)3. Account password: newgenlib (retype the password)4. Click Next > button
NOTE: DO REMEMBER THIS PASSWORD
Account Creation & Password Warning1. If Account error window appears, click Yes to create postgres Account2. 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 Cluster1. 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
Select Procedural Language
1. The procedural language PL/pgsql will be selected by default2. Click Next > button
Select contrib modules (IMPORTANT!)1. Select DBlink, Fuzzy String Match & Tsearch2 Modules. Admin81 is selected by default.2. Click Next > button
Ready to Install
1. Click Next > button to start installation
Installation in Progress
Installation Complete
1. Click Finish > button
Create newgenlib database
1. Go to Start > Programs > PostgreSQL > PgAdmin III
Connect to PostgreSQL Database Server1. Right Click on PostgreSQL Database Server & click Connect
Enter Password to connect to server
1. Enter the password for user postgres (password is newgenlib)2. Click OK button
Create New Database
1. Right click on Databases & click New Database
Create newgenlib database1. In New Database Window, enter newgenlib for Name, select posgres for Owner, UTF8 for Encoding &
pg_default for Tablespace2. Click OK button
newgenlib database created1. newgenlib database can be seen in Database list2. Close pgAdmin III
Copy backupinplain.sql file to C drive
1. Copy backupinplain.sql file to C drive
Go to Command Prompt
1. To go to command prompt, click Start > Run & type cmd
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
Access newgenlib database for user postgres1. type psql -d newgenlib –U postgres2. 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
Run backupinplain.sql script1. On successful access, the prompt changes to database name2. Type \i c:/backupinplain.sql & Press Enter (Note the use of forward slash after C:)
Table creation in progress
Table creation complete
1. The table creation is complete2. Close the command prompt
Install JBoss Application Server1. Extract jboss-3.2.1_tomcat-4.1.24.zip file to C drive directly
Select location for extraction
1. Select C drive as location for extraction2. Click Extract button
Extraction Complete
1. When extraction completes, the jboss folder can be seen in C drive
Copy newgenlib.ear file to JBoss Server
1. Copy newgenlib.ear file to C:\jboss-xxx\server\default\deploy directory
Extract NewGenLibFiles.zip file to C drive
1. Extract NewGenLibFiles.zip file to C drive directly
Extract NewGenLibFiles.zip file to C drive
1. Select C drive as the location for extracting NewGenLibFiles.zip file
Extraction Complete
1. When extraction completes, the NewGenLibFiles directory can be seen in C drive
Edit Env_Var file to fill System Parameters
1. Go to C:\NewGenLibFiles\SystemFiles directory & open Env_Var file using any text editor.
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 127.0.0.1 for local installation), Port on which this server should be accessed and DEFAULT_SEARCH option.
2. Save the file & Close.
Create Shortcut for JBoss run.bat file on Desktop1. 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.
Rename the Shortcut to “NewGenLib Server”1. For easy understanding & usage, rename the shortcut to
NewGenLib Server.
Start the JBoss Application Server
1. Double Click NewGenLib Server on the Desktop to start JBoss Application Server
Server Starting Server Started
Open Web Browser & type URL to start NewGenLib1. Open Internet Explorer & type
http://localhost:8080/newgenlibctxt/LaunchApplication
Unblock in Windows Security Alert
1. If Windows Firewall gives Security Alert, click Unblock button
Java Starting…
Starting NewGenLib Application
Verifying Digital Signature
1. Click Run button to run the application. You may check Always trust content from this publisher to avoid this screen subsequently.
Enter Server Details
1. Enter the IP address of the server & port number2. Click OK
The Login Screen
1. (select the library) Enter the user id and password to login2. Click Login
NOTE: Default user id: 1 Default Password: abc
The Login Screen
1. Default User id is 1 & Default Password is abc2. Click Login
NOTE: Default user id: 1 Default Password: abc
Welcome Screen with Pending Job List
NewGenLib Menu
The preliminary configuration can be done under Administration > Configure system
General Configuration of Library Details
The library details can be configured at Administration > Configure system > General > Library
General Configuration of Library Details
Click OK to update. An appropriate dialog is displayed.
OPAC InterfaceOpen Internet Explorer, type http://localhost:8080/newgenlibctxt to access OPAC.
OPAC Interface
Please refer to NewGenLib User Manual for assistance on installation & usage.
Manual available at http://www.sourceforge.net/projects/newgenlib