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:
Option 1 - Using a Docker Run Command (recommended): Using a run command from your Docker server is the recommended way to download and run the GroupWise Web image.
Option 2 - Using the Micro Focus Download Site (if required): If your server does not have access to the Internet you can use this option to download the GroupWise Web image from the Micro Focus download site.
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>.
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