Installing Watson Explorer oneWEX on Docker

You can install IBM Watson® Explorer oneWEX on Docker, which is a container platform.

Watson™ Explorer oneWEX on Docker can be installed on Microsoft Windows Server 2016, Ubuntu, or Red Hat Enterprise Linux®.

For detailed operating system and prerequisite software requirements, see the system requirements report for the version you are installing, linked from this topic: Installing Watson Explorer oneWEX.

If you are installing on Red Hat Enterprise Linux, you must install the libXScrnSaver.x86_64 package. In addition, if you are installing on Red Hat Enterprise Linux version 7.2 or higher and you are using the xfs filesystem, the setting d_type=true must be enabled. For more information, see Use the OverlayFS storage driver - Prerequisites.

  1. Go to The Docker Platform to download and install the appropriate version of Docker. If you are downloading the Microsoft Windows installer, be sure to select the Docker CE (Community Edition) for Windows.
    Important: The Docker installation must use Linux containers, even for a Microsoft Windows installation. This is the default setting.
    Additional installation steps for Docker for Microsoft Windows
    1. After completing installation, reboot Docker. Docker will present a dialog to enable Hypervisor. You must enable Hypervisor for Docker to function (note that this will prevent you from running the VMWare product). Your machine will reboot again.
      Note: Docker has a published caveat for running on virtual hardware.
    2. Once Docker is up and running, check the Hyper V Manager to see the Linux container.
    3. The MobyLinuxVM panel on the right side of the Hyper V Manager allows you to see statistics for the MobyLinuxVM. Select Settings and change the memory for the container: you need 4 CPUs and at least 8.5 GB of RAM for your VM, per the installer prerequisites.
      Note: Your actual machine – or virtual hardware, in case of VMWare – must actually be configured for 4 CPUs. If not, Hyper V will not allow you to set the CPU to 4.
      These settings should then match the ones in the Docker Settings.
  2. Download either the Microsoft or Linux version of Watson Explorer oneWEX from Passport Advantage®.
  3. Decompress the downloaded archive into one-wex-installer-linux.bin (Linux) or one-wex-installer-windows.exe (Windows).
  4. You can install Watson Explorer oneWEX using the installation wizard, running a silent installation, or by running a console installation.

Installation wizard

Graphical installation is the typical installation method. Choose this option if you want to step through the installation manually and customize your installation.

On Linux
To start the graphical installation program, run the ./one-wex-installer-linux.bin command.
On Windows
To start the graphical installation program, run the one-wex-installer-windows.exe command.

Silent installation

To install the product silently, you must create a response file to provide information that allows the installation program to install and configure your system, and then run the installation command that is appropriate for your operating system. Create a response file that contains the following lines.

#Indicate whether the license agreement been accepted
#----------------------------------------------------
LICENSE_ACCEPTED=TRUE

#Choose Install Folder
#---------------------
USER_INSTALL_DIR=<value>

# 'admin' user's password 
#---------------------
USER_SUPPLIED_PASSWORD=<value>

Run the following command on a command line.

On Linux
./one-wex-installer-linux.bin -i silent -f <response_file>
On Windows
one-wex-installer-windows.exe -i silent -f <response_file>

Console installation

To run the installation program in text mode from a console, run the command that is appropriate for your operating system. The screens are rendered in text and prompt you for the same information as the graphical installation.

On Linux
./one-wex-installer-linux.bin -i console
On Windows
one-wex-installer-windows.exe -i console

It might take a few minutes for the installation program to finish installing the software after you press Enter at the end of the installation prompts. Do not end the program or suspend it until user control is returned so that additional commands can be entered.

You can modify ports, mount points, and other properties by editing the Watson Explorer oneWEX configuration file (config/wex.json). Here is an example of this file.

{
    "env": {
        "SOLR_MAX_HEAP": "4g",
        "DOCPROC_WORKER_NUM": "2",
        "DOCPROC_MAX_MEMORY": "2g",
        "ZK_MAX_HEAPSIZE": "1g",
        "ZK_MIN_HEAPSIZE": "512m",
        "WLP_JVM_MAX_MEMORY": "1g"
    },
    "port": 8443,
    "name": "wex12dae",
    "wexDataVolume": "wex12dae",
    "dockerImage": "ibm-wex-ee:12.0.0.82",
    "mounts": {
        "dev-data": "/data"
    }
}

Configure authentication and TLS inside of Watson Explorer oneWEX

Authentication and TLS of inter-process communication (inside of Watson Explorer oneWEX) are enabled by default. To disable the feature, do the following steps:
  1. Add configuration environment variable INSECURE_SVC=true to wex.json.
    {
    "env": {
        "INSECURE_SVC": "true"
    },
}
  2. Restart the Watson Explorer oneWEX Docker container.
Note: To enable the feature again, remove the configuration environment variable INSECURE_SVC=true, and restart the Watson Explorer oneWEX Docker container.

Running Watson Explorer oneWEX

You can launch Watson Explorer Admin Console and Watson Explorer Content Miner from the graphical user interface with the commands bin/ibmwatsonexplorer (Linux) or bin/IBM Watson Explorer.exe (Windows).

You can restart the Watson Explorer oneWEX docker container from the command line with the commands bin/wexdocker.sh (Linux) or bin/wexdocker.bat (Windows). Watson Explorer oneWEX can then be invoked in a web browser using the URLs https://<server>:<port>/miner/ for Watson Explorer Content Miner and https://<server>:<port>/admin/ for Watson Explorer Admin Console.