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.
- 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
- 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.
- Once Docker is up and running, check the Hyper V Manager to see the Linux container.
- 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.
- 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.
- Download either the Microsoft or Linux version of Watson Explorer oneWEX from Passport Advantage®.
- Decompress the downloaded archive into one-wex-installer-linux.bin (Linux) or one-wex-installer-windows.exe (Windows).
- 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
- Add configuration environment variable
INSECURE_SVC=true
towex.json
.{ "env": { "INSECURE_SVC": "true" }, }
- Restart the Watson Explorer oneWEX Docker container.
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.