Differences

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

--- en:user_advanced:webswing_gli [2023/11/28 23:58] – kjdon
+++ en:user_advanced:webswing_gli [2024/03/06 00:14] (current) – [Debugging] kjdon
@@ Line 1: / Line 1: @@
 ====== Webswing GLI ======
-Webswing is a technology that allows java programs to run in a browser.
+Webswing is a technology that allows java programs to run in a browser.\\
-Greenstone 3.11 and later comes with webswing enabled.
+Greenstone 3.11 and later comes with webswing enabled, so that GLI can be run in a browser, allowing remote users the ability to build and edit collections on the server without having to install Greenstone (and Remote GLI).\\
+To get started using webswing GLI, see tutorial [[https://files.greenstone.org/tutorial/gs3-current/en/webswing_gli.htm| Using Webswing GLI]]
-It is provided as an extension, in greenstone3/ext/webswing. You don't need to compile it up, it ships with a ready-to-go JAR/WAR file.
+It is provided as an extension, in greenstone3/ext/webswing. You don't need to compile it up, Greenstone3 ships with a ready-to-go webswing JAR/WAR file.
 The webswing framework requires a graphical environment. If you are on a standard desktop, then it will work out of the box.
 However, if you are on a headless Linux environment, then you will need to install:
-  * xvfb  (x-virtual frame buffer) - for example, <code>sudo apt install xvfb</code>
+  * xvfb  (x-virtual frame buffer) - for example, ''sudo apt install xvfb''
 You may also need the following:
   * libxext6
@@ Line 32: / 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):
+<code>
+    RewriteEngine on
+    RewriteCond %{HTTP:Upgrade} =websocket
+    RewriteRule /(.*) ws://localhost:8383/$1 [P,L]
+    RewriteCond %{HTTP:Upgrade} !=websocket
+    RewriteRule /(.*) http://localhost:8383/$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
+==== Debugging ====
+==== 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.
+  *