16.4 Downloading and Running the web-config Utility

Before you can run the GroupWise Web image, you must run the web-config utility to create four files that have the GroupWise, POA, DVA, and certificate configuration of your GroupWise system. You can either download the web-config utility from the Micro Focus download site or through Docker.

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

IMPORTANT:If you make changes your GroupWise POAs or DVAs after running this utility, you need to rerun the web-config utility to generate new files and stop and start your GroupWise Web image.

New in 18.4 - Your GroupWise Admin Service must pass certificate verification in order for the web-config utility to run. For information on certificate verification, see Securing GroupWise Web using Certificate Verification.

Using the Micro Focus Download

Download the gw18.4.0-xxx-web-config_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-config_docker.tar.gz
```
Run the following command to view a list of your docker images. Make sure the web-config image is in the list:
```
docker image list
```
Run the following command to create the web.conf file specifying in the Web-Config location where you want to place the web.conf file and filling out the information about your GroupWise system:
```
docker run -it -v <Web-Config Location>:/config -e GWADMIN_SERVICE=<GroupWise Admin Service Username>@<GroupWise Primary Domain>:<GroupWise Admin Service Port> -e GWSOAP_HOST_DEFAULT=<GroupWise POA with SOAP> mfgroupwise/web-config:18.4.0-xxx
```
```
Example command:
docker run -it -v /opt/novell/gw:/config -e GWADMIN_SERVICE=admin@192.168.1.1:9710 -e GWSOAP_HOST_DEFAULT=192.168.1.2 mfgroupwise/web-config:18.4.0-111
```
IMPORTANT:If the GroupWise Admin Service Username you are using is configured with Multi-Factor Authentication, you need to have the user registered with a UI-less method so they can enter their password when prompted as password&ui-lessauthmethod.

Using the Docker Image

Run the following command to download the web-config Docker image on your Docker server:
```
docker pull mfgroupwise/web-config
```

Run the following command to create the web.conf file specifying in the Web-Config location where you want to place the web.conf file and filling out the information about your GroupWise system:

docker run -it -v <Web-Config Location>:/config -e GWADMIN_SERVICE=<GroupWise Admin Service Username>@<GroupWise Primary Domain>:<GroupWise Admin Service Port> -e GWSOAP_HOST_DEFAULT=<GroupWise POA with SOAP> mfgroupwise/web-config

Example command:
docker run -it -v /opt/novell/gw:/config -e GWADMIN_SERVICE=admin@192.168.1.1:9710 -e GWSOAP_HOST_DEFAULT=192.168.1.2 mfgroupwise/web-config