Greenstone Wiki

User Tools

Site Tools

You are here: index » en » user_advanced » gs3_server
en:user_advanced:gs3_server

Differences

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

Link to this comparison view

Next revision		Previous revision
Next revisionBoth sides next revision
en:user_advanced:gs3_server [2016/11/16 20:33] – created kjdonen:user_advanced:gs3_server [2016/11/17 00:10] – [Proxying Tomcat with Apache] 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, 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 ===
en/user_advanced/gs3_server.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1