Upgrade to NGL 3.0.4 R1 U2 from NGL older versions on Windows

This tutorial presumes that you have an older version of NGL running on your server. Older version means 2.x, 3.0, 3.0.1, 3.0.2, 3.0.3,  3.0.3U1,.....3.0.4 R1 If you are upgrading from 3.0.3 U2 or above, then please follow the instructions available at this link We will now see the upgrade procedure.

Upgrading the server

Installation of Java SDK 6.0 and setting up of JAVA_HOME environment variable

1. Download Java SDK 1.6.0 from this link. Click here to download jdk1.6.0. This page also contains Java SE 7. But you need to download Java SE 6 JDK. 2. Once you have downloaded jdk1.6.0. You will see a file like below. Double click on it to start the installation 3. Click on the "Next" button 4. Make a note of this path to Install Java and Click on Next. 5. The Install of jre will be prompted just Click on Next 6. Click on Finish 7. Let us now set the JAVA_HOME Environment variable. Right click on "My Computer" on your desktop and select the option "Properties" 8. Select the tab Advanced and click on the button Environment Variables 9. Under the System Variables area click on the New button 10. You will be prompted to create a new system variable. In the variable name enter JAVA_HOME and in the variable value enter the path of the jdk Installation(See Point 4). And click on the Ok button. You can now see the JAVA_HOME Variable set as shown below. Now click on the Ok button.


Installation of NGL3

1. Download NGL3 from this link. If you have already downloaded this file in the Download page, skip this step. 2. This will download a file InstallNGL303.zip. Extract this file, for this example we have extracted the zip file into C: Drive. In C: Drive you will now see a directory name "InstallNGL303". The contents of this directory. You may extract the zip file into any directory. 3. Now go into C:/InstallNGL303/apache-ant-1.8.1/bin directory. In this directory you will find a file config.ini. open this file using Wordpad or Notepad. Edit the parameters as explained below. installation.directory=C:/NGL3 This means that the NGL installation will be made in the directory C:/NGL3 you may give choose any other directory as you wish. But for this example we will choose this directory. ServerIPAddress=localhost The IPAddress of the computer which is running Postgresql database. By default leave it as localhost. It means that Postgresql database server is running on this system itself. DatabasePort=5432 The Port on which your Postgresql Server is running. In most of the cases this port number is 5432. DefaultDatabase=postgres DatabaseUserName=postgres DatabasePassword=newgenlib Leave this parameters as it is. Do not make any changes here. source.location=D:/InstallNGL3.0 This is the location which has NGL3.0 Installation files. Refer to Point 2. restore.database=original Leave this parameter as it is. NewGenLib.Database=newgenlib Since the earlier version of NGL is already running it means that you have a postgresql database running on the server. Enter the name of the database that is holding NewGenLib Schema and data. NewGenLib.Database.UserName=postgres The name of the database user. NewGenLib.Database.Password=newgenlib The name of the database password. Save the changes made to config.ini 4. Go to C:/InstallNGL303 and Double click on Upgrade batch file. This will Open command prompt and execute the scripts as shown below 5. Go to C:/NGL3/apache-tomcat-6.0.32/bin directory. You can see a file RunNGL3Server batch file. This batch file when executed will run the apache-tomcat Server with NGL Application. Since you have use this batch file frequently let us create a shortcut of this file on the desktop. Right click on RunNGL3Server and Send to ---> Desktop (Create Shortcut) as shown below. A shortcut will be created on your desktop as shown below 6. Double click on the Shortcut to start NGL Server. The NGL Server (apache-tomcat) will start. It will take some time to initialize. Finally you will get a message as shown below. The time taken for server to initialize will change system to system.


Check if the installation is working

1. Make sure that your NGLServer is running. (Point 6 of above section). 2. Click on this link. http://localhost:8080/newgenlibctxt. This should open Web OPAC as shown below. 3. Now the Installation is running, we will now have to create a Solr Index of Bibliographic and Authority data. Please note that unless you execute this step you will not be able to make searches. Go D:/InstallNGL3.0 directory you will find a file BuildIndex batch file. Double click on this file. This will create Bibliographic and Authority data Index.


Launching NGL Librarian's Interface

1. Click on this link http://localhost:8080/newgenlibctxt/LaunchApplication This will Launch Librarian's User Interface 2. You will first be prompted to enter Tomcat server location and Port on which it runs. Enter localhost as "IP Address of the server" and 8080 as "Port Number". Click on Ok 3. Now a login screen will open. Login with User ID="1" and Password="abc" (In your earlier version if you have used a different password, login with that password) 4. Librarian's User Interface will open as shown below. 5. For tutorials to use the librarian interface please visit our Knowledge bank