source: other-projects/trunk/greenstone3-extension/mat/FAQ.txt@ 18239

1. Metadata Analysis Tool (Java application)

1-1 Please select "local Collection Analysis" and press the "Analyse" button.

1-2 Select a collection you want to analyse it.

If there is no collection available, please use GLI to create a collection and try this function again.


2. Metadata Analysis Tool (web service)
Root is the location of Greenstone folder.
ex: Windows: C:\Program files\Greenstone
ex: Linux: /home/Greenstone


2-1 Please rename the root/ext/mat/web-mat.xml to web.xml and copy it to the root/web/WEB-INF folder.
      You might want to backup the original web.xml.

2-2 Copy the gsdl3_extension folder (path: root/ext/mat/build/classes/org/greenstone/gsdl3_extension) to 
      greenstone folder (path: root/web/WEB-INF/classes/org/greenstone)

Now, the path should be root/web/WEB-INF/classes/org/greenstone/gsdl3_extension/mat/servlet

Inside the servlet folder, you will see many class files.

2-3 Please run the command "ant deploy-localsite" in the console.

2-4 Then, you can start the server and use the web service.

The web service is available at http://localhost:8080/greenstone3/mat.
Please make sure that there is no slash at the end of this URL. 
ex: http://localhost:8080/greenstone3/mat/ is incorrect and you will not be able to access the service. 

Notice: If you use any proxy servers, please open the properties.xml and  enter the property settings.

Troubleshooting

1. Why my web service cannot analyse the OAI repository ( Message: GDBM could not be open)?
Please use the GLI to create a sample collection and make sure that the Greenstone can build it correctly.
If the Greenstone cannot build the collection correctly. Please report the error to http://www.greenstone.org/. 

2. My computer cannot recognise the "Ant" command?
You will need to setup the ant path and run the command in the greenstone root folder.