Building a Base Image Containing Enterprise Developer Build Tools for Windows

For users of Enterprise Developer for Eclipse (Windows):

1. Specify a base image to work from. This will typically be microsoft/dotnet-framework or microsoft/dotnet-framework-build.

   When creating a base image containing Enterprise Developer Build Tools for Windows you might want to create two different versions of the image - a regular image (which is built from microsoft/dotnet-framework) and a "-build" image (which is built from microsoft/dotnet-framework-build). The microsoft/dotnet-framework-build image includes build-related files that are not included in microsoft/dotnet-framework, so while an image built from microsoft/dotnet-framework will let you run applications, if you want to build applications you should use microsoft/dotnet-framework-build.

   Note: Because microsoft/dotnet-framework-build contains additional files that are not included in microsoft/dotnet-framework, for the sake of keeping container sizes to a minimum you should only use microsoft/dotnet-framework-build when you need the additional build-related features.

   The container demonstration that builds the base image containing Enterprise Developer Build Tools for Windows uses this approach, creating both microfocus/edbuildtools:win_100 and microfocus/edbuildtools-build:win_100.

2. Define metadata for your image. This will make it easier to establish significant details of the image when you use the docker inspect command.
3. Define any variables for filenames and folder locations.
   Note: If you will be using this image to run applications under Enterprise Server, you need to set the MFDS_EXTERNAL_ADDR environment variable to specify a resolvable external address string. This is to enable client browsers to resolve the URLs used by ESMAC and other utilities in Enterprise Server Administration.

   The value that you specify for this environment variable is used to replace the internal container address in the URL.

4. Copy the installable executable file for Enterprise Developer Build Tools for Windows (edbt_100.exe) from your host machine to a temporary folder in the image's filesystem, then run it to install Enterprise Developer Build Tools for Windows.

   When running edbt_100.exe you need to specify the following parameters:

   /q

   to run the installaton silently; that is non-interactively with no user interface, using defaults for any values that are not specified elsewhere on the command line.

   InstallFolder=installation-location

   to specify the name of the folder into which you want to install Enterprise Developer Build Tools for Windows. This a folder that you must have created on the image's filesystem.

   /l log-file-name

   to create a log file of the installation.

   accepteula=yes

   to indicate that you accept the terms of the Micro Focus End User License Agreement (EULA).

5. Check the log file produced by the installation to ensure that the installation was successful.
6. Use the MFLicenseAdmin.exe utility to install the license for Enterprise Developer Build Tools for Windows.
7. Set up the Ant and Java support.
8. Specify the network ports that the container will listen on at run-time.
9. Perform any required clean-up. This includes tasks such as resetting variables and deleting temporary folders.
10. Set the working directory to be the folder into which you installed Enterprise Developer Build Tools for Windows.

For users of Enterprise Developer for Eclipse (UNIX), or Enterprise Developer UNIX Components:

To build a base image that includes Enterprise Developer your Dockerfile needs to perform the following steps:

1. Specify a base image to work from. This will typically be rhel7/rhel:latest or suse/sles12sp3 depending on whether you are using Red Hat Linux or SUSE Linux.
2. Define metadata for your image. This will make it easier to establish significant details of the image when you use the docker inspect or podman inspect command.
3. Define any variables for filenames and folder locations.
4. Install any packages that are required for Enterprise Developer Build Tools for Windows to install successfully. See Software Requirements for more information.
5. Copy the installable executable file for Enterprise Developer Build Tools for Windows (setup_entdev_for_docker_10.0_platform.gz) from your host machine to a temporary folder in the image's filesystem.
6. Create the user and groups whose details will be used when installing Enterprise Developer Build Tools for Windows.
7. Ensure that the installable executable file for Enterprise Developer Build Tools for Windows has execute permissions, then execute it.

   When running setup_entdev_for_docker_10.0_platform.gz you need to specify the following parameters:

   -IacceptEULA

   to indicate that you accept the terms of the Micro Focus End User License Agreement (EULA).

   -ESadminID=user-name

   to set the Enterprise Server System Administrator Process User ID.

8. Configure the dynamic linker run-time bindings to include the shared objects supplied with Enterprise Developer.

   Doing this avoids the need to update the LD_LIBRARY_PATH environment variable.

9. Perform any required clean-up. This includes tasks such as resetting variables and deleting temporary folders.
10. Install a license for Enterprise Developer Build Tools for Windows then remove the license file.