@@ -12,61 +12,68 @@ Requirements
1212- Windows, Linux/UNIX or Mac OS X
1313- Python 2.7 or Python 3.4 or newer
1414- Java 8 or newer
15- - Hazelcast IMDG 4.0 or newer
15+ - Hazelcast 4.0 or newer
1616- Latest Hazelcast Python client
1717
18- Working with Hazelcast IMDG Clusters
19- ------------------------------------
18+ Working with Hazelcast Clusters
19+ -------------------------------
2020
21- Hazelcast Python client requires a working Hazelcast IMDG cluster to
21+ Hazelcast Python client requires a working Hazelcast cluster to
2222run. This cluster handles storage and manipulation of the user data.
23- Clients are a way to connect to the Hazelcast IMDG cluster and access
23+ Clients are a way to connect to the Hazelcast cluster and access
2424such data.
2525
26- Hazelcast IMDG cluster consists of one or more cluster members. These
26+ Hazelcast cluster consists of one or more cluster members. These
2727members generally run on multiple virtual or physical machines and are
2828connected to each other via network. Any data put on the cluster is
2929partitioned to multiple members transparent to the user. It is therefore
3030very easy to scale the system by adding new members as the data grows.
31- Hazelcast IMDG cluster also offers resilience. Should any hardware or
31+ Hazelcast cluster also offers resilience. Should any hardware or
3232software problem causes a crash to any member, the data on that member
3333is recovered from backups and the cluster continues to operate without
3434any downtime. Hazelcast clients are an easy way to connect to a
35- Hazelcast IMDG cluster and perform tasks on distributed data structures
35+ Hazelcast cluster and perform tasks on distributed data structures
3636that live on the cluster.
3737
3838In order to use Hazelcast Python client, we first need to setup a
39- Hazelcast IMDG cluster.
39+ Hazelcast cluster.
4040
41- Setting Up a Hazelcast IMDG Cluster
42- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41+ Setting Up a Hazelcast Cluster
42+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4343
44- There are following options to start a Hazelcast IMDG cluster easily:
44+ There are following options to start a Hazelcast cluster easily:
4545
46- - You can run standalone members by downloading and running JAR files
47- from the website.
48- - You can embed members to your Java projects.
4946- You can use our `Docker
5047 images <https://hub.docker.com/r/hazelcast/hazelcast/> `__.
5148
52- We are going to download JARs from the website and run a standalone
53- member for this guide.
49+ .. code :: bash
50+
51+ docker run -p 5701:5701 hazelcast/hazelcast:5.0
52+
53+ - You can use `Hazelcast CLI
54+ <https://docs.hazelcast.com/hazelcast/latest/getting-started/install-hazelcast#using-a-package-manager> `__.
55+ - You can run standalone members by downloading and running distribution
56+ files from the website.
57+ - You can embed members to your Java projects.
58+
59+ We are going to download distribution files from the website and run
60+ a standalone member for this guide.
5461
5562Running Standalone JARs
5663^^^^^^^^^^^^^^^^^^^^^^^
5764
58- Follow the instructions below to create a Hazelcast IMDG cluster:
65+ Follow the instructions below to create a Hazelcast cluster:
5966
60- 1. Go to Hazelcast’s download `page < https://hazelcast.org/download/ >`__
61- and download either the `` .zip `` or `` .tar `` distribution of
62- Hazelcast IMDG .
67+ 1. Go to Hazelcast’s download `page
68+ <https://hazelcast.com/open-source-projects/downloads/> `__
69+ and download either the `` .zip `` or `` .tar `` distribution of Hazelcast .
63702. Decompress the contents into any directory that you want to run
6471 members from.
65723. Change into the directory that you decompressed the Hazelcast content
6673 and then into the ``bin `` directory.
67- 4. Use either ``start.sh `` or ``start.bat `` depending on your operating
74+ 4. Use either ``hz- start `` or ``hz- start.bat `` depending on your operating
6875 system. Once you run the start script, you should see the Hazelcast
69- IMDG logs in the terminal.
76+ logs in the terminal.
7077
7178You should see a log similar to the following, which means that your
72791-member cluster is ready to be used:
@@ -126,8 +133,8 @@ If you want to add a ``Portable`` class, you should use
126133``<portable-factories> `` instead of ``<data-serializable-factories> `` in
127134the above configuration.
128135
129- See the `Hazelcast IMDG Reference
130- Manual <http ://docs.hazelcast.org/docs /latest/manual/html-single/index.html# getting-started> `__
136+ See the `Hazelcast Reference Manual
137+ <https ://docs.hazelcast.com/hazelcast /latest/getting-started/install-hazelcast > `__
131138for more information on setting up the clusters.
132139
133140Downloading and Installing
@@ -151,41 +158,41 @@ command:
151158Basic Configuration
152159-------------------
153160
154- If you are using Hazelcast IMDG and Python client on the same computer,
161+ If you are using Hazelcast and Python client on the same computer,
155162generally the default configuration should be fine. This is great for
156163trying out the client. However, if you run the client on a different
157164computer than any of the cluster members, you may need to do some simple
158165configurations such as specifying the member addresses.
159166
160- The Hazelcast IMDG members and clients have their own configuration
167+ The Hazelcast members and clients have their own configuration
161168options. You may need to reflect some of the member side configurations
162169on the client side to properly connect to the cluster.
163170
164171This section describes the most common configuration elements to get you
165172started in no time. It discusses some member side configuration options
166173to ease the understanding of Hazelcast’s ecosystem. Then, the client
167174side configuration options regarding the cluster connection are
168- discussed. The configurations for the Hazelcast IMDG data structures
175+ discussed. The configurations for the Hazelcast data structures
169176that can be used in the Python client are discussed in the following
170177sections.
171178
172- See the `Hazelcast IMDG Reference
173- Manual <https://docs.hazelcast.org/docs /latest/manual/html-single/index.html > `__
179+ See the `Hazelcast Reference Manual
180+ <https://docs.hazelcast.com/hazelcast /latest/> `__
174181and :ref: `configuration_overview:configuration overview ` section for
175182more information.
176183
177- Configuring Hazelcast IMDG
178- ~~~~~~~~~~~~~~~~~~~~~~~~~~
184+ Configuring Hazelcast
185+ ~~~~~~~~~~~~~~~~~~~~~
179186
180- Hazelcast IMDG aims to run out-of-the-box for most common scenarios.
187+ Hazelcast aims to run out-of-the-box for most common scenarios.
181188However if you have limitations on your network such as multicast being
182- disabled, you may have to configure your Hazelcast IMDG members so that
189+ disabled, you may have to configure your Hazelcast members so that
183190they can find each other on the network. Also, since most of the
184191distributed data structures are configurable, you may want to configure
185192them according to your needs. We will show you the basics about network
186193configuration here.
187194
188- You can use the following options to configure Hazelcast IMDG :
195+ You can use the following options to configure Hazelcast:
189196
190197- Using the ``hazelcast.xml `` configuration file.
191198- Programmatically configuring the member before starting it from the
@@ -297,7 +304,7 @@ default settings.
297304
298305 client = hazelcast.HazelcastClient()
299306
300- If you run the Hazelcast IMDG members on a different server than the
307+ If you run the Hazelcast members on a different server than the
301308client, you most probably have configured the members’ ports and cluster
302309names as explained in the previous section. If you did, then you need to
303310make match those changes to the network settings of your client.
0 commit comments