Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:user_advanced:gs3_server [2016/11/17 12:52]
kjdon [Starting and Stopping Tomcat]
en:user_advanced:gs3_server [2018/07/23 17:58] (current)
anupama [Proxying Tomcat with Apache]
Line 19: 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:​user:​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 99: Line 99:
 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>​
 +
 +
 +Set up the tomcat.port and shutdown port in your ''​build.properties''​ file if different from the default 8383 and 8305 respectively.
 +
 +Also edit these files ton contain the new url-prefix (if different from /​greenstone3):​
 +<​code>​
 + ./​resources/​web/​global.properties.in
 + ./​resources/​web/​global.properties
 +</​code>​
 +to change ​
 +<​code>​tomcat.context=@greenstone.context@</​code>​
 +to
 +<​code>​
 + #​tomcat.context=@greenstone.context@
 + tomcat.context=urban-narrative-greenstone3
 +</​code>​
 +
 +Don't forget to run (from GS3 folder):
 +<​code>​
 + ant configure-web
 +</​code>​
 +to regenerate the global.properties file in the actual web folder.
 +
 +Finally, to get everything running:
 +</​code>​
 +./​gs3-setup.sh
 +ant start
 +<​code>​
 +Then
 +<​code>​ssh you@remote.public.machine (e.g. puka)</​code>​
 +In the same x-term, ssh -L back into the machine running the GS3 server:
 +<​code>​puka$ ssh -L port:​localhost:​port (you@)gs3-server.machine.domain</​code>​
 +
 +On any browser, visit:
 +<​code>​remote.public.machine/​url-prefix/​library</​code>​
 === Running Tomcat behind a proxy === === Running Tomcat behind a proxy ===
 Almost everything works fine when Tomcat is running behind a proxy. ​ Almost everything works fine when Tomcat is running behind a proxy. ​
Line 120: Line 160:
 <​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 126: Line 166:
 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]].