Skip to content

Commit e5b1d0b

Browse files
drothery-edbdrothery-edb
authored
Merge pull request #1445 from EnterpriseDB/PostGIS_312_June8
PostGIS_312_June8 Former-commit-id: 5e5b488
2 parents 55c59d6 + 87e7d0f commit e5b1d0b

File tree

5 files changed

+214
-94
lines changed

5 files changed

+214
-94
lines changed

‎product_docs/docs/postgis/1.0/01_installing_postgis.mdx

Lines changed: 88 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,10 @@ legacyRedirectsGenerated:
88

99
<div id="installing_postgis" class="registered_link"></div>
1010

11-
The following table lists the latest PostGIS versions and their corresponding Advanced Server versions. The PostGIS version required by your Advanced Server installation is version-specific, but the documented and supported functionality of each version is the same. The information in this guide applies to each version listed in the table below.
11+
The following table lists the latest PostGIS versions and their corresponding Advanced Server versions.
12+
13+
!!! Note
14+
The PostGIS version required by your Advanced Server installation is version-specific, but the documented and supported functionality of each version is the same. The information in this guide applies to each version listed in the table below.
1215

1316
| **PostGIS Version** | **Supported Advanced Server Versions** | **Supported Platforms** |
1417
| ------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -20,7 +23,7 @@ The following table lists the latest PostGIS versions and their corresponding Ad
2023
| `PostGIS 3.0` | Advanced Server 12 | RHEL/CentOS 7 x86_64 and RHEL/CentOS 8 - x86_64 <br/>RHEL/CentOS 7 - ppc64le <br/>Debian 9x Stretch and 10x Buster <br/>Ubuntu 18.04 LTS Bionic Beaver <br/>Windows 64 x86 Interactive Installer |
2124
| `PostGIS 3.0` | Advanced Server 11 | RHEL/CentOS 7 - x86_64 |
2225
| `PostGIS 2.5` | Advanced Server 12 | RHEL/CentOS 7 - x86_64 and RHEL/CentOS 8 - x86_64 <br/>RHEL/CentOS 7 - ppc64le <br/>Debian 9x Stretch and 10x Buster <br/>Ubuntu 18.04 LTS Bionic Beaver <br/>Windows 64 x86 Interactive Installer <br/>SLES 12 |
23-
| `PostGIS 2.5` | Advanced Server 11 | RHEL/CentOS 7 - x86_64 and RHEL/CentOS 8 - x86_64 <br/>RHEL/CentOS 7 - ppc64le <br/>Debian 9x Stretch <br/>Ubuntu 18.04 LTS Bionic Beaver <br/>Windows 64 x86 Interactive Installer <br/>SLES 12 |
26+
| `PostGIS 2.5` | Advanced Server 11 | RHEL/CentOS 7 - x86_64 <br/>RHEL/CentOS 7 - ppc64le <br/>Debian 9x Stretch <br/>Ubuntu 18.04 LTS Bionic Beaver <br/>Windows 64 x86 Interactive Installer <br/>SLES 12 |
2427
| `PostGIS 2.4` | Advanced Server 9.6, 10 and 11 | RHEL/CentOS 7 - x86_64 <br/>RHEL/CentOS 7 - ppc64le <br/>Windows 64 x86 Interactive Installer |
2528
| `PostGIS 2.3` | Advanced Server 9.6 and 10 | RHEL/CentOS 7 - x86_64 <br/>RHEL/CentOS 7 - ppc64le <br/>Windows 64 x86 Interactive Installer |
2629

@@ -33,9 +36,9 @@ The following table lists the latest PostGIS versions and their corresponding Ad
3336

3437
Before creating the repository configuration file, you must have credentials that allow access to the EnterpriseDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user).
3538

36-
Perform the following steps to install PostGIS:
39+
Perform the following steps to install PostGIS on a CentOS Host:
3740

38-
1. To create the repository configuration file, assume superuser privileges and invoke one of the following platform-specific commands:
41+
1. To create the repository configuration file, assume superuser privileges, and invoke the platform-specific command:
3942

4043
On CentOS 7:
4144

