User Tools

Site Tools


en:user_advanced:gs3_server

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
en:user_advanced:gs3_server [2016/11/16 20:44] – [Apache Tomcat] kjdonen:user_advanced:gs3_server [2017/05/08 01:52] kjdon
Line 5: Line 5:
 Tomcat is a servlet container, and Greenstone3 runs as a servlet inside it.  Tomcat is a servlet container, and Greenstone3 runs as a servlet inside it. 
 The file ''$GSDL3SRCHOME/packages/tomcat/conf/server.xml'' is the Tomcat configuration file.  The file ''$GSDL3SRCHOME/packages/tomcat/conf/server.xml'' is the Tomcat configuration file. 
 +
 A Tomcat Context represents a web application. The Context for Greenstone3 is given by the file A Tomcat Context represents a web application. The Context for Greenstone3 is given by the file
 $GSDL3SRCHOME/packages/tomcat/conf/Catalina/localhost/greenstone3.xml.  $GSDL3SRCHOME/packages/tomcat/conf/Catalina/localhost/greenstone3.xml. 
-This tells Tomcat where to find the files for the application including its web.xml file (in the $GSDL3HOME folder, ie the web folder in your greenstone3 installation) , and what URL (/greenstone3) to give it. To make changes to these files, don't edit these files directly as Greenstone configures these each time it starts up. See the section on changing Tomcat settings [[#Changing_Tomcat_settings|below]].+This tells Tomcat where to find the files for the application including its web.xml file (in the $GSDL3HOME folder, ie the web folder in your greenstone3 installation) , and what URL (/greenstone3) to give it.  
 + 
 +To make changes to these files, don't edit these files directly as Greenstone configures these each time it starts up. See the section on changing Tomcat settings [[#Changing_Tomcat_settings|below]]. 
 Anything inside the Context directory is accessible via Tomcat . For example, the index.html  Anything inside the Context directory is accessible via Tomcat . For example, the index.html 
 file that lives in $GSDL3HOME can be accessed through the URL file that lives in $GSDL3HOME can be accessed through the URL
Line 15: Line 19:
 ==== Starting and Stopping Tomcat ==== ==== Starting and Stopping Tomcat ====
  
-Greenstone provides a little server program which will start the Tomcat server and open the library in a browser. See the [[en:greenstone_server|Greenstone Server]] page in the Beginner's Guide.+Greenstone provides a little server program which will start the Tomcat server and open the library in a browser. See the [[en:user:greenstone_server|Greenstone Server]] page in the User's Guide.
 Alternatively, you can use Ant to stop and start Tomcat. Run these commands from the main Greenstone3 installation directory ($GSDL3SRCHOME). Alternatively, you can use Ant to stop and start Tomcat. Run these commands from the main Greenstone3 installation directory ($GSDL3SRCHOME).
  
Line 94: Line 98:
 http://www.greenstone.org/greenstone3/library, instead of at  http://www.greenstone.org/greenstone3/library, instead of at 
 http://puka.cs.waikato.ac.nz:8080/greenstone3/library, which is not publicly accessible. http://puka.cs.waikato.ac.nz:8080/greenstone3/library, which is not publicly accessible.
 +
 +You will also need to tell Greenstone itself about the new web address. Edit 
 +**web/sites/localsite/siteConfig.xml**. Add a line like the following to the <metadataList>:
 +<code>
 +<metadata name="siteURL">http://www.greenstone.org/greenstone3/</metadata>
 +</code>
 +
  
 === Running Tomcat behind a proxy === === Running Tomcat behind a proxy ===
Line 116: Line 127:
 <code>$ ant stop</code> <code>$ ant stop</code>
 Then, deploy  Then, deploy 
-(as written in the [[http://www.greenstone.org/docs/greenstone3/manual.pdf|Greenstone 3 manual]], p. 5):+(as written in the [[http://files.greenstone.org/technical/gs3manual.pdf|Greenstone 3 manual]], p. 5):
 <code>$ ant deploy-localsite</code> <code>$ ant deploy-localsite</code>
 Check that it works, by **starting** tomcat again and going to: Check that it works, by **starting** tomcat again and going to:
Line 122: Line 133:
 Make sure that the page appears. You can also look at the wsdl file for the gs3 web service that's been exposed:  Make sure that the page appears. You can also look at the wsdl file for the gs3 web service that's been exposed: 
 <code>http://localhost:8080/greenstone3/services/localsite?wsdl</code> <code>http://localhost:8080/greenstone3/services/localsite?wsdl</code>
-You can also deploy other sites, see the [[http://www.greenstone.org/docs/greenstone3/manual.pdf|Greenstone 3 Developer's Manual]].+You can also deploy other sites, see the [[http://files.greenstone.org/technical/gs3manual.pdf|Greenstone 3 Developer's Manual]].
  
  
en/user_advanced/gs3_server.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1