Install UFT Mobile with Docker (on-premises)

This section describes how to install UFT Mobile on a Linux platform using Docker. Docker is a platform that enables you to develop, ship, and run applications via a container. This section is relevant only for on-premises deployments of UFT Mobile.

Install Docker

Follow the steps below to install Docker:

  1. Install Docker on the target machine, along with its dependencies. Currently, only the 64-bit version is supported. For installation details, see the Docker Installation guide.
  2. Set up the target machine environment as required.

Back to top

Obtain the UFT Mobile server image

You can obtain the latest UFT Mobile Docker image from the Docker hub.

Type the following in your Linux environment:

docker pull mobilelifecycle/uft-mobile:3.40

The image contains the Dockerfile of the UFT Mobile server that connects to a remote Postgres database. (The database installation is not included in the package.)

Note that when installing UFT Mobile with a Docker image:

  • Integration with LDAP is not supported
  • SSL is not supported

Back to top

Run PostgreSQL

The PostgreSQL database used by UFT Mobile is not included in the UFT Mobile server image. Make sure that you have the PostgreSQL database up and running on a machine that can be accessed by the server.

We recommend PostgreSQL version 9.6. If you don't have PostgreSQL, you can obtain it from the Docker hub by typing docker pull postgres:9.6.

To run the PostgreSQL container in the background:

Enter the following command when using the default PostgreSQL port (5432):

docker run --name postgres -p 5432:5432 -e POSTGRES_PASSWORD=[postgres_password] -d postgres:[PostgreSQL version number]

If you need to use a custom port, run the following:

docker run --name postgres -p [custom_port]:5432 -e POSTGRES_PASSWORD=[postgres_password] -d postgres:[PostgreSQL version number]

Make sure to use this custom port for POSTGRES_PORT= in the command for running the UFTM server in Start a container and launch the UFTM server.

Note: PostgreSQL adds a default user postgres.

Back to top

Start a container and launch the UFTM server

After you have the PostgreSQL database up and running, you can start the UFTM server container.

To start the UFT Mobile container:

  1. Check that the default port, 8080, is available and not being used by another process.
  2. Run the following command to run the UFT Mobile server in the background in detached mode:

    docker run -d --name uftm -p 8080:8080 -e POSTGRES_HOST=[postgres_ip] -e POSTGRES_PORT=5432 -e POSTGRES_USER=[postgres_user] -e POSTGRES_PASSWORD=[postgres_password] -e FQDN=[host_ip] mobilelifecycle/uft-mobile

    If you need to use a custom port, specify the custom port as follows:

    docker run -d --name uftm -p [custom_port]:8080 -e POSTGRES_HOST=[postgres_ip] -e POSTGRES_PORT=5432 -e POSTGRES_USER=[postgres_user] -e POSTGRES_PASSWORD=[postgres_password] -e FQDN=[host_ip] mobilelifecycle/uft-mobile

    Note: If you specify non-default ports, you also need to modify the ports on the connector and tools.

Starting with UFT Mobile 3.20, applications are no longer stored in the Postgres DB, but on the physical disk. This means you need to use a volume to maintain the persistence of the applications after the container is exited:

docker volume create uftm_data

docker run -d --name uftm [options] -v uftm_data:/opt/UFTMobile/mcStorage mobilelifecycle/uft-mobile

Back to top

Begin your UFT Mobile test

To use UFT Mobile for testing your mobile app:

  1. Open the UFT Mobile home page http://<host>:<port> and log in with the default credentials:
    Email: admin@default.com
    Password: password
    It may take a minute for the server to start up, and for the page to open.
  2. Install the appropriate UFT Mobile connector on the machine/s to which you will be connecting devices with a USB cable. You can connect multiple devices to the Docker host machine. The connector can be installed on the same machine on which Docker is installed. For details, see Install the connector on a Windows machine, Install the connector on a Linux machine or Install the connector on a Mac machine.
  3. Prepare your UFT Mobile test with the relevant testing tool, such as UFT, Sprinter, or TruClient.

Back to top

Tips and guidelines

The following table includes a list of useful Docker commands:

Command Action
docker ps Lists the containers that are running
docker stop uftm Stops the UFT Mobile service
docker start uftm Starts the UFT Mobile service
docker images Lists the images
docker inspect uftm|grep '"Source": "/var/lib/docker/volumes' Check the logs of the running uftm container.

The output will have the following form:

"Source": "/var/lib/docker/volumes/07ec0041ecf5f86934d2957648a24248fefeffdbb0da3a5b353d1d1fe480b656/_data"

Append server/log to the above path shown in the output. This folder contains the log files.

Back to top

See also: