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.

You can either download the GroupWise Web image from the Micro Focus download site or through Docker.

NOTE:The Micro Focus download should be used if your server doesn’t have access to the Internet. Otherwise, we recommend you use the Docker image.

Using the Micro Focus Download

  • Download the gw18.4.0-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 gw18.4.0-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:18.4.0-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.4.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.4.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. If you use --restart, remove --rm from your command as they don’t work together.

  • (Optional) If you want to run GW Web on a 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.4.0-111

Using the Docker Image

  • 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:latest
    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:latest

    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. If you use --restart, remove --rm from your command as they don’t work together.

  • (Optional) If you want to run GW Web on a 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:latest

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