@@ -49,13 +52,13 @@ Perform the following steps to install PostGIS:
4952
dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm
5053
```
5154

52-
2. Replace the `USERNAME:PASSWORD` placeholder in the following command with the username and password of a registered EnterpriseDB user:
55+
2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EnterpriseDB user:
5356

5457
```text
5558
sed -i "s@<username>:<password>@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo
5659
```
5760

58-
3. Before installing PostGIS, execute the following command to install the Extra Packages for Enterprise Linux (EPEL) release package:
61+
3. Before installing PostGIS, you need to install the Extra Packages for Enterprise Linux (EPEL) release package:
5962

6063
On CentOS 7:
6164

@@ -69,53 +72,57 @@ Perform the following steps to install PostGIS:
6972
dnf -y install epel-release
7073
```
7174

72-
4. On CentOS 8, enable the PowerTools repository to satisfy package dependencies:
75+
4. The following steps are applicable only for CentOS 8 platform:
76+
77+
a. Enable the PowerTools repository to satisfy package dependencies:
7378

7479
```text
7580
dnf config-manager --set-enabled PowerTools
7681
```
7782

78-
5. On CentOS 8, disable the built-in PostgreSQL module:
83+
b. Disable the built-in PostgreSQL module:
7984

8085
```text
8186
dnf -qy module disable postgresql
8287
```
8388

84-
6. Install `PostGIS` with one of the following platform-specific commands:
89+
5. Invoke the platform-specific command to install `PostGIS`:
8590

86-
On CentOS 7, to install the latest version of PostGIS version for EDB Advanced Server version (EPAS) 13.0:
91+
On CentOS 7, to install the latest version of PostGIS version for EDB Advanced Server version 13.0:
8792

8893
```text
8994
yum -y install edb-as13-postgis3
9095
```
9196

92-
On CentOS 8, to install the latest version of PostGIS version for EDB Advanced Server version (EPAS) 13.0:
97+
On CentOS 8, to install the latest version of PostGIS version for EDB Advanced Server version 13.0:
9398

9499
```text
95100
dnf -y install edb-as13-postgis3
96101
```
97102

98-
On CentOS 7, to install the latest version of PostGIS for EDB Advanced Server version (EPAS) except 13.0:
103+
On CentOS 7, to install the latest version of PostGIS for EDB Advanced Server versions older than 13.0:
99104

100105
```text
101106
yum -y install edb-as<xx>-postgis
102107
```
103108

104-
Where *&lt;xx>* denotes the Advanced Server version (except 13.0) supported for the latest PostGIS version
109+
Where *&lt;xx>* denotes the Advanced Server version older than 13.0.
105110

106-
On CentOS 7, to install PostGIS older version, for example PostGIS 3.0.2 for EDB Advanced Server version (EPAS) 13.0:
111+
On CentOS 7, to install PostGIS older versions (for example PostGIS 3.0.2) for EDB Advanced Server version 13.0:
107112

108113
```text
109114
yum -y install edb-as13-postgis3-3.0.2
110115
```
111116

112-
On CentOS 7, to install older PostGIS versions for versions of EDB Advanced Server, except version 13.0:
117+
On CentOS 7, to install older PostGIS versions for EDB Advanced Server versions older than 13.0:
113118

114119
```text
115120
yum -y install edb-as<xx>-postgis-<y.y.y>
116121
```
117122

118-
Where *&lt;xx>* is the Advanced Server version and*&lt;y.y.y>* is the older PostGIS version you want to install. For example, to install PostGIS 2.5.4 on Advanced Server 12:
123+
Where *&lt;xx>* is the Advanced Server version older than 13.0 and*&lt;y.y.y>* is the older PostGIS version.
124+
125+
For example, to install PostGIS 2.5.4 on Advanced Server 12:
119126

120127
```text
121128
yum -y install edb-as12-postgis-2.5.4
@@ -132,9 +139,9 @@ Perform the following steps to install PostGIS:
132139

133140
Before installing the repository configuration file, you must have credentials that allow access to the EnterpriseDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user).
134141

135-
Perform the following steps to install PostGIS:
142+
Perform the following steps to install PostGIS on an RHEL Host:
136143

137-
1. To create the repository configuration file, assume superuser privileges and invoke one of the following platform-specific commands:
144+
1. To create the repository configuration file, assume superuser privileges, and invoke the platform-specific command:
138145

139146
On RHEL 7:
140147

@@ -148,13 +155,13 @@ Perform the following steps to install PostGIS:
148155
dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm
149156
```
150157

