User Tools

Site Tools


en:user_advanced:webswing_gli

Webswing GLI

Webswing is a technology that allows java programs to run in a browser.
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 Using Webswing GLI

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, sudo apt install xvfb

You may also need the following:

  • libxext6
  • libxi6
  • libxtst6
  • libxrender1

To start Greenstone when you are using webswing, please use the new scripts:

  • ant-start-with-exts.sh
  • ant-stop-with-exts.sh
  • ant-restart-with-exts.sh

These will make sure the right environment is set up for Tomcat.

When Tomcat is behind an Apache server

If you Tomcat is running behind an Apache webserver, there are some extra steps to get it running in this situation.

  • Apache needs to have the proxy_wstunnel module enabled:
    • (sudo) apachectl -M - to list modules
    • (sudo) a2enmod proxy_wstunnel - to enable the module

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):

    RewriteEngine on

    RewriteCond %{HTTP:Upgrade} =websocket
    RewriteRule /(.*) ws://localhost:8383/$1 [P,L]

    RewriteCond %{HTTP:Upgrade} !=websocket
    RewriteRule /(.*) http://localhost:8383/$1 [P,L]

This file might be in eg /etc/apache2/sites-available/000-default-le-ssl.conf, or /etc/httpd/conf.d/yourcustomname.conf

Debugging

en/user_advanced/webswing_gli.txt · Last modified: 2024/01/17 03:06 by kjdon