From 6cf0dd330c789e892b8f27130e7c3cfb750f4515 Mon Sep 17 00:00:00 2001 From: Oliver Howell Date: Thu, 19 Dec 2024 17:43:13 +0000 Subject: [PATCH] Update for os variable (#1447) --- .../pages/install-hazelcast.adoc | 94 +++---------------- 1 file changed, 15 insertions(+), 79 deletions(-) diff --git a/docs/modules/getting-started/pages/install-hazelcast.adoc b/docs/modules/getting-started/pages/install-hazelcast.adoc index 068e9d4b6..e5e60edc0 100644 --- a/docs/modules/getting-started/pages/install-hazelcast.adoc +++ b/docs/modules/getting-started/pages/install-hazelcast.adoc @@ -20,7 +20,7 @@ You must use one of the following installation methods if you want to install th * <> * <> -To install a slim distribution, append `-slim` to the version number in the commands shown in the following sections; for example, to install the slim distribution of {full-version}, use `{full-version}-slim`. +To install a slim distribution, append `-slim` to the version number in the commands shown in the following sections; for example, to install the slim distribution of {os-version}, use `{os-version}-slim`. == Using a Package Manager @@ -38,23 +38,13 @@ Mac:: -- To install on macOS, use the Homebrew package manager. -ifdef::snapshot[] [source,bash,subs="attributes+"] ---- brew tap hazelcast/hz -brew install hazelcast@{version-brew} +brew install hazelcast@{os-version} ---- -endif::[] - -ifndef::snapshot[] -[source,bash,subs="attributes+"] ----- -brew tap hazelcast/hz -brew install hazelcast@{full-version} ----- -endif::[] -- Linux:: @@ -63,43 +53,23 @@ Linux:: . Check that you have the GNU Wget package installed. You'll use Wget to download the GPG keys for the Hazelcast package. + -```bash +[source,bash] +---- wget -V -``` +---- + If you do not see a version number, download and install link:https://www.gnu.org/software/wget/[Wget^]. + . Use either of these package managers to install Hazelcast, depending on your Linux distribution: + -ifdef::snapshot[] - .Debian -[source,shell] ----- -wget -qO - https://repository.hazelcast.com/api/gpg/key/public | gpg --dearmor | sudo tee /usr/share/keyrings/hazelcast-archive-keyring.gpg > /dev/null -echo "deb [signed-by=/usr/share/keyrings/hazelcast-archive-keyring.gpg] https://repository.hazelcast.com/debian snapshot main" | sudo tee -a /etc/apt/sources.list -sudo apt update && sudo apt install hazelcast ----- -+ -.RPM -[source,shell] ----- -wget https://repository.hazelcast.com/rpm/snapshot/hazelcast-rpm.repo -O hazelcast-snapshot-rpm.repo -sudo mv hazelcast-snapshot-rpm.repo /etc/yum.repos.d/ -sudo yum install hazelcast ----- -+ -endif::[] -+ -ifndef::snapshot[] -.Debian [source,shell,subs="attributes+"] ---- wget -qO - https://repository.hazelcast.com/api/gpg/key/public | gpg --dearmor | sudo tee /usr/share/keyrings/hazelcast-archive-keyring.gpg > /dev/null echo "deb [signed-by=/usr/share/keyrings/hazelcast-archive-keyring.gpg] https://repository.hazelcast.com/debian stable main" | sudo tee -a /etc/apt/sources.list -sudo apt update && sudo apt install hazelcast={full-version} +sudo apt update && sudo apt install hazelcast={os-version} ---- + .RPM @@ -107,10 +77,9 @@ sudo apt update && sudo apt install hazelcast={full-version} ---- wget https://repository.hazelcast.com/rpm/stable/hazelcast-rpm-stable.repo -O hazelcast-rpm-stable.repo sudo mv hazelcast-rpm-stable.repo /etc/yum.repos.d/ -sudo yum install hazelcast-{full-version} +sudo yum install hazelcast-{os-version} ---- + -endif::[] -- Windows:: + @@ -160,30 +129,20 @@ Download the latest snapshot archive and extract the binaries. Mac:: + -- -ifdef::snapshot[] -Go to the link:https://oss.sonatype.org/content/repositories/snapshots/com/hazelcast/hazelcast-distribution/{full-version}/[snapshot repository] and click the download link for the TAR file that has the most up-to-date timestamp in the *Last Modified* columns. -endif::[] -ifndef::snapshot[] -. Download a package from https://hazelcast.com/get-started/download/[hazelcast.com^]. +. Download a package from https://hazelcast.com/get-started/download/?utm_source=docs-website[hazelcast.com^]. . Extract the downloaded package. -endif::[] -- Linux:: + -- -. Download a package from https://hazelcast.com/get-started/download/[hazelcast.com^]. +. Download a package from https://hazelcast.com/get-started/download/?utm_source=docs-website[hazelcast.com^]. . Extract the downloaded package. -- Windows:: + -- -ifdef::snapshot[] -Go to the link:https://oss.sonatype.org/content/repositories/snapshots/com/hazelcast/hazelcast-distribution/{full-version}/[snapshot repository] and click the download link for the ZIP file that has the most up-to-date timestamp in the *Last Modified* columns. -endif::[] -ifndef::snapshot[] -. Download a package from https://hazelcast.com/get-started/download/[hazelcast.com^]. +. Download a package from https://hazelcast.com/get-started/download/?utm_source=docs-website[hazelcast.com^]. . Extract the downloaded package. -endif::[] -- ==== // end::binary[] @@ -214,41 +173,18 @@ The Java package includes both a member API and a Java client API. The member AP + -- // tag::maven-full[] -ifdef::snapshot[] -[source,xml,subs="attributes+"] ----- - - - snapshot-repository - Maven2 Snapshot Repository - https://oss.sonatype.org/content/repositories/snapshots - - false - - - - - - com.hazelcast - hazelcast - {full-version} - - ----- -endif::[] -ifndef::snapshot[] [source,xml,subs="attributes+"] ---- com.hazelcast hazelcast - {full-version} + {os-version} ---- -endif::[] + // end::maven-full[] -- @@ -272,7 +208,7 @@ endif::[] You can use Hazelcast as a module in the http://openjdk.java.net/projects/jigsaw/[Java Platform Module System] (JPMS). To run your application with Hazelcast -libraries on the modulepath, use the `com.hazelcast.core` for `hazelcast-{full-version}.jar` module name. +libraries on the modulepath, use the `com.hazelcast.core` for `hazelcast-{os-version}.jar` module name. The JPMS comes with stricter visibility rules. It affects Hazelcast which uses the internal Java API to reach the best performance results. @@ -302,7 +238,7 @@ java --add-modules java.se \ --add-opens java.management/sun.management=ALL-UNNAMED \ --add-opens jdk.management/com.ibm.lang.management.internal=ALL-UNNAMED \ --add-opens jdk.management/com.sun.management.internal=ALL-UNNAMED \ - -jar hazelcast-{full-version}.jar + -jar hazelcast-{os-version}.jar ---- .Running a Member on the Modulepath @@ -319,7 +255,7 @@ java --add-modules java.se \ --module-path lib \ <1> --module com.hazelcast.core/com.hazelcast.core.server.HazelcastMemberStarter ---- -<1> This example expects the `hazelcast-{full-version}.jar` file in the `lib` directory. +<1> This example expects the `hazelcast-{os-version}.jar` file in the `lib` directory. // end::modular[]