151-
2. Replace the `USERNAME:PASSWORD` placeholder in the following command with the username and password of a registered EnterpriseDB user:
158+
2. Replace the `USERNAME:PASSWORD` variable with the username and password of a registered EnterpriseDB user:
152159

153160
```text
154161
sed -i "s@<username>:<password>@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo
155162
```
156163

157-
3. Before installing PostGIS, execute the following command to install the Extra Packages for Enterprise Linux (EPEL) release package:
164+
3. Before installing PostGIS, you need to install the Extra Packages for Enterprise Linux (EPEL) release package:
158165

159166
On RHEL 7:
160167

@@ -184,47 +191,49 @@ Perform the following steps to install PostGIS:
184191
subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms"
185192
```
186193

187-
5. On RHEL 8, disable the built-in PostgreSQL module:
194+
5. On RHEL 8 platform, disable the built-in PostgreSQL module:
188195

189196
```text
190197
dnf -qy module disable postgresql
191198
```
192199

193-
6. Install `PostGIS` with one of the following platform-specific commands:
200+
6. Invoke the platform-specific command to install `PostGIS`:
194201

195-
On RHEL 7, to install the latest version of PostGIS version for EDB Advanced Server version (EPAS) 13.0:
202+
On RHEL 7, to install the latest version of PostGIS for EDB Advanced Server version 13.0:
196203

197204
```text
198205
yum -y install edb-as13-postgis3
199206
```
200207

201-
On RHEL 8, to install the latest version of PostGIS version for EDB Advanced Server version (EPAS) 13.0:
208+
On RHEL 8, to install the latest version of PostGIS for EDB Advanced Server version 13.0:
202209

203210
```text
204211
dnf -y install edb-as13-postgis3
205212
```
206213

207-
On RHEL 7, to install the latest version of PostGIS for EDB Advanced Server version (EPAS) except 13.0:
214+
On RHEL 7, to install the latest version of PostGIS for EDB Advanced Server version older than 13.0:
208215

209216
```text
210217
yum -y install edb-as<xx>-postgis
211218
```
212219

213-
Where *&lt;xx>* denotes the Advanced Server version (except 13.0) supported for the latest PostGIS version
220+
Where *&lt;xx>* denotes the Advanced Server version older than 13.0
214221

215-
On RHEL 7, to install PostGIS older version, for example PostGIS 3.0.2 for EDB Advanced Server version (EPAS) 13.0:
222+
On RHEL 7, to install PostGIS older versions (for example PostGIS 3.0.2) for EDB Advanced Server version 13.0:
216223

217224
```text
218225
yum -y install edb-as13-postgis3-3.0.2
219226
```
220227

221-
On RHEL 7, to install older PostGIS versions for versions of EDB Advanced Server, except version 13.0:
228+
On RHEL 7, to install older PostGIS versions for EDB Advanced Server version older than 13.0:
222229

223230
```text
224231
yum -y install edb-as<xx>-postgis-<y.y.y>
225232
```
226233

227-
Where *&lt;xx>* is the Advanced Server version and*&lt;y.y.y>* is the older PostGIS version you want to install. For example, to install PostGIS 2.5.4 on Advanced Server 12:
234+
Where *&lt;xx>* is the Advanced Server version older than 13.0 and*&lt;y.y.y>* is the older PostGIS version.
235+
236+
For example, to install PostGIS 2.5.4 on EDB Advanced Server version 12:
228237

229238
```text
230239
yum -y install edb-as12-postgis-2.5.4
@@ -239,7 +248,9 @@ Perform the following steps to install PostGIS:
239248

240249
## Installing PostGIS on an RHEL/CentOS 7 PPCLE Host
241250

