diff --git a/examples-nosql-cluster-deployment/README.md b/examples-nosql-cluster-deployment/README.md index 91fdc65..0e27dac 100644 --- a/examples-nosql-cluster-deployment/README.md +++ b/examples-nosql-cluster-deployment/README.md @@ -30,7 +30,7 @@ In the examples in this repository, we will use the default configuration, which The code in this repository was used in **Getting started with an Oracle NoSQL** workshops showcased in NoSQL events around the world. -To learn more about the **Oracle NoSQL Concepts**, we recommend reading this [documentation.](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/concepts/index.html) +To learn more about the **Oracle NoSQL Concepts**, we recommend reading this [documentation.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/concepts/index.html) For those of you that prefer a fully serverless managed service - learn more **Oracle NoSQL Database Cloud Service** [here.](https://www.oracle.com/database/nosql/) @@ -110,8 +110,8 @@ bash clean.sh ``` Just before starting an Oracle NoSQL installation, we recommend reading those links: -- https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/release-notes/overview.html -- https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/installation-prerequisites.html +- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/release-notes/overview.html +- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/installation-prerequisites.html ## Java Version @@ -166,7 +166,7 @@ Often physical machines and/or VMs (storage nodes) have built-in firewalls. Addi the storage nodes need to communicate with one another, so communication must pass through the firewalls. Open the firewall ports used by the communication channels in the NoSQL Cluster. To make sure your network firewall works with your topology, you should set the ports specified by the `-port`, `-harange`, `-servicerange`, and `-admin-web-port` parameters of the `makebootconfig` command (see section: Configure and start a set of storage Nodes). This parameter is used to constraint a store to a limited set of ports, usually for security or data center policy reasons. By **default** the services use anonymous ports. Refer to your network administrator. -The documentation has additional [information.](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/configuring-firewall.html) +The documentation has additional [information.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/configuring-firewall.html) e.g VMs in Oracle OCI are configured with a Linux firewall. For demo purposes, we will stop the firewall in all the VMs. @@ -211,19 +211,19 @@ Download the [Oracle NoSQL Database bundle](https://www.oracle.com/database/tech - Enterprise Edition: Oracle NoSQL Database Enterprise Edition (EE) software is licensed pursuant to the Oracle commercial license - Oracle NoSQL Database Migrator: software is licensed pursuant to the Oracle UPL license -In this demo, we will use the Oracle NoSQL Database bundle - Enterprise Edition [Release 23.3](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/release-notes/index.html) +In this demo, we will use the Oracle NoSQL Database bundle - Enterprise Edition [Release 24.1](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/release-notes/index.html) For more information about difference between versions (CE vs EE) and other topics, visit the [FAQ](https://www.oracle.com/database/technologies/nosqldb-learnmore-nosqldb-faq.html) ```bash -unzip kv-ee-23.3.32.zip -d nosql -unzip nosql-migrator-1.5.0.zip +unzip kv-ee-24.1.15.zip -d nosql +unzip nosql-migrator-1.6.0.zip ```` Modify the file `env.sh` and `env-proxy.sh` with the appropriate kvhome path location. e.g. ```bash -export KVHOME=$HOME/nosql/kv-23.3.32 +export KVHOME=$HOME/nosql/kv-24.1.15 ``` 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 @@ -258,7 +258,7 @@ Note: you can use those scripts as templates to create your own. If the Storage Node you are configuring has the resources to support more than a one Replication Node, set the capacity value to the appropriate number. As a general heuristic, Replication Nodes require sufficient disk, cpu, memory, and network bandwidth to satisfy peak runtime demands. -See [Initial Capacity Planning](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/initial-capacity-planning1.html) for more details. +See [Initial Capacity Planning](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/initial-capacity-planning1.html) for more details. Consider the following configuration settings for Storage Nodes: - We recommend configuring each Storage Node with a capacity equal to the number of available disks on the machine. This permits a disk for each Replication Node, ensuring that Replication Nodes on the Storage Node are not competing for I/O resources. The `–storagedir` parameter lets you specify the directory location for each Replication Node disk. @@ -307,14 +307,14 @@ First node | Other nodes| Topologies can be modified to change the characteristics of the Storage Nodes. In one of the scenarios, we will show how to change the capacity. We will setup all the Storage nodes of our cluster with `capacity = 1`, then we will change all Storage nodes to `capacity = 3`. -To learn more about it, we recommend to read this [link.](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/installation-configuration-parameters.html) +To learn more about it, we recommend to read this [link.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/installation-configuration-parameters.html) ## Deploy YOUR topology A topology is the collection of zones, storage nodes, shards, replication nodes, and administrative services that make up your NoSQL Database store. A deployed store has one topology that describes its state at a given time. Read this architecture section in the documentation for a detailed -[description.](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/concepts/architecture.html) +[description.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/concepts/architecture.html) Topologies can be changed to achieve different performance characteristics, or to change characteristics of the Storage Nodes. Changing and deploying a topology is an iterative process. @@ -336,14 +336,14 @@ file|topology|nodes needed| For information on how to use the command line interface to create, transform, view, validate and preview a topology, see the following chapters in the Administrator's Guide. -- https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/name-your-data-store.html -- https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/steps-changing-stores-topology.html -- https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/using-plans.html +- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/name-your-data-store.html +- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/steps-changing-stores-topology.html +- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/using-plans.html ## Create users -In this step, we will create the initial users with [password complexity policy enabled.](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/security/password-complexity-policies.html) The following users need to be created: root, proxy and application. +In this step, we will create the initial users with [password complexity policy enabled.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/security/password-complexity-policies.html) The following users need to be created: root, proxy and application. - Create the `root` user and the file `root.login` that contain property settings for the login as admin - Create the `proxy_user` user and the file proxy.login that contain property settings for the login as `proxy_user` user - Password for `root` and `proxy_user` are generated randomly using `openssl` tool and stored in a wallet @@ -365,8 +365,8 @@ bash create-users.sh ``` To learn more, we recommend reading: -- https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/security/configuring-authentication.html -- https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/security/configuring-authorization.html +- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/security/configuring-authentication.html +- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/security/configuring-authorization.html ## Validate your deployment @@ -446,7 +446,7 @@ pkill -f httpproxy.jar ``` -To learn more, we recommend [reading.](https://docs.oracle.com/en/database/other-databases/nosql-database/23.3/admin/configuring-proxy.html) +To learn more, we recommend [reading.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/configuring-proxy.html) ### Test using the Oracle NoSQL SDK for Java examples @@ -509,7 +509,7 @@ The following error can be safely ignored when running the command `bash stop.sh ````bash $ bash stop.sh -23.3.32 2024-03-06 18:21:38 UTC Build id: 69f48431fc69 Edition: Client +24.1.15 2024-04-11 20:02:19 UTC Build id: e0c93c1f1395 Edition: Client Failed to stop SNA: Bootstrap config file /home/opc/nosql/kvroot/config.xml does not exist ```` @@ -522,8 +522,7 @@ The following error happen when trying to start the proxy and it is already runn ````bash $ kv_proxy -Starting Proxy -Failed to start proxy: java.lang.RuntimeException: Unable to start proxy: Address already in use. Configuration used: +Proxy started: async=false helperHosts=node1-nosql:5000 httpPort=8080 @@ -539,16 +538,23 @@ proxyType=KVPROXY sslProtocols=TLSv1.2,TLSv1.1,TLSv1 storeName=OUG verbose=true +proxyVersion=null +kvclientVersion=24.1.15 - at oracle.nosql.proxy.Proxy.start(Proxy.java:345) - at oracle.nosql.proxy.Proxy.initialize(Proxy.java:252) - at oracle.nosql.proxy.ProxyMain.startProxy(ProxyMain.java:193) - at oracle.nosql.proxy.ProxyMain.main(ProxyMain.java:51) + + at oracle.nosql.proxy.Proxy.start(Proxy.java:386) + at oracle.nosql.proxy.Proxy.initialize(Proxy.java:293) + at oracle.nosql.proxy.ProxyMain.startProxy(ProxyMain.java:227) + at oracle.nosql.proxy.ProxyMain.main(ProxyMain.java:53) Caused by: java.net.BindException: Address already in use - at sun.nio.ch.Net.bind0(Native Method) - at sun.nio.ch.Net.bind(Net.java:438) - at sun.nio.ch.Net.bind(Net.java:430) - at sun.nio.ch.ServerSocketChannelImpl.bind(ServerSocketChannelImpl.java:225) + at java.base/sun.nio.ch.Net.bind0(Native Method) + at java.base/sun.nio.ch.Net.bind(Net.java:555) + at java.base/sun.nio.ch.ServerSocketChannelImpl.netBind(ServerSocketChannelImpl.java:337) + at java.base/sun.nio.ch.ServerSocketChannelImpl.bind(ServerSocketChannelImpl.java:294) + at io.netty.channel.socket.nio.NioServerSocketChannel.doBind(NioServerSocketChannel.java:141) + at io.netty.channel.AbstractChannel$AbstractUnsafe.bind(AbstractChannel.java:562) + at io.netty.channel.DefaultChannelPipeline$HeadContext.bind(DefaultChannelPipeline.java:1334) + ```` diff --git a/examples-nosql-cluster-deployment/script/env-proxy.sh b/examples-nosql-cluster-deployment/script/env-proxy.sh index 663fea6..d7fcd85 100644 --- a/examples-nosql-cluster-deployment/script/env-proxy.sh +++ b/examples-nosql-cluster-deployment/script/env-proxy.sh @@ -3,7 +3,7 @@ # Copyright (c) 2023, 2024 Oracle and/or its affiliates. # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/ -export KVHOME=$HOME/nosql/kv-23.3.32 +export KVHOME=$HOME/nosql/kv-24.1.15 export KVHOST=`hostname` export KVSTORE=OUG export PROXYHOME=/home/opc/proxy diff --git a/examples-nosql-cluster-deployment/script/env.sh b/examples-nosql-cluster-deployment/script/env.sh index 4cd8210..fa09081 100644 --- a/examples-nosql-cluster-deployment/script/env.sh +++ b/examples-nosql-cluster-deployment/script/env.sh @@ -3,7 +3,7 @@ # Copyright (c) 2023, 2024 Oracle and/or its affiliates. # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/ -export KVHOME=$HOME/nosql/kv-23.3.32 +export KVHOME=$HOME/nosql/kv-24.1.15 export KVROOT=$HOME/nosql/kvroot export KVDATA=$HOME/nosql/data diff --git a/zips/examples-nosql-cluster-deployment.zip b/zips/examples-nosql-cluster-deployment.zip index 18477dd..99bc629 100644 Binary files a/zips/examples-nosql-cluster-deployment.zip and b/zips/examples-nosql-cluster-deployment.zip differ