Skip to content

Commit eeca5e2

Browse files
committed
PG-2209 - Update Quickstart Guide
This PR updates the quick start guide.
1 parent 4794dbb commit eeca5e2

2 files changed

Lines changed: 57 additions & 8 deletions

File tree

docs/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,11 @@ Part of the solution, Percona Operator for PostgreSQL, makes it easy to orchestr
2020

2121
<div data-grid markdown><div data-banner markdown>
2222

23-
### :material-progress-download: Installation guides { .title }
23+
### :material-progress-download: Quickstart guide { .title }
2424

25-
Get started quickly with the step-by-step installation instructions.
25+
Get started quickly with these step-by-step installation instructions.
2626

27-
[Quickstart guides :material-arrow-right:](installing.md){ .md-button }
27+
[Quickstart guide :material-arrow-right:](installing.md){ .md-button }
2828

2929
</div><div data-banner markdown>
3030

docs/installing.md

Lines changed: 54 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,62 @@
11
# Quickstart guide
22

3-
Percona Distribution for PostgreSQL is the Percona server for PostgreSQL with the collection of tools from PostgreSQL community that are tested to work together and serve to assist you in deploying and managing PostgreSQL. [Read more](index.md).
4-
5-
This document aims to guide database application developers and DevOps engineers in getting started with Percona Distribution for PostgreSQL. Upon completion of this guide, you’ll have Percona Distribution for PostgreSQL installed and operational, and you’ll be able to:
3+
In this guide you will learn to install Percona Distribution for PostgreSQL with tested open source extensions and tooling designed to work together reliably on Debian and RHEL. This guide quickly gets you up and running with:
64

5+
* Install Percona Distribution for PostgreSQL using a Package Manager
76
* Connect to PostgreSQL using the `psql` interactive terminal
8-
* Interact with PostgreSQL with basic psql commands
7+
* Interact with PostgreSQL with basic commands
98
* Manipulate data in PostgreSQL
10-
* Understand the next steps you can take as a database application developer or administrator to expand your knowledge of Percona Distribution for PostgreSQL
9+
10+
## Preconditions
11+
12+
Install `curl` for [Telemetry](telemetry.md), this is optional.
13+
14+
```{.bash data-prompt="$"}
15+
$ sudo apt install curl
16+
```
17+
18+
## Install on Debian / Ubuntu (APT) {.power-number}
19+
20+
1. Fetch the `percona-release` package:
21+
22+
```{.bash data-prompt="$"}
23+
wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb
24+
sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb
25+
```
26+
27+
2. Enable the repository and install the package:
28+
29+
```{.bash data-prompt="$"}
30+
sudo percona-release setup ppg-18
31+
sudo apt install percona-postgresql-18
32+
```
33+
34+
The installation process automatically initializes and starts the default database.
35+
36+
3. Switch to a postgres user and open the psql interactive terminal:
37+
38+
```{.bash data-prompt="$"}
39+
sudo su postgres
40+
psql
41+
```
42+
43+
4. Create a database and make a table in the database:
44+
45+
```{.bash data-prompt="$"}
46+
CREATE DATABASE test;
47+
CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100));
48+
```
49+
50+
5. Insert data in the customers table and query the data insertion:
51+
52+
```{.bash data-prompt="$"}
53+
INSERT INTO customers (first_name, last_name, email) VALUES ('John', 'Doe', 'john.doe@example.com');
54+
SELECT * FROM customers;
55+
```
56+
57+
Congratulations! You have installed Percona Distribution for PostgreSQL and created your first database. For detailed installation steps and further instructions, see the [Install Percona Distribution for PostgreSQL on Debian and Ubuntu](apt.md).
58+
59+
## Install on RHEL / Rocky / Alma (YUM)
1160

1261
## Install Percona Distribution for PostgreSQL
1362

0 commit comments

Comments
 (0)