Skip to content

Commit 42f9ca8

Browse files
authored
QA - updating versions (#188)
* QA - 24.3 modif initialization * Update examples-nosql-cluster-deployment.zip
1 parent d6dc4ad commit 42f9ca8

File tree

6 files changed

+37
-26
lines changed

6 files changed

+37
-26
lines changed

Diff for: README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ such as episodes they watched, the watch time per episode, the total number of s
145145
The data is stored in the NoSQL Database and the application performs SQL queries to retrieve the required data and make it available to the user.
146146

147147
The scripts allowing to run this tutorial are hosted in this Repository ( `AcctStreamSchema` and `BaggageSchema` ) but follow the instructions provided
148-
in the [SQL for Oracle NoSQL Database tutorial](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/nsdev/getting-started-oracle-nosql-database1.html)
148+
in the [SQL for Oracle NoSQL Database tutorial](https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/nsdev/getting-started-oracle-nosql-database1.html)
149149

150150
## Terraform Provider for Oracle Cloud Infrastructure
151151

Diff for: examples-nosql-cluster-deployment/MONITORING.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -139,11 +139,11 @@ rnTable_0.json
139139

140140
You can then Set Up a tool like Filebeat on Each Storage Node to send the JSON files to your favorite APM System (e.g ELK setup)
141141

142-
e.g. (https://docs.oracle.com/pls/topic/lookup?ctx=en/database/other-databases/nosql-database/21.1/admin&id=filebeat-yml)
142+
e.g. (https://docs.oracle.com/pls/topic/lookup?ctx=en/database/other-databases/nosql-database/24.3/nsmon&id=filebeat-yml)
143143

144144
For ELK, Oracle Nosql is providing all the configuration templates to setup the metrics and do analysis using Kibana.
145145

146-
https://docs.oracle.com/en/database/other-databases/nosql-database/21.1/admin/using-elk-monitor-oracle-nosql-database.html#GUID-A04811FD-E5FA-4149-AFBE-0E3389A1CC2D
146+
https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/nsmon/using-elk-monitor-oracle-nosql-database.html
147147

148148
If you use the template files provided above, then the following indexes are available:
149149
kvrnjvmstats-*

Diff for: examples-nosql-cluster-deployment/README.md

+32-21
Original file line numberDiff line numberDiff line change
@@ -110,8 +110,8 @@ bash clean.sh
110110
```
111111

112112
Just before starting an Oracle NoSQL installation, we recommend reading those links:
113-
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/release-notes/overview.html
114-
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/installation-prerequisites.html
113+
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/release-notes/overview.html
114+
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/installation-prerequisites.html
115115

116116
## Java Version
117117

@@ -166,7 +166,7 @@ Often physical machines and/or VMs (storage nodes) have built-in firewalls. Addi
166166
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
167167
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
168168
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.
169-
The documentation has additional [information.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/configuring-firewall.html)
169+
The documentation has additional [information.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/configuring-firewall.html)
170170

171171

172172
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
211211
- Enterprise Edition: Oracle NoSQL Database Enterprise Edition (EE) software is licensed pursuant to the Oracle commercial license
212212
- Oracle NoSQL Database Migrator: software is licensed pursuant to the Oracle UPL license
213213

214-
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)
214+
In this demo, we will use the Oracle NoSQL Database bundle - Enterprise Edition [Release 24.3](https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/release-notes/index.html)
215215

216216
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)
217217

218218
```bash
219-
unzip kv-ee-24.1.15.zip -d nosql
219+
unzip kv-ee-24.3.9.zip -d nosql
220220
unzip nosql-migrator-1.6.0.zip
221221
````
222222
223223
Modify the file `env.sh` and `env-proxy.sh` with the appropriate kvhome path location. e.g.
224224
225225
```bash
226-
export KVHOME=$HOME/nosql/kv-24.1.15
226+
export KVHOME=$HOME/nosql/kv-24.3.9
227227
```
228228
229229
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.
258258
259259
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.
260260
As a general heuristic, Replication Nodes require sufficient disk, cpu, memory, and network bandwidth to satisfy peak runtime demands.
261-
See [Initial Capacity Planning](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/initial-capacity-planning1.html) for more details.
261+
See [Initial Capacity Planning](https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/initial-capacity-planning1.html) for more details.
262262
263263
Consider the following configuration settings for Storage Nodes:
264264
- 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|
307307
308308
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`.
309309
310-
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)
310+
To learn more about it, we recommend to read this [link.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/installation-configuration-parameters.html)
311311
312312
## Deploy YOUR topology
313313
314314
315315
A topology is the collection of zones, storage nodes, shards, replication nodes, and administrative services that make up your NoSQL Database store.
316316
A deployed store has one topology that describes its state at a given time. Read this architecture section in the documentation for a detailed
317-
[description.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/concepts/architecture.html)
317+
[description.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/concepts/architecture.html)
318318
319319
Topologies can be changed to achieve different performance characteristics, or to change characteristics of the Storage Nodes.
320320
Changing and deploying a topology is an iterative process.
@@ -336,14 +336,14 @@ file|topology|nodes needed|
336336
337337
For information on how to use the command line interface to create, transform, view, validate and preview
338338
a topology, see the following chapters in the Administrator's Guide.
339-
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/name-your-data-store.html
340-
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/steps-changing-stores-topology.html
341-
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/using-plans.html
339+
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/name-your-data-store.html
340+
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/steps-changing-stores-topology.html
341+
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/using-plans.html
342342
343343
344344
## Create users
345345
346-
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.
346+
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.3/security/password-complexity-policies.html) The following users need to be created: root, proxy and application.
347347
- Create the `root` user and the file `root.login` that contain property settings for the login as admin
348348
- Create the `proxy_user` user and the file proxy.login that contain property settings for the login as `proxy_user` user
349349
- 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
365365
```
366366
367367
To learn more, we recommend reading:
368-
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/security/configuring-authentication.html
369-
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/security/configuring-authorization.html
368+
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/security/configuring-authentication.html
369+
- https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/security/configuring-authorization.html
370370
371371
## Validate your deployment
372372
@@ -446,7 +446,7 @@ pkill -f httpproxy.jar
446446
```
447447
448448
449-
To learn more, we recommend [reading.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.1/admin/configuring-proxy.html)
449+
To learn more, we recommend [reading.](https://docs.oracle.com/en/database/other-databases/nosql-database/24.3/admin/configuring-proxy.html)
450450
451451
### Test using the Oracle NoSQL SDK for Java examples
452452
@@ -509,7 +509,7 @@ The following error can be safely ignored when running the command `bash stop.sh
509509
510510
````bash
511511
$ bash stop.sh
512-
24.1.15 2024-04-11 20:02:19 UTC Build id: e0c93c1f1395 Edition: Client
512+
24.3.9 2024-09-26 18:00:26 UTC Build id: 0d82533c492e Edition: Client
513513
Failed to stop SNA: Bootstrap config file /home/opc/nosql/kvroot/config.xml does not exist
514514
````
515515
@@ -522,7 +522,8 @@ The following error happen when trying to start the proxy and it is already runn
522522
523523
````bash
524524
$ kv_proxy
525-
Proxy started:
525+
Starting Proxy
526+
Failed to start proxy: java.lang.RuntimeException: Unable to start proxy: Address already in use. Configuration used:
526527
async=false
527528
helperHosts=node1-nosql:5000
528529
httpPort=8080
@@ -538,9 +539,6 @@ proxyType=KVPROXY
538539
sslProtocols=TLSv1.2,TLSv1.1,TLSv1
539540
storeName=OUG
540541
verbose=true
541-
proxyVersion=null
542-
kvclientVersion=24.1.15
543-
544542
545543
at oracle.nosql.proxy.Proxy.start(Proxy.java:386)
546544
at oracle.nosql.proxy.Proxy.initialize(Proxy.java:293)
@@ -554,6 +552,19 @@ Caused by: java.net.BindException: Address already in use
554552
at io.netty.channel.socket.nio.NioServerSocketChannel.doBind(NioServerSocketChannel.java:141)
555553
at io.netty.channel.AbstractChannel$AbstractUnsafe.bind(AbstractChannel.java:562)
556554
at io.netty.channel.DefaultChannelPipeline$HeadContext.bind(DefaultChannelPipeline.java:1334)
555+
at io.netty.channel.AbstractChannelHandlerContext.invokeBind(AbstractChannelHandlerContext.java:600)
556+
at io.netty.channel.AbstractChannelHandlerContext.bind(AbstractChannelHandlerContext.java:579)
557+
at io.netty.channel.DefaultChannelPipeline.bind(DefaultChannelPipeline.java:973)
558+
at io.netty.channel.AbstractChannel.bind(AbstractChannel.java:260)
559+
at io.netty.bootstrap.AbstractBootstrap$2.run(AbstractBootstrap.java:380)
560+
at io.netty.util.concurrent.AbstractEventExecutor.runTask(AbstractEventExecutor.java:173)
561+
at io.netty.util.concurrent.AbstractEventExecutor.safeExecute(AbstractEventExecutor.java:166)
562+
at io.netty.util.concurrent.SingleThreadEventExecutor.runAllTasks(SingleThreadEventExecutor.java:470)
563+
at io.netty.channel.nio.NioEventLoop.run(NioEventLoop.java:569)
564+
at io.netty.util.concurrent.SingleThreadEventExecutor$4.run(SingleThreadEventExecutor.java:997)
565+
at io.netty.util.internal.ThreadExecutorMap$2.run(ThreadExecutorMap.java:74)
566+
at io.netty.util.concurrent.FastThreadLocalRunnable.run(FastThreadLocalRunnable.java:30)
567+
at java.base/java.lang.Thread.run(Thread.java:833)
557568
558569
````
559570

Diff for: examples-nosql-cluster-deployment/script/env-proxy.sh

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Copyright (c) 2023, 2024 Oracle and/or its affiliates.
44
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
55

6-
export KVHOME=$HOME/nosql/kv-24.1.15
6+
export KVHOME=$HOME/nosql/kv-24.3.9
77
export KVHOST=`hostname`
88
export KVSTORE=OUG
99
export PROXYHOME=/home/opc/proxy

Diff for: examples-nosql-cluster-deployment/script/env.sh

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Copyright (c) 2023, 2024 Oracle and/or its affiliates.
44
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
55

6-
export KVHOME=$HOME/nosql/kv-24.1.15
6+
export KVHOME=$HOME/nosql/kv-24.3.9
77

88
export KVROOT=$HOME/nosql/kvroot
99
export KVDATA=$HOME/nosql/data

Diff for: zips/examples-nosql-cluster-deployment.zip

204 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)