docker container for nuodb database

Nuodb needs some open ports:

• 48004: broker
• 48005: SM for your database
• 48006: TE for your database

If you set AUTOMATION=true

• 48007: SM for nuodb_system database
• 48008: TE for nuodb_system database

To create the image kakawait/nuodb, execute the following command:

docker build --rm -t kakawait/nuodb .

To run the image and bind to port 48004:

docker run -d -p 48004:48004 -p 48005:48005 -p 48006:48006 kakawait/nuodb

ATTENTION if you are using boot2docker please use the following command (see section Configuration -> BROKER_ALT_ADDR for more information):

docker run -d -p 48004:48004 -p 48005:48005 -p 48006:48006 -e BROKER_ALT_ADDR=<boot2docker ip> kakawait/nuodb

Where can be retrieve using boot2docker ip command. On MacOsX you can run like following:

docker run -d -p 48004:48004 -p 48005:48005 -p 48006:48006 -e BROKER_ALT_ADDR=$(boot2docker ip 2>/dev/null) kakawait/nuodb

The first time that you run your container, check the logs of the container by running:

docker logs <CONTAINER_ID>

You will see an output like the following:

========================================================================================
You can now connect to this Nuodb Server:

    domain:
    [user] domain
    [password] bird

    database [testdb]:
    [user] dba
    [password] bird
    
    Hosts:
    [broker] localhost/127.0.0.1:48004 (DEFAULT_REGION)
    
    Database: testdb
    [SM] 87ff08502c9e/192.168.59.103:48005 (DEFAULT_REGION) [ pid = 290 ] RUNNING
    [TE] 87ff08502c9e/192.168.59.103:48006 (DEFAULT_REGION) [ pid = 352 ] RUNNING
========================================================================================

Done!

• BROKER (default: true): Should this host be a broker?
• BROKER_ALT_ADDR (default: ): Specify this if you want other nodes to connect to this server at an address that is not local to the host.
• DOMAIN_USER (default: domain): The administrative user for your domain. All nodes should have the same user.
• DOMAIN_PASSWORD (default: bird): The administrative password for your domain. All nodes should have the same password. If you set value **Random** a random password will be generated.
• DBA_USER (default: dba): The administrative user for you database (see DATABASE_NAME).
• DBA_PASSWORD (default: bird): The administrative password for you database (see DATABASE_NAME). If you set value **Random** a random password will be generated.
• DATABASE_NAME (default: testdb): The database name of new database created when launching the container.
• AUTOMATION (default: false): Whether to enable automation on the system database. NuoDB manual.
• AUTOMATION_BOOTSTRAP (default: false): Should this node bootstrap the system database? See NuoDB manual.
• LOG_LEVEL (default: INFO): Valid levels are, from most to least verbose: ALL, FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE, OFF.
• LICENSE: Nuodb license to be installed.

You could override nuodb default.properties by using mounting volume:

docker run -d -p 48004:48004 -p 8080:8080 -p 8888:8888 -p 8889:8889 -v <override-dir>:/nuodb-override kakawait/nuodb

where is an absolute path of a directory that could contain:

• default.properties: custom config file

Placeholder environment variable could be used inside your overrided default.properties like following:

domainPassword = ${DOMAIN_PASSWORD}

Thus domainPassword will be equals to value of environment variable $DOMAIN_PASSWORD

If you plan to used nuodb container as remote database, for example using jdbcUrl like following:

jdbc:com.nuodb://<DOCKER_HOST_WITH_NUODBCONTAINER>/testdb

Where <DOCKER_HOST_WITH_NUODBCONTAINER> is not local address (localhost, 127.0.0.1) you must define BROKER_ALT_ADDR environment variable to be equals to <DOCKER_HOST_WITH_NUODBCONTAINER>.

Thus run container for above jdbcUrl like following:

docker run -d -p 48004:48004 -p 48005:48005 -p 48006:48006 -e BROKER_ALT_ADDR=<DOCKER_HOST_WITH_NUODBCONTAINER> kakawait/nuodb

If you are using boot2docker, you should use private network adapter to communicate with your container so please use:

docker run -d -p 48004:48004 -p 48005:48005 -p 48006:48006 -e BROKER_ALT_ADDR=$(boot2docker ip 2>/dev/null) kakawait/nuodb

In order to persist the database data, you can mount a local folder from the host on the container to store the database files. To do so:

docker run -d -p 48004:48004 -p 8080:8080 -p 8888:8888 -p 8889:8889 -v /path/in/host:/opt/nuodb/data kakawait/nuodb