Skip to content

Commit ac57ce7

Browse files
authored
Get rid of the old links in the documentation (#489)
* Get rid of the old links in the documentation We have now moved all our documentation & open-source site to `hazelcast.com` with a new structure. This PR corrects all the links to `*.hazelcast.org` with the new ones. * add link checker option to sphinx and fix broken/redirected links * use suggested article
1 parent c5e04aa commit ac57ce7

File tree

14 files changed

+149
-142
lines changed

14 files changed

+149
-142
lines changed

.github/workflows/test_runner.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,4 +80,4 @@ jobs:
8080
- name: Generate documentation
8181
working-directory: docs
8282
run: |
83-
make html SPHINXOPTS="-W --keep-going"
83+
make html SPHINXOPTS="-W --keep-going -b linkcheck"

README.rst

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -16,29 +16,29 @@ Hazelcast Python Client
1616

1717
----
1818

19-
`Hazelcast <https://hazelcast.org/>`__ is an open-source distributed
19+
`Hazelcast <https://hazelcast.com/>`__ is an open-source distributed
2020
in-memory data store and computation platform that provides a wide
2121
variety of distributed data structures and concurrency primitives.
2222

23-
Hazelcast Python client is a way to communicate to Hazelcast IMDG
24-
clusters and access the cluster data. The client provides a
25-
Future-based asynchronous API suitable for wide ranges of use cases.
23+
Hazelcast Python client is a way to communicate to Hazelcast clusters
24+
and access the cluster data. The client provides a Future-based
25+
asynchronous API suitable for wide ranges of use cases.
2626

2727
Installation
2828
------------
2929

3030
Hazelcast
3131
~~~~~~~~~
3232

33-
Hazelcast Python client requires a working Hazelcast IMDG cluster to
34-
run. This cluster handles the storage and manipulation of the user data.
33+
Hazelcast Python client requires a working Hazelcast cluster to run.
34+
This cluster handles the storage and manipulation of the user data.
3535

36-
A Hazelcast IMDG cluster consists of one or more cluster members. These
36+
A Hazelcast cluster consists of one or more cluster members. These
3737
members generally run on multiple virtual or physical machines and are
3838
connected to each other via the network. Any data put on the cluster is
3939
partitioned to multiple members transparent to the user. It is therefore
4040
very easy to scale the system by adding new members as the data grows.
41-
Hazelcast IMDG cluster also offers resilience. Should any hardware or
41+
Hazelcast cluster also offers resilience. Should any hardware or
4242
software problem causes a crash to any member, the data on that member
4343
is recovered from backups and the cluster continues to operate without
4444
any downtime.
@@ -49,12 +49,12 @@ images <https://hub.docker.com/r/hazelcast/hazelcast/>`__.
4949

5050
.. code:: bash
5151
52-
docker run -p 5701:5701 hazelcast/hazelcast:4.2
52+
docker run -p 5701:5701 hazelcast/hazelcast:5.0
5353
5454
You can also use our ZIP or TAR
55-
`distributions <https://hazelcast.org/imdg/download/archives/#hazelcast-imdg>`__.
55+
`distributions <https://hazelcast.com/open-source-projects/downloads/>`__.
5656
Once you have downloaded, you can start the Hazelcast member using
57-
the ``bin/start.sh`` script.
57+
the ``bin/hz-start`` script.
5858

5959
Client
6060
~~~~~~
@@ -100,8 +100,8 @@ Usage
100100
client.shutdown()
101101
102102
103-
If you are using Hazelcast IMDG and the Python client on the same
104-
machine, the default configuration should work out-of-the-box. However,
103+
If you are using Hazelcast and the Python client on the same machine,
104+
the default configuration should work out-of-the-box. However,
105105
you may need to configure the client to connect to cluster nodes that
106106
are running on different machines or to customize client properties.
107107

@@ -149,7 +149,7 @@ Features
149149
- Ability to listen to client lifecycle, cluster state, and distributed
150150
data structure events
151151
- and `many
152-
more <https://hazelcast.org/imdg/clients-languages/python/#client-features>`__
152+
more <https://hazelcast.com/clients/python/#client-features>`__
153153

154154
Getting Help
155155
------------
@@ -177,7 +177,7 @@ Issue Reports
177177
For issue reports, please share the following information with us to
178178
quickly resolve the problems:
179179

180-
- Hazelcast IMDG and the client version that you use
180+
- Hazelcast and the client version that you use
181181
- General information about the environment and the architecture you
182182
use like Python version, cluster size, number of clients, Java
183183
version, JVM parameters, operating system etc.
@@ -195,7 +195,7 @@ Development
195195
^^^^^^^^^^^
196196

197197
1. Clone the `GitHub repository
198-
<https://github.com/hazelcast/hazelcast-python-client.git>`__.
198+
<https://github.com/hazelcast/hazelcast-python-client>`__.
199199
2. Run ``python setup.py install`` to install the Python client.
200200

201201
If you are planning to contribute:
@@ -223,7 +223,7 @@ Following commands starts the tests:
223223
python run_tests.py
224224
225225
Test script automatically downloads ``hazelcast-remote-controller`` and
226-
Hazelcast IMDG. The script uses Maven to download those.
226+
Hazelcast. The script uses Maven to download those.
227227

228228
License
229229
-------
@@ -235,5 +235,5 @@ Copyright
235235

236236
Copyright (c) 2008-2021, Hazelcast, Inc. All Rights Reserved.
237237

238-
Visit `www.hazelcast.com <http://www.hazelcast.com>`__ for more
238+
Visit `hazelcast.com <https://hazelcast.com>`__ for more
239239
information.

docs/copyright.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,5 +3,5 @@ Copyright
33

44
Copyright (c) 2008-2021, Hazelcast, Inc. All Rights Reserved.
55

6-
Visit `www.hazelcast.com <http://www.hazelcast.com>`__ for more
6+
Visit `hazelcast.com <https://hazelcast.com>`__ for more
77
information.

docs/development_and_testing.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@ Building and Using Client From Sources
1111
Follow the below steps to build and install Hazelcast Python client from
1212
its source:
1313

14-
1. Clone the GitHub repository
15-
(https://github.com/hazelcast/hazelcast-python-client.git).
14+
1. Clone the `GitHub repository
15+
<https://github.com/hazelcast/hazelcast-python-client>`__.
1616
2. Run ``python setup.py install`` to install the Python client.
1717

1818
If you are planning to contribute:
@@ -40,4 +40,4 @@ Following commands starts the tests:
4040
python run_tests.py
4141
4242
Test script automatically downloads ``hazelcast-remote-controller`` and
43-
Hazelcast IMDG. The script uses Maven to download those.
43+
Hazelcast. The script uses Maven to download those.

docs/getting_started.rst

Lines changed: 43 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -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
2222
run. 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
2424
such 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
2727
members generally run on multiple virtual or physical machines and are
2828
connected to each other via network. Any data put on the cluster is
2929
partitioned to multiple members transparent to the user. It is therefore
3030
very 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
3232
software problem causes a crash to any member, the data on that member
3333
is recovered from backups and the cluster continues to operate without
3434
any 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
3636
that live on the cluster.
3737

3838
In 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

5562
Running 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.
6370
2. Decompress the contents into any directory that you want to run
6471
members from.
6572
3. 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

7178
You should see a log similar to the following, which means that your
7279
1-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
127134
the 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>`__
131138
for more information on setting up the clusters.
132139

133140
Downloading and Installing
@@ -151,41 +158,41 @@ command:
151158
Basic 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,
155162
generally the default configuration should be fine. This is great for
156163
trying out the client. However, if you run the client on a different
157164
computer than any of the cluster members, you may need to do some simple
158165
configurations 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
161168
options. You may need to reflect some of the member side configurations
162169
on the client side to properly connect to the cluster.
163170

164171
This section describes the most common configuration elements to get you
165172
started in no time. It discusses some member side configuration options
166173
to ease the understanding of Hazelcast’s ecosystem. Then, the client
167174
side 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
169176
that can be used in the Python client are discussed in the following
170177
sections.
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/>`__
174181
and :ref:`configuration_overview:configuration overview` section for
175182
more 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.
181188
However 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
183190
they can find each other on the network. Also, since most of the
184191
distributed data structures are configurable, you may want to configure
185192
them according to your needs. We will show you the basics about network
186193
configuration 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
301308
client, you most probably have configured the members’ ports and cluster
302309
names as explained in the previous section. If you did, then you need to
303310
make match those changes to the network settings of your client.

docs/index.rst

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,13 @@ Hazelcast Python Client
1616

1717
----
1818

19-
`Hazelcast <https://hazelcast.org/>`__ is an open-source distributed
19+
`Hazelcast <https://hazelcast.com/>`__ is an open-source distributed
2020
in-memory data store and computation platform that provides a wide
2121
variety of distributed data structures and concurrency primitives.
2222

23-
Hazelcast Python client is a way to communicate to Hazelcast IMDG
24-
clusters and access the cluster data. The client provides a
25-
Future-based asynchronous API suitable for wide ranges of use cases.
23+
Hazelcast Python client is a way to communicate to Hazelcast clusters
24+
and access the cluster data. The client provides a Future-based
25+
asynchronous API suitable for wide ranges of use cases.
2626

2727

2828
Overview
@@ -62,8 +62,8 @@ Usage
6262
client.shutdown()
6363
6464
65-
If you are using Hazelcast IMDG and the Python client on the same
66-
machine, the default configuration should work out-of-the-box. However,
65+
If you are using Hazelcast and the Python client on the same machine,
66+
the default configuration should work out-of-the-box. However,
6767
you may need to configure the client to connect to cluster nodes that
6868
are running on different machines or to customize client properties.
6969

@@ -124,7 +124,7 @@ Features
124124
serialization
125125
setting_up_client_network
126126
client_connection_strategy
127-
using_python_client_with_hazelcast_imdg
127+
using_python_client_with_hazelcast
128128
securing_client_connection
129129
development_and_testing
130130
getting_help

docs/securing_client_connection.rst

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ This chapter describes the security features of Hazelcast Python client.
55
These include using TLS/SSL for connections between members and between
66
clients and members, mutual authentication, username/password authentication,
77
token authentication and Kerberos authentication. These security features
8-
require **Hazelcast IMDG Enterprise** edition.
8+
require **Hazelcast Enterprise** edition.
99

1010
TLS/SSL
1111
-------
@@ -32,8 +32,8 @@ TLS/SSL for Hazelcast Members
3232

3333
Hazelcast allows you to encrypt socket level communication between
3434
Hazelcast members and between Hazelcast clients and members, for end to
35-
end encryption. To use it, see the `TLS/SSL for Hazelcast Members
36-
section <http://docs.hazelcast.org/docs/latest/manual/html-single/index.html#tls-ssl-for-hazelcast-members>`__.
35+
end encryption. To use it, see the `TLS/SSL for Hazelcast Members section
36+
<https://docs.hazelcast.com/hazelcast/latest/security/tls-ssl.html#tlsssl-for-hazelcast-members>`__.
3737

3838
TLS/SSL for Hazelcast Python Clients
3939
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -252,8 +252,8 @@ property on the server side in the ``hazelcast.xml`` file:
252252
253253
You can see the details of setting mutual authentication on the server
254254
side in the `Mutual Authentication
255-
section <https://docs.hazelcast.org/docs/latest/manual/html-single/index.html#mutual-authentication>`__
256-
of the Hazelcast IMDG Reference Manual.
255+
section <https://docs.hazelcast.com/hazelcast/latest/security/tls-ssl.html#mutual-authentication>`__
256+
of the Hazelcast Reference Manual.
257257

258258
On the client side, you have to provide ``ssl_cafile``, ``ssl_certfile``
259259
and ``ssl_keyfile`` on top of the other TLS/SSL configurations. See the
@@ -289,7 +289,7 @@ Then, on the client-side, set ``creds_username`` and ``creds_password`` in the c
289289
)
290290
291291
Check out the documentation on `Password Credentials
292-
<https://docs.hazelcast.com/imdg/latest/security/security-realms.html#password-credentials>`__
292+
<https://docs.hazelcast.com/hazelcast/latest/security/security-realms.html#password-credentials>`__
293293
of the Hazelcast Documentation.
294294

295295
Token-Based Authentication

docs/setting_up_client_network.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Setting Smart Routing
4848

4949
Smart routing defines whether the client mode is smart or unisocket. See
5050
the
51-
:ref:`using_python_client_with_hazelcast_imdg:python client operation modes`
51+
:ref:`using_python_client_with_hazelcast:python client operation modes`
5252
section for the description of smart and unisocket modes.
5353

5454
.. code:: python
@@ -134,7 +134,7 @@ External Smart Client Discovery
134134

135135
.. warning::
136136

137-
This feature requires Hazelcast IMDG 4.2 or higher version.
137+
This feature requires Hazelcast 4.2 or higher version.
138138

139139
The client sends requests directly to cluster members in the smart client mode
140140
(default) in order to reduce hops to accomplish operations. Because of that,

0 commit comments

Comments
 (0)