Migration

The docker save command can be used to archive a docker image which includes the Onload installation. This image can then be migrated to other servers having the following configuration:

• Docker is installed and docker service is running
• Host operating system RHEL 7
• The Onload version running on the host must be the same as the migrated image Onload version
• The target server does not need to have the same network adapter types installed.

1. Create a tar file of the container image:

   # docker save -o <dir path to store image>/<name of image>.tar <current name of image>

   Example (store image tar file in host /tmp directory):

   # docker save -o /tmp/dk-onload-201502.tar onload

2. The image tar file can then be copied to the target server where it can be loaded with the docker load command:

   # docker load -i /<path to transferred file>/dk-onload-201502.tar

   # docker images
   REPOSITORY  TAG   IMAGE ID        CREATED             VIRTUAL SIZE
   onload      v1    303ec2d3e2b5    About an hour ago   486 MB

3. Create/run a container from the transferred image.

   # docker run --net=host --device=/dev/onload --device=/dev/onload_epoll --name=onload -it onload:v1 /bin/bash

   When the container has been created, Onload will be running within it.

   Note: The directive --device=/dev/onload_cplane is required when used with onload-201606 and later releases.