How Do I Install Virtuoso Using Docker?

Step-by-step guidance to get Virtuoso running with Docker quickly.

Quick Navigation

#ImageSelection

Image Selection

#DownloadDockerImage

Download Docker Image

#CreatingaVirtuosoDockerInstance

Creating a Virtuoso Docker Instance

#Licensing

Licensing

#PasswordManagement

Password Management

#PersistentStorage

Persistent Storage

#ControlDockerImage

Control Docker Image

#Logging

Logging

#Connection

Connection

#UsinganExistingDatabase

Using an Existing Database

Docker

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#ImageSelection_SubGuide

Image Selection

1. We’ve put together three Docker Images to choose from: <ul style="padding: 1rem 0 1rem 3rem"> <li>Enterprise Edition 8.3 – <a href='https://hub.docker.com/r/openlink/virtuoso-closedsource-8/'>openlink/virtuoso-closedsource-8</a></li> <li>Enterprise Edition 7.2 – <a href='https://hub.docker.com/r/openlink/virtuoso-closedsource-7/'>openlink/virtuoso-closedsource-7</a></li><li>Open Source (“VOS”) 7.2 – <a href='https://hub.docker.com/r/openlink/virtuoso-opensource-7/'>openlink/virtuoso-opensource-7</a></li></ul> The remainder of this article is focused on Enterprise Edition 8.3.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Download_SubGuide

Download Docker Image

2. To pull the latest Virtuoso 8.2 Docker image to your local system, use the command: <pre>$ docker pull openlink/virtuoso-closedsource-8</pre>. To check the version of the Virtuoso binary, use: <pre>$ docker run openlink/virtuoso-closedsource-8 version</pre>.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Creation_SubGuide

Creating a Virtuoso Docker Instance

3. Here is a quick example of how to create a new Virtuoso instance on your system:<pre>$ mkdir my_virtdb $ cd my_virtdb $ docker run \ --name my_virtdb \ --interactive \ --tty \ --env DBA_PASSWORD=mysecret \ --publish 1111:1111 \ --publish 8890:8890 \ --volume `pwd`:/database \ openlink/virtuoso-closedsource-8:latest</pre> This will create a new Virtuoso database in the my_virtdb subdirectory and start a Virtuoso instance.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Licensing_SubGuide

Licensing

4. If the Virtuoso Enterprise Edition binary cannot find a license, it will start with a restrictive courtesy license. Obtain a FREE Evaluation License via our License Generator Web Service (<a href='https://shop.openlinksw.com/license_generator/virtuoso/'>https://shop.openlinksw.com/license_generator/virtuoso/</a>). Place the resulting virtuoso.lic file in the newly created database/ directory alongside the virtuoso.ini on your local filesystem with the commands:<pre>$ docker cp virtuoso.lic my_virtdb:/database $ docker stop my_virtdb $ docker start my_virtdb</pre>.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#PasswordManagement_SubGuide

Password Management

5. 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. If not set, random passwords are assigned and stored on the internal docker filesystem as /settings/dba_password and /settings/dav_password. Commands to reveal the passwords include:<pre>$ docker exec -i -t my_virtdb cat /settings/dba_password</pre>.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Storage_SubGuide

Persistent Storage

6. In order to retain changes to the Virtuoso database, the database documents should be stored on the host file system. The docker image exposes a /database volume that can be easily mapped to a local directory on the filesystem.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Control_SubGuide

Control Docker Image

7. When the docker image is running in foreground mode (-i or --interactive), you can shut down Virtuoso by pressing CTRL and C buttons. Alternatively, use the command:<pre>$ docker stop my_virtdb</pre>.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Control_SubGuide

Control Docker Image

8. Once the docker image has been registered with the docker run or docker create command, start it in the background using:<pre>$ docker start my_virtdb</pre> To run it in foreground mode, use:<pre>$ docker start -i -a my_virtdb</pre>.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Logging_SubGuide

Logging

9. If the docker image is started in background mode (without -i or --interactive), view the recent output of the Virtuoso process by running:<pre>$ docker logs my_virtdb</pre>.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#Connection_SubGuide

Connection

10. To connect to your running Virtuoso instance, use:<pre>$ docker exec -i my_virtdb isql 1111</pre> You will be prompted for the dba account password. Note: Multiple incorrect password attempts will lock the dba account for a couple of minutes.

http://www.openlinksw.com/DAV/virtuoso2.openlinksw.com/data/turtle/general/installation-howto-docker.ttl#ExistingDatabase_SubGuide

Using an Existing Database

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