242-
Before installing the repository configuration, you must have credentials that allow access to the EnterpriseDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). Perform the following steps to install PostGIS on an RHEL/CentOS 7 PPC64LE Host.
251+
Before installing the repository configuration, you must have credentials that allow access to the EnterpriseDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user).
252+
253+
Perform the following steps to install PostGIS on an RHEL/CentOS 7 PPC64LE Host.
243254

244255
1. Create the Advance Toolchain repository configuration file:
245256

@@ -265,13 +276,13 @@ Before installing the repository configuration, you must have credentials that a
265276
yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm
266277
```
267278

268-
3. Replace the `USERNAME:PASSWORD` placeholder in the following command with the username and password of a registered EnterpriseDB user:
279+
3. Replace the `USERNAME:PASSWORD` variable with the username and password of a registered EnterpriseDB user:
269280

270281
```text
271282
sed -i "s@<username>:<password>@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo
272283
```
273284

274-
4. Before installing PostGIS, execute the following command to install the Extra Packages for Enterprise Linux (EPEL) release package:
285+
4. Before installing PostGIS, you need to install the Extra Packages for Enterprise Linux (EPEL) release package:
275286

276287
```text
277288
yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
@@ -285,33 +296,35 @@ Before installing the repository configuration, you must have credentials that a
285296

286297
6. Invoke the following command to install PostGIS:
287298

288-
To install the latest version of PostGIS version for EDB Advanced Server version (EPAS) 13.0:
299+
To install the latest version of PostGIS version for EDB Advanced Server version 13.0:
289300

290301
```text
291302
yum -y install edb-as13-postgis3
292303
```
293304

294-
To install the latest version of PostGIS for EDB Advanced Server version (EPAS) except 13.0:
305+
To install the latest version of PostGIS for EDB Advanced Server version older than 13.0:
295306

296307
```text
297308
yum -y install edb-as<xx>-postgis
298309
```
299310

300-
Where *&lt;xx>* denotes the Advanced Server version (except 13.0) supported for the latest PostGIS version
301-
302-
To install PostGIS older version, for example PostGIS 3.0.2 for EDB Advanced Server version (EPAS) 13.0:
311+
Where *&lt;xx>* denotes the Advanced Server version older than 13.0
312+
313+
To install PostGIS older versions (for example PostGIS 3.0.2) for EDB Advanced Server version 13.0:
303314

304315
```text
305316
yum -y install edb-as13-postgis3-3.0.2
306317
```
307318

308-
To install older PostGIS versions for versions of EDB Advanced Server, except version 13.0:
319+
To install older PostGIS versions for EDB Advanced Server versions older than 13.0:
309320

310321
```text
311322
yum -y install edb-as<xx>-postgis-<y.y.y>
312323
```
313324

314-
Where *&lt;xx>* is the Advanced Server version and*&lt;y.y.y>* is the older PostGIS version you want to install. For example, to install PostGIS 2.5.4 on Advanced Server 12:
325+
Where *&lt;xx>* is the Advanced Server version older than 13.0 and*&lt;y.y.y>* is the older PostGIS version.
326+
327+
For example, to install PostGIS 2.5.4 on EDB Advanced Server version 12:
315328

316329
```text
317330
yum -y install edb-as12-postgis-2.5.4
@@ -328,7 +341,7 @@ Before installing the repository configuration, you must have credentials that a
328341

329342
To install a PostGIS package on a Debian or Ubuntu host, you must have credentials to access the EnterpriseDB repository. If you need EnterpriseDB credentials, visit the [EDB website](https://www.enterprisedb.com/user) for credentials.
330343

331-
The following steps will walk you through using the EnterpriseDB repository to install a Debian package. When using the commands, replace the `username` and `password` with the credentials provided by EnterpriseDB.
344+
Perform the following steps to install PostGIS Debian package using the EnterpriseDB repository:
332345

333346
1. Assume superuser privileges:
334347

@@ -338,8 +351,8 @@ The following steps will walk you through using the EnterpriseDB repository to i
338351

339352
2. Configure the EnterpriseDB repository.
340353

341-
On Debian 9, Ubuntu 18, and Ubuntu 20:
342-
354+
On Debian 9, Ubuntu 18, and Ubuntu 20, invoke the folloiwng command and substitute your EnterpriseDB credentials for the `username` and `password` placeholders.
355+
343356
```text
344357
sh -c 'echo "deb https://username:[email protected]/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list'
345358
```
@@ -384,31 +397,52 @@ The following steps will walk you through using the EnterpriseDB repository to i
384397
apt-get install edb-as13-postgis3
385398
```
386399

