\n
• We\u2019ve put together three Docker Images to choose from (https://hub.docker.com/u/openlink/). The Enterprise Edition images require a version-matched license file, while the Open Source (\u201CVOS\u201D) image does not.\n
  \n
  • Enterprise Edition 8.3 \u2013 openlink/virtuoso-closedsource-8
  \n
  • Enterprise Edition 7.2 \u2013 openlink/virtuoso-closedsource-7
  \n
  • Open Source (\u201CVOS\u201D) 7.2 \u2013 openlink/virtuoso-opensource-7
  \n
  \n
\n

The remainder of this article focuses on Enterprise Edition 8.3; most content applies to all three, with minor adjustments.

\n
• To pull the latest Virtuoso 8.2 docker 8 image to your local system, use the command:\n

  $ docker pull openlink/virtuoso-closedsource-8

  \n
\n
• To check the version of the Virtuoso binary, use the command:\n

  $ docker run openlink/virtuoso-closedsource-8 version

  \n This Docker image is using Virtuoso Universal Server (Enterprise Edition) Version 08.03.3319-pthreads as of Sep 9 2020, compiled for Linux (x86_64-generic-linux-glibc25).\n
\n

\n
• Create a new virtuoso instance on your system with the following commands:\n

  $ mkdir my_virtdb\n$ cd my_virtdb\n$ docker run \\\n    --name my_virtdb \\\n    --interactive \\\n    --tty \\\n    --env DBA_PASSWORD=mysecret \\\n    --publish 1111:1111 \\\n    --publish 8890:8890 \\\n    --volume `pwd`:/database \\\n    openlink/virtuoso-closedsource-8:latest

  \n
• This creates a new Virtuoso database in the my_virtdb subdirectory and starts a Virtuoso instance with the HTTP server listening on port 8890 and the ODBC / JDBC / ADO.Net / OLE-DB / ISQL data server listening on port 1111.
\n
• The docker image runs in foreground mode, allowing you to see its activity.
\n
• Access the Virtuoso HTTP server at http://localhost:8890/.
\n
• Shut down Virtuoso by pressing CTRL and C in the terminal session.
\n \n

\n
• If the Virtuoso Enterprise Edition binary cannot find a license, it will start with a restrictive courtesy license which allows limited concurrent connections and terminates the instance after 10 minutes of use.
\n
• Obtain a FREE Evaluation License via our License Generator Web Service (https://shop.openlinksw.com/license_generator/virtuoso/).
\n
• Place the resulting virtuoso.lic file in the newly created database/ directory alongside the virtuoso.ini on your local filesystem for the docker image to pick up on the next startup:\n

  $ docker cp virtuoso.lic my_virtdb:/database\n$ docker stop my_virtdb\n$ docker start my_virtdb

  \n
\n

\n
• When a new database is created, the docker image will use the Environment settings DBA_PASSWORD and DAV_PASSWORD to set passwords for the dba and dav user accounts.
\n
• If the DBA_PASSWORD environment variable is not set, a random password will be assigned to the dba user account, stored on the internal docker filesystem as /settings/dba_password.
\n
• If the DAV_PASSWORD environment variable is not set, it will be set to the DBA_PASSWORD and stored as /settings/dav_password.
\n
• These files will only be readable by the user who started the image. Use the following command to reveal the randomized passwords:\n

  $ docker exec -i -t my_virtdb cat /settings/dba_password

  \n
\n
• NOTE: Users are advised to immediately change the password and then remove this file from the filesystem.
\n

\n
• To retain changes to the Virtuoso database, the database documents should be stored on the host file system.
\n
• The docker image exposes a /database volume that can be mapped to a local directory on the filesystem. If this directory is empty, the docker image will put an initial virtuoso.ini into the mapped directory and then create a new database.
\n

\n
• When the docker image is running in foreground mode, shut down Virtuoso by pressing the CTRL and C buttons in that terminal session. Alternatively, use the following command in a different terminal:\n

  $ docker stop my_virtdb

  \n
\n

\n
• Once the docker image has been registered with the docker run or docker create command on your local system, start it in the background using:\n

  $ docker start my_virtdb

  \n
\n
• For foreground mode, use:\n

  $ docker start -i -a my_virtdb

  \n
\n

\n
• If the docker image is started in background mode, look at the recent output of the virtuoso process by running:\n

  $ docker logs my_virtdb

  \n
\n

\n
• To connect to your running Virtuoso 11 instance, use the following command:\n

  $ docker exec -i my_virtdb isql 1111

  \n
• You will be prompted for the dba account password.
\n
• NOTE: Multiple incorrect password attempts will lock the dba account for a couple of minutes.
\n \n

\n
• If the mapped directory contains a virtuoso.ini and accompanying database documents, the new docker image will attempt to use these.
\n
• NOTE: Directory paths in the virtuoso.ini should be relative to the internal directory structure of the docker image to function correctly.
\n