1. Pre-requisite Installations Required on Server
2. File Structure
3. Database Files
4. How to take backup
5. How to restore database
6. How to download latest updates
7. How to shutdown NewGenLib server
8. How to start NewGenLib Server
9. How to configure mail service
10. Ports used by NewGenLib
11. How to report errors in NewgenLib
There are 3 important file locations to be taken care in NewGenLib are
o JBoss deploy directory location. JBOSS_HOME= {Drive letter}:/jboss-3.2.1_tomcat-4.1.24/server/default/deploy
o IP Address of the server. IPADDRESS=10.20.20.82
o Port number where the JBoss-Tomcat web server is running. Default is 8080. PORT=8080
For windows environment
Click on Start -> Programs -> PostgreSQL 8.0 -> pgAdmin III. This will open pgAdmin III screen.
On the left hand side of the screen you will find a tree structure, in which you will find server Servers, under servers you'll find PostgresSQL Database server server 8.0, with a right cross mark. Double click on that.
The system will prompt for the password. Please enter password there.
Once the password is validated successfully, you'll find Databases, and under databases you'll find a database named newgenlib. If you are unable to find the database named newgenlib, please contact us.
Now select the database newgenlib, right click and click on refresh. Now again right click and click on Backup.
Now the system will ask for backup file name, enter the backup file name or use can use the three dotted button beside the file name to use the file dialog to assist you in creating the file name at the desired location.
Now click on Ok button.
This operation will take some time. Time taken depends on the size of the database. Once the backup has been taken, please click on Done button.
Now you may verify whether the backup file has been created at the desired location.
Please preserve this backup file.
Take a backup of C:/NewGenLibFiles directory.
Take a backup of all directories mentioned in your C:/NewGenLibFiles/SystemFiles/Env_var.txt file.
For windows environment
Click on Start -> Programs -> PostgreSQL 8.0 -> pgAdmin III. This will open pgAdmin III screen.
On the left hand side of the screen you will find a tree structure, in which you will find server Servers, under servers you'll find PostgresSQL Database server server 8.0, with a right cross mark. Double click on that.
The system will prompt for the password. Please enter password there.
Once the password is validated successfully, you'll find Databases. Right click on databases and click on New database. In New database dialog please enter these parameters mentioned below. Parameters other than mentioned below, should be left as they are.
Name: newgenlib
Owner: postgres
Tablespace: pg_default
And click on the Ok button
Now select the database newgenlib, right click and click on refresh. Now again right click and click on Restore.
Now the system will ask for restore file name, enter the restore file name or use can use the three dotted button beside the file name to use the file dialog to assist you in selecting the file name at the desired location.
Now click on Ok button.
This operation will take some time. Time taken depends on the size of the database. Once the database restores, please click on Done button.
The librarian of the organization is always updated with latest releases, updates and upgrades via email. The updates are usually available as http://www.kiikm.org/ear/newgenlib.zip. The size of the download will be around 15 MB, but may increase.
Once the above file is downloaded, it should have the name and extension as newgenlib.ear, if not rename it as newgenlib.zip
Copy newgenlib.ear file into {Drive Letter}:/ jboss-3.2.1_tomcat-4.1.24/server/default/deploy directory. The server usually redeploys the new application automatically. However, if you encounter problems, please close the NewGenLib server and start it again
On the desktop of the Server, where NewGenLib Server is running, you can see a window called NewGenLib Server. You can just click on the windows close button on the right hand top most corner. This will shutdown the NewGenLib Server
On the desktop of the server you can see a Icon called NewGenLib Server. Double click on the icon, the server will start. But please note that the server takes some time to complete its initialization process. At the end of the initialization process you’ll see a message called “Started in xx s : yyy ms”. How fast the server initializes depends on the speed of the server processor, its RAM, and how many other applications are running on the server.
To enable auto-email of NewGenLib, these settings should be done carefully. In, {Drive Letter}:\jboss-3.2.1_tomcat-4.1.24\server\default\deploy directory there is a file named mail-service.xml. This contains information about NewGenLib’s email connectivity to the mail server. Please note that NewGenLib Server is not a mail server. It connects to the mail server configured and dispatches emails just as any other mail client.
In Windows -> Control Panel -> Administrative tools -> Services, you’ll find FireBird Server. If you don’t find that, you can go to Task manager of windows and in Processes you should find fbserver.exe and fbgaurd.exe running.
To check the database connectivity, go to , {Drive Letter}:\jboss-3.2.1_tomcat-4.1.24\server\default\deploy\firebird-ds.xml. This XML file can be edited to correct the connectivity to the database.
If NewgenLib Sever fails to initialize, you should check whether the following ports are free. 8083, 1099, 8080, 8009, 8443 and 5432(Used by Postgres). The mentioned are the ports used by JBoss Application server and Postgres Database server.
Go to {Drive Letter}:\jboss-3.2.1_tomcat-4.1.24\server\default\log directory. In this directory you'll find a file name called as server.txt. Select this file, right click on it and click on "Add to server.zip"(Please note that you'll get this option only if WinZip is installed on your machine, if this option is not there, then you'll have manually zip Server.txt). And please send a mail to atyourservice@newgenlib.com, with this server.zip as an attachement. Also please mention in your mail a detailed explanation about when and where(which part of the interface) you encountered this problem. Also please note that, the server.zip file is created at the instance when the problem has arised, it means that server should not be shutdown or restarted before you zip the contents. Once you restart the server, the log of the problem will be erased, so please be cautious.