387-
To install the latest version of PostGIS for EDB Advanced Server version (EPAS), except 13.0:
400+
To install the latest version of PostGIS for EDB Advanced Server version older than 13.0:
388401

389402
```text
390403
apt-get install edb-as<xx>-postgis
391404
```
392405

393-
Where *&lt;xx>* is the Advanced Server version
406+
Where *&lt;xx>* is the Advanced Server version older than 13.0
394407

395-
For example, to install the latest version of PostGIS for EDB Advanced Server version (EPAS) 12:
408+
For example, to install the latest version of PostGIS for EDB Advanced Server version 12:
396409

397410
```text
398411
apt-get install edb-as12-postgis
399412
```
400413

401-
To install an older PostGIS version, for example PostGIS 3.0.2 on Debian 10 platform for EDB Advanced Server version 13.0:
414+
To install specific PostGIS version, for example 3.1.1, on Debian platforms for EDB Advanced Server version, for example 11, invoke the following commands:
415+
416+
On Debian 9:
402417

403418
```text
404-
apt-get install edb-as13-postgis3=3.0.2-1+deb10
419+
apt-get install edb-as11-postgis-3.1=3.1.1-1+deb9
420+
```
421+
422+
On Debian 10:
423+
424+
```text
425+
apt-get install edb-as11-postgis-3.1=3.1.1-1+deb10
426+
```
427+
428+
On Ubuntu 18.04:
429+
430+
```text
431+
apt install edb-as11-postgis-3.1=3.1.1-1+ubuntu4
432+
```
433+
434+
On Ubuntu 20.04
435+
```text
436+
apt install edb-as11-postgis-3.1=3.1.1-1+ubuntu5
405437
```
406438

407439
<div id="using_the_SLES_host" class="registered_link"></div>
408440

409441
## Installing PostGIS on a SLES 12 Host
410442

411-
You can use the Zypper package manager to install PostGIS on a SLES 12 host. Zypper will attempt to satisfy package dependencies as it installs a package but requires access to specific repositories not hosted at EDB.
443+
Perform the following steps to install PostGIS on an SLES Host using the Zypper package manager:
444+
445+
Zypper will attempt to satisfy package dependencies as it installs a package but requires access to specific repositories not hosted at EDB.
412446

413447
1. Assume superuser privileges.
414448

@@ -460,7 +494,7 @@ You can use the Zypper package manager to install PostGIS on a SLES 12 host. Zyp
460494
zypper -n install java-1_8_0-openjdk
461495
```
462496

463-
9. Then, use the zypper utility to install PostGIS:
497+
9. Use the zypper utility to install PostGIS:
464498

465499
```text
466500
zypper -n install edb-as12-postgis
@@ -504,15 +538,15 @@ You must install Advanced Server before installing PostGIS. If you have used the
504538

505539
8. Use fields on the `EDB Postgres Advanced Server Installation Details` window to provide connection information for the Advanced Server host:
506540

507-
- Use the `Host` field to identify the system on which Advanced Server resides.
541+
- Use the `Host` field to identify the system on which Advanced Server resides.
508542

509-
- Provide the name of the role that PostGIS will use for connections to the server in the `User Name` field.
543+
- Provide the name of the role that PostGIS will use for connections to the server in the `User Name` field.
510544

511-
- Provide the password associated with the role in the `Password` field.
545+
- Provide the password associated with the role in the `Password` field.
512546

513-
- Use the `Port` field to identify the listener port that Advanced Server monitors for client connections.
547+
- Use the `Port` field to identify the listener port that Advanced Server monitors for client connections.
514548

515-
Then, click `Next` to continue.
549+
Click `Next` to continue.
516550

517551
![The Advanced Server installation details window](images/advanced_server_installation_details.png)
518552
Fig. 5: The Advanced Server installation details window

0 commit comments

Comments
 (0)