Differences

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

--- en:user_advanced:webswing_gli [2023/12/10 21:46] – [Webswing GLI] kjdon
+++ en:user_advanced:webswing_gli [2025/09/08 01:58] (current) – [Useful Notes] kjdon
@@ Line 33: / Line 33: @@
 See [[https://httpd.apache.org/docs/2.4/mod/mod_proxy_wstunnel.html]]
-You also need to edit the apache configuration file for your VirtualHost (assuming your tomcat is running on port 8383):
+You also need to edit the apache configuration file for your VirtualHost. This file might be in eg /etc/apache2/sites-available/000-default-le-ssl.conf, or /etc/httpd/conf.d/yourcustomname.conf.
+Assuming your tomcat is running on port 8383:
+If your apache is 2.4.47 or later: (httpd -v to determine version)
+<code>
+ProxyPass "/webswing-server/" "http://localhost:8383/webswing-server/" upgrade=websocket
+</code>
+If your apache is older than 2.4.47, try the following:
 <code>
     RewriteEngine on
     RewriteCond %{HTTP:Upgrade} =websocket
-    RewriteRule /(.*) ws://localhost:8383/$1 [P,L]
+    RewriteRule /webswing-server/(.*) ws://localhost:8383/webswing-server/$1 [P,L]
     RewriteCond %{HTTP:Upgrade} !=websocket
-    RewriteRule /(.*) http://localhost:8383/$1 [P,L]
+    RewriteRule /webswing-server/(.*) http://localhost:8383/webswing-server/$1 [P,L]
 </code>
-This file might be in eg /etc/apache2/sites-available/000-default-le-ssl.conf, or /etc/httpd/conf.d/yourcustomname.conf
+Note, this doesn't work if you have two greenstone installs running at the same time, on different ports.
+==== Configuration ====
+There is a config file web/ext/webswing/etc/webswing.config.in. You can edit that. When you run an ant restart, webswing.config will be generated from this .in file.
+Some useful settings in this file:
+  * uploadMaxSize - the maximum file size allowed to be uploaded (FileChooser) in MB. Set to 0 for unlimited size. Note, if the size is less than a file you are trying to upload to a collection, it will silently fail and give you no reason why.
+  *
+==== Debugging ====
+  * webswing log goes to packages/tomcat/bin/logs/webswing.log. GLI System.err goes there.
+  * For GLI debugging - add -debug to the args for GathererProg in web/ext/websing/etc/webswing.config.in. Restart tomcat. A GLI log file will go to gli/webswing-users/<username>/debug<date>.txt. Note, this folder is also where the GLI config file is stored for the user - configWebswing.xml. GLI DebugStream.println goes here.
+====Deactivating Webswing ====
+Webswing is used for web-based GLI, Phind and Collage classifiers. If you don't need any of these things you can deactivate webswing by running:
+<code>
+cd <PATH-TO_GS3-INSTALL>/ext
+./DEACTIVATE.sh webswing
+</code>
+It can be re-activated by running ''./ACTIVATE.sh webswing'' in the same folder.
+==== Useful Notes ====
+  * You can see your webswing apps at http://localhost:8383/webswing-server (depending on port and webswing.context settings in build.properties)
+  * If you run the GLI app from here (instead of from a page inside of greenstone), then the preview button won't work.
+  *