Fix README

This commit is contained in:
Yogesh Sharma 2023-10-26 08:33:41 -04:00
parent 5455588979
commit 4b57949ba8
Signed by: yogesh.sharma
GPG key ID: 47778BF1D2A81254

View file

@ -2,11 +2,27 @@
## Configuration settings ## Configuration settings
### Setting for make
| Config | Defaults | Description | | Config | Defaults | Description |
| --- | --- | --- |
| MAKEFLAGS | | make settings ex: '-j 4'|
### Setting for pg-env
| Config | Defaults | Description |
| --- | --- | --- |
| PGV | None | PostgreSQL Major Version or HEAD | | PGV | None | PostgreSQL Major Version or HEAD |
| GIT_DIR | ${HOME}/gitwork | Your GIT workspace directory name | | GIT_DIR | ${HOME}/gitwork | Your GIT workspace directory name |
| PG_DEV_NAME | postgresql-<PGV> | Name of the source code folder (a git worktree) | | PG_DEV_NAME | postgresql-<PGV> | Name of the source code folder (a git worktree) |
| PG_INST_NAME | <PG_DEV_NAME>-INST | Name of the install folder | | PG_INST_NAME | <PG_DEV_NAME>-INST | Name of the install folder |
| PG_ENV_CFLAGS | | Extra CFLAGS |
### Advance setting for pg-env
| Config | Defaults | Description |
| --- | --- | --- |
| PG_ENV_DEBUG | | Set this var to non empoty to print some debug info |
## Setting up environment ## Setting up environment
@ -14,10 +30,19 @@ You can create ~/.pg-env with your global settings
You can create ./.pg-env with your per folder settings You can create ./.pg-env with your per folder settings
export PGV=<major version|HEAD> You can also export PGV=<major version|HEAD>
PGPORT will be 5400 + PGV. When PGV is set to HEAD PGPORT is set to 5432
When working with multiple Clusters, passed on id is added as a prefix to PGPORT
Note: Max 1 - 5 Clusters are allowed.
## Setup
- Clone
- Symlink `ln -s <Clone Dir>/pg-env ~/bin/pg-env`
## Activate PostgreSQL Developmnent ENvironment ## Activate PostgreSQL Developmnent ENvironment
`source pg-env` `source ~/bin/pg-env`
## Run distclean on PostgreSQL source ## Run distclean on PostgreSQL source
`distclean` `distclean`
@ -29,43 +54,43 @@ export PGV=<major version|HEAD>
`compile_contrib` `compile_contrib`
## Start PostgreSQL ## Start PostgreSQL
`startdb <Nodes>` `startdb <Clusters>`
ex: ex:
startdb startdb
startdb 1 2 3 startdb 1 2 3
## Stop PostgtreSQL ## Stop PostgtreSQL
`stopdb <Nodes>` `stopdb <Clusters>`
ex: ex:
stopdb stopdb
stopdb 1 2 3 stopdb 1 2 3
## Restart PostgreSQL ## Restart PostgreSQL
`restartdb <Nodes>` `restartdb <Clusters>`
ex: ex:
restartdb restartdb
restartdb 1 2 3 restartdb 1 2 3
## Remove PGDATA ## Remove PGDATA
`cleandb <Nodes>` `cleandb <Clusters>`
ex: ex:
cleandb cleandb
cleandb 1 2 3 cleandb 1 2 3
## Initialize PostgreSQL Cluster and include custom config ## Initialize PostgreSQL Cluster and include custom config
`setupdb <Nodes>` `setupdb <Clusters>`
ex: ex:
setupdb setupdb
setupdb 1 2 3 setupdb 1 2 3
## Reset DB ## Reset DB
`resetdb <Nodes>` `resetdb <Clusters>`
ex: ex:
resetdb resetdb
resetdb 1 2 3 resetdb 1 2 3
## Reset database and install direcotory ## Reset database and install direcotory
`resetall <Nodes>` `resetall <Clusters>`
ex: ex:
resetall resetall
resetall 1 2 3 resetall 1 2 3