🐳 Regression: Oracle NoSQL Docker image no longer works with single docker run command

[otaviojava]

Description:

Previously, we could run a local Oracle NoSQL instance quickly using a single Docker command. This was extremely helpful for local development and trying out NoSQL features before using the cloud service.

The original command worked flawlessly:

docker run -d --name oracle-instance -p 8080:8080 ghcr.io/oracle/nosql:latest-ce

However, with recent changes, this command no longer starts the service correctly.

Steps to Reproduce:

1. Run the following command (as per previous working usage):

   docker run -d --name oracle-instance -p 8080:8080 ghcr.io/oracle/nosql:latest-ce

2. Notice that the container does not start properly or does not expose the expected service on http://localhost:8080.

3. Tried the updated version from the [official README](https://github.com/oracle/docker-images/blob/main/NoSQL/README.md):

   docker run -d --name kvlite --hostname=kvlite --env KV_PROXY_PORT=8080 -p 8080:8080 ghcr.io/oracle/nosql:latest-ce

4. Still does not respond or expose the expected proxy endpoint.

Expected Behavior:
A local instance should be accessible via a simple Docker command, as before. This makes it easy for developers to test Oracle NoSQL locally before integrating with cloud services.

Actual Behavior:
The Docker container starts (in some cases), but no service is available on port 8080. The original convenience of quick start via a single command has been broken.

Why This Matters:

The ability to spin up a local NoSQL instance with a one-liner Docker command is essential for:

• Developer productivity
• Prototyping
• Education and demos
• Lowering the barrier for adoption

It might be related to this bug as well:

#2972

[dario-vega]

I am running the commands you are providing, and it works

docker run -d --name oracle-instance -p 8080:8080 ghcr.io/oracle/nosql:latest-ce
26ed7efecd8a8fa9a3abee3410947ec90d02d621a2edf2774192067ff5227a94

Validating the kvlite and the proxy started

$ docker logs oracle-instance
Waiting for kvstore to start...
SLF4J(W): No SLF4J providers were found.
SLF4J(W): Defaulting to no-operation (NOP) logger implementation
SLF4J(W): See https://www.slf4j.org/codes.html#noProviders for further details.
Waiting for kvstore to start...
Created new kvlite store with args:
-root /kvroot -store kvstore -host 26ed7efecd8a -port 5000 -admin-web-port 5999 -secure-config disable
Starting Proxy
Proxy started:
async=false
helperHosts=26ed7efecd8a:5000
httpPort=8080
httpsPort=0
idleReadTimeout=0
kvConsistency=NONE_REQUIRED
kvDurability=COMMIT_NO_SYNC
kvRequestLimit=-1
kvRequestTimeout=-1
monitorStatsEnabled=false
numAcceptThreads=3
numRequestThreads=32
proxyType=KVPROXY
sslProtocols=TLSv1.2,TLSv1.1,TLSv1
storeName=kvstore
verbose=true
proxyVersion=null
kvclientVersion=24.4.9

Validating the communication intra containers - printing the version, the current tables

$ docker run --rm -ti --link oracle-instance:store oracle/nosql:ce  java -Xmx64m -Xms64m -jar lib/kvstore.jar version
24.4.9 2024-11-21 17:06:06 UTC  Build id: 95fa28ea4441 Edition: Community

$ docker run --rm -ti --link oracle-instance:store oracle/nosql:ce   java -jar lib/sql.jar -helper-hosts store:5000 -store kvstore show tables
tables
  SYS$IndexStatsLease
  SYS$MRTableAgentStat
  SYS$MRTableInfo
  SYS$MRTableInitCheckpoint
  SYS$PartitionStatsLease
  SYS$SGAttributesTable
  SYS$StreamRequest
  SYS$StreamResponse
  SYS$TableMetadata
  SYS$TableStatsIndex
  SYS$TableStatsPartition
  SYS$TopologyHistory

Validating that port 8080 is exposed and working

$ docker ps
CONTAINER ID        IMAGE                            COMMAND                  CREATED             STATUS              PORTS                    NAMES
81aba7826af3        ghcr.io/oracle/nosql:latest-ce   "bash -c ./start-kvl…"   43 seconds ago      Up 42 seconds       0.0.0.0:8080->8080/tcp   oracle-instance

$ sudo netstat -antpl  | grep 8080
tcp6       0      0 :::8080                 :::*                    LISTEN      31670/docker-proxy

Download, unzip NoSQL SDK for Java and compile the NoSQL SDK for Java examples. We will use java programs to test the configuration. Other language SDKs are available which you can use, however, we are providing Java examples.

cd $HOME
rm -rf oracle-nosql-java-sdk-5.4.17.zip oracle-nosql-java-sdk
curl -L https://github.com/oracle/nosql-java-sdk/releases/download/v5.4.17/oracle-nosql-java-sdk-5.4.17.zip \
-o oracle-nosql-java-sdk-5.4.17.zip
unzip oracle-nosql-java-sdk-5.4.17.zip
cd oracle-nosql-java-sdk/examples/
javac -cp ../lib/nosqldriver.jar *.java
cd $HOME

Test using the example provided in the Oracle NoSQL SDK

$ cd $HOME/oracle-nosql-java-sdk/examples/
$ java -cp .:../lib/nosqldriver.jar  BasicTableExample http://localhost:8080 -useKVProxy

Creating table audienceData
Created table audienceData
Put row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}} result=non-null Version
Got row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}}
Inserted row via query, result:
        {"NumRowsInserted":1}
Got row inserted by query: {"cookie_id":106,"audience_data":{"audience_segment":{"foodie":"2020-06-01","sports_lover":"2020-05-10"},"ipaddr":"10.0.00.xxx"}}
Put row from json: {"cookie_id":456,"audience_data":{"ipaddr":"10.0.00.yyy","audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"}}}
Got row inserted as JSON: {"cookie_id":456,"audience_data":{"audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"},"ipaddr":"10.0.00.yyy"}}
Query results for SELECT * from audienceData WHERE cookie_id = 456:
        {"cookie_id":456,"audience_data":{"audience_segment":{"foodie":"2018-12-31","sports_lover":"2019-01-05"},"ipaddr":"10.0.00.yyy"}}
Deleted key {"cookie_id":456} result=true
Dropping table audienceData

$ cd -

Could you validate the same steps?

[dario-vega]

NB: It is not related to #2972 - not the same product.

[otaviojava]

@dario-vega

I believe your lastest is deprecated, please, delete and try again.

Checking at the database logs:

2025-05-20 19:46:58 #
2025-05-20 19:46:58 # A fatal error has been detected by the Java Runtime Environment:
2025-05-20 19:46:58 #
2025-05-20 19:46:58 #  SIGILL (0x4) at pc=0x0000ffff7aab379c, pid=7, tid=9
2025-05-20 19:46:58 #
2025-05-20 19:46:58 # JRE version:  (21.0.2+13) (build )
2025-05-20 19:46:58 # Java VM: OpenJDK 64-Bit Server VM (21.0.2+13-jvmci-23.1-b30, mixed mode, sharing, tiered, jvmci, jvmci compiler, compressed oops, compressed class ptrs, g1 gc, linux-aarch64)
2025-05-20 19:46:58 # Problematic frame:
2025-05-20 19:46:58 # j  java.lang.System.registerNatives()V+0 java.base
2025-05-20 19:46:58 #
2025-05-20 19:46:58 # No core dump will be written. Core dumps have been disabled. To enable core dumping, try "ulimit -c unlimited" before starting Java again
2025-05-20 19:46:58 #
2025-05-20 19:46:58 # An error report file with more information is saved as:
2025-05-20 19:46:58 # /app/kv-24.4.9/hs_err_pid7.log
2025-05-20 19:46:58 [0.013s][warning][os] Loading hsdis library failed
2025-05-20 19:46:58 #
2025-05-20 19:46:58 # The crash happened outside the Java Virtual Machine in native code.
2025-05-20 19:46:58 # See problematic frame for where to report the bug.
2025-05-20 19:46:58 #
2025-05-20 19:46:58 Waiting for kvstore to start...
2025-05-20 19:46:59 Waiting for kvstore to start...
2025-05-20 19:47:00 Waiting for kvstore to start...
2025-05-20 19:47:01 Waiting for kvstore to start...
2025-05-20 19:46:58 ./start-kvlite.sh: line 12:     7 Aborted                 java -jar lib/kvstore.jar kvlite -secure-config disable -root /kvroot -host "$HOSTNAME" -port "$KV_PORT" -admin-web-port "$KV_ADMIN_PORT" -harange "${KV_HARANGE/\-/\,}" -servicerange "${KV_SERVICERANGE/\-/\,}" -storagedirsizegb "${KV_STORAGESIZE-10}"
2025-05-20 19:46:58 ./start-kvlite.sh: line 12:     8 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:46:59 ./start-kvlite.sh: line 12:    26 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:00 ./start-kvlite.sh: line 12:    36 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:01 ./start-kvlite.sh: line 12:    46 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:02 Waiting for kvstore to start...
2025-05-20 19:47:02 ./start-kvlite.sh: line 12:    56 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:03 Waiting for kvstore to start...
2025-05-20 19:47:03 ./start-kvlite.sh: line 12:    66 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:04 Waiting for kvstore to start...
2025-05-20 19:47:04 ./start-kvlite.sh: line 12:    76 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:05 ./start-kvlite.sh: line 12:    86 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:05 Waiting for kvstore to start...
2025-05-20 19:47:06 ./start-kvlite.sh: line 12:    96 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:06 Waiting for kvstore to start...
2025-05-20 19:47:07 ./start-kvlite.sh: line 12:   106 Aborted                 java -jar lib/kvstore.jar ping -host "$HOSTNAME" -port "$KV_PORT" > /dev/null 2>&1
2025-05-20 19:47:07 Waiting for kvstore to start...
2025-05-20 19:47:08 ./start-kvlite.sh: line 12:   116 A

My image is is: 62f036d43a98 created 2 months ago.

[dario-vega]

As you can see in the latest Pull Request #2944, there is also a difference between the Java version used.

Using ghcr.io/graalvm/jdk-community:21 instead of ghcr.io/graalvm/jdk:ol9-java17

It seems to be related to the new Java version - https://bugs.openjdk.org/browse/JDK-8343751 in some platforms.

Could you test if you have the issue using [2024-12-ce] instead of [2025-03-ce] [latest-ce]?

Test with docker pull ghcr.io/oracle/nosql:latest-ce and docker pull ghcr.io/oracle/nosql:2024-12-ce?

Or just let me know what happen if you run

docker run --rm -ti ghcr.io/oracle/nosql:latest-ce java -version
and
docker run --rm -ti ghcr.io/oracle/nosql:2024-12-ce java -version

Thanks @otaviojava for your help

[otaviojava]

@dario-vega it worked, but my current code stopped working, for example:

QUERY: Unexpected exception: java.lang.IllegalStateException: Invalid partition id in continuation key: 1 (5.4.17)

Executing this query:

select * from machines WHERE machines.entity= 'Car'

[dario-vega]

@otaviojava, when you say it is working, do you mean using ghcr.io/oracle/nosql:2024-12-ce or ghcr.io/oracle/nosql:latest-ce?

I will create a new version using the previous version of Java, and then we can see other issues

[otaviojava]

I said using: ghcr.io/oracle/nosql:2024-12-ce the lastest does not work.

[dario-vega]

See oracle/graal#11057

The latest Docker for Desktop (4.39.0+) has addressed their bug so older unpatched JVM versions also do not produce the error.