16.5 Downloading and Running the GroupWise Web Image

The first time you run the GroupWise Web image, you need to specify the folder that has the files created when the web-config utility ran and (optionally) your TLS certificates. For convenience, the Web Client can create certificates for your system. For information about certificate best practices and troubleshooting certificate issues in GroupWise and GroupWise Web, see Certificate Best Practices in the GroupWise 18 Administration Guide.

There are two options to download and run the web-config utility:

16.5.1 Option 1 - Using a Docker Run Command

To download and run the GroupWise Web image using Docker:

  • Run the following command to pull down the GroupWise Web image:

    docker pull mfgroupwise/web

  • Run the following command to run the image (use the information from the GroupWise Web Worksheet to fill out the command):

    docker run -d -v <Web-config Location>:/etc/nginx/gw --name gwweb --rm -e FQDN=<Docker Server Name> -e DNS_SERVER=<DNS Server> -p 80:80 -p 443:443 -v <(Optional) Server Certificate>:/certs mfgroupwise/web:latest

    EXAMPLES:

    • To run with GroupWise self-signed certificates:

      docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 80:80 -p 443:443 mfgroupwise/web:18.5.0-111

    • To run with commercially signed certificates:

      docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 80:80 -p 443:443 -v /opt/novell/gw/certs:/certs mfgroupwise/web:18.5.0-111

    • To run with commercial certs while disabling DVA verification:

      docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 80:80 -p 443:443 -v /opt/novell/gw/certs:/certs -e GWDVA_SSL_VERIFY=off mfgroupwise/web

    NOTE:/opt/novell/gw/certs should contain the server.key and server.crt files.

    You can add --restart always after run -d in the command to have the image restart automatically after rebooting the Docker server. However, if you use --restart, you must remove --rm from your command as they do not work together.

  • (Optional) If you want to run GroupWise Web on different ports than 80 and 443 (this is useful if you have more than one server running in Docker), you should change the initial port number (i.e. -p <port>:80 -p <TLS_port>:443) and add -e TLS_REDIR_PORT=<port> -e TLS_REDIR_PORT=<TLS_port>.

    Example with commercial certs:

    docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 8080:80 -p 8443:443 -e TLS_REDIR_PORT=8080 -e TLS_REDIR_PORT=8443 -v /opt/novell/gw/certs:/certs mfgroupwise/web:18.5.0-111

You can now access GroupWise Web by going to https://<Docker_Server_Name>.

16.5.2 Option 2 - Using the Micro Focus Download Site

  • Download the <gw.version>-xxx-web_docker.tar.gz from the GroupWise download site on your Docker server.

  • Run the following command to load the Docker image (make sure to replace the xxx in the file name):

    docker load -i <gw.version>-xxx-web_docker.tar.gz

  • Run the following command to view a list of your Docker images. Make sure the GroupWise Web image is in the list:

    docker image list

  • Run the following command to run the image (use the information from the GroupWise Web Worksheet to fill out the command):

    docker run -d -v <Web-config Location>:/etc/nginx/gw --name gwweb --rm -e FQDN=<Docker Server Name> -e DNS_SERVER=<DNS Server> -p 80:80 -p 443:443 -v <(Optional) Server Certificate>:/certs mfgroupwise/web:<gw.version>-xxx

    EXAMPLES:

    • To run with GroupWise self-signed certificates:

      docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 80:80 -p 443:443 mfgroupwise/web:18.5.0-111

    • To run with commercially signed certificates:

      docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 80:80 -p 443:443 -v /opt/novell/gw/certs:/certs mfgroupwise/web:18.5.0-111

    NOTE:/opt/novell/gw/certs should contain the server.key and server.crt files.

    You can add --restart always after run -d in the command to have the image restart automatically after rebooting the Docker server. However, if you use --restart, you must remove --rm from your command as they do not work together.

  • (Optional) If you want to run GroupWise Web on different ports than 80 and 443 (this is useful if you have more than one server running in Docker), you should change the initial port number (i.e. -p <port>:80 -p <TLS_port>:443) and add -e TLS_REDIR_PORT=<port> -e TLS_REDIR_PORT=<TLS_port>.

    Example with commercial certs:

    docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 8080:80 -p 8443:443 -e TLS_REDIR_PORT=8080 -e TLS_REDIR_PORT=8443 -v /opt/novell/gw/certs:/certs mfgroupwise/web:18.5.0-111

  • (Optional) If you want to disable DVA certificate verification when you run the web image, follow this command example:

    Example command disabling DVA verification with commercial certs:

    docker run -d --rm -v /opt/novell/gw:/etc/nginx/gw --name gwweb -e FQDN=webacc.acme.com -e DNS_SERVER=192.168.1.5 -p 80:80 -p 443:443 -v /opt/novell/gw/certs:/certs -e GWDVA_SSL_VERIFY=off mfgroupwise/web:18.5.0-111