pg_createcluster - En ligne dans le Cloud

PROGRAMME:

Nom

pg_createcluster - crée un nouveau cluster PostgreSQL

SYNOPSIS

pg_createcluster [Options] version prénom [-- base de données d'initialisation Options]

DESCRIPTION

pg_createcluster crée un nouveau cluster de serveurs PostgreSQL (c'est-à-dire une collection de bases de données
servi par un maître de poste(1) instance) et l'intègre dans le multi-version/multi-cluster
architecturale de la postgresql-commun paquet.

Chaque cluster est identifié de manière unique par sa version et son nom. Le nom peut être arbitraire.
Le cluster par défaut créé lors de l'installation d'un package de serveur est main. Cependant,
vous souhaiterez peut-être créer d'autres clusters pour tester, avec d'autres superutilisateurs, un cluster pour
chaque utilisateur sur un serveur partagé, etc. pg_createcluster abandonnera avec une erreur si vous essayez de
créer un cluster avec un nom qui existe déjà pour cette version.

Pour la compatibilité avec systemd unités de service, le nom du cluster ne doit contenir aucune
tirets (-). pg_ctlcluster avertira du problème, mais réussira l'opération.

Compte tenu d'un PostgreSQL majeur version (comme "8.2" ou "8.3") et un cluster prénom, il crée le
fichiers de configuration nécessaires dans /etc/postgresql/version/prénom/; ce sont en particulier
postgresql.conf, pg_ident.conf, pg_hba.conf, une configuration spécifique à postgresql-common
fichier start.conf (voir STARTUP CONTRÔLE ci-dessous), pg_ctl.conf, et un journal de lien symbolique qui
pointe vers le fichier journal (par défaut, /var/log/postgresql/postgresql-version-prénom.Journal).

postgresql.conf est automatiquement adapté pour utiliser le prochain port disponible, c'est-à-dire le premier
port (à partir de 5432) qui n'est pas encore utilisé par un cluster déjà existant.

Si le répertoire de données n'existe pas encore, PostgreSQL base de données d'initialisation(1) la commande est utilisée pour
générer une nouvelle structure de cluster. Si le répertoire de données existe déjà, il est intégré
into the postgresql-commun structure en déplaçant le fichier de configuration et en définissant le
option data_directory. Veuillez noter que ce uniquement fonctionne pour les répertoires de données qui ont été
créé directement avec base de données d'initialisation, c'est à dire tous les fichiers de configuration (postgresql.conf etc.)
doit être présent dans le répertoire de données.

Si un répertoire de socket personnalisé est fourni et qu'il n'existe pas, il est créé.

Si le fichier journal n'existe pas, il est créé. Dans tous les cas, les autorisations sont ajustées pour
autoriser l'accès en écriture au propriétaire du cluster. Veuillez noter que postgresql.conf peut être
personnalisé pour spécifier log_directory et/ou log_filename ; si au moins une de ces options
est présent, le journal du lien symbolique dans le répertoire de configuration du cluster est ignoré.

Si le certificat SSL snakeoil par défaut existe (/etc/ssl/certs/ssl-cert-snakeoil.pem et mes
/etc/ssl/private/ssl-cert-snakeoil.key), et l'utilisateur postgres est dans le ssl-cert Unix
groupe, pg_createcluster configure le cluster pour utiliser ce certificat et active SSL.
Par conséquent, tous les clusters utiliseront le même certificat SSL par défaut. Pour les versions jusqu'à
9.1, des liens symboliques dans le répertoire de données seront créés (server.crt et server.key); pour 9.2
et plus tard, les options postgresql.conf appropriées seront définies (ssl_cert_file et
ssl_key_file). Bien sûr, vous pouvez le remplacer par un certificat spécifique au cluster.
De même pour /etc/postgresql-common/root.crt et /etc/postgresql-common/root.crl, ces
les fichiers seront configurés en tant que certificat client CA et liste de révocation, le cas échéant.
(root.crt est initialement un espace réservé qui ne sera utilisé que si de vrais certificats sont ajoutés
au fichier.)

OPTIONS

-u utilisateur, --utilisateur=utilisateur
Définissez l'utilisateur qui possède le cluster et devient le superutilisateur de la base de données au nom donné
ou uid. Par défaut, c'est l'utilisateur postgres. Un cluster ne doit pas appartenir à root.

-g groupe, --groupe=groupe
Modifiez le groupe des fichiers de données liés au cluster. Par défaut, ce sera le
groupe principal du propriétaire de la base de données.

-d dir, --répertoire de données=dir
Définissez explicitement le chemin du répertoire de données, qui est utilisé pour stocker tous les
bases de données et tableaux. Cela deviendra assez important (facilement de l'ordre de cinq fois
la quantité de données réelles stockées dans le cluster). Par défaut à
/var/lib/postgresql/version/grappe.

-s dir, --socketdir=dir
Définir explicitement le répertoire où le maître de poste(1) le serveur stocke le socket Unix pour
connexions locales. La valeur par défaut est /var/run/postgresql/ pour les clusters appartenant à l'utilisateur
postgres et / Tmp pour les clusters appartenant à d'autres utilisateurs. Soyez averti que / Tmp est un
répertoire non sécurisé car tout le monde peut y créer un socket et usurper l'identité du
serveur de base de données. Si le répertoire donné n'existe pas, il est créé avec les
autorisations

-l chemin, --fichier journal=chemin
Définir explicitement le chemin pour le maître de poste(1) fichier journal du serveur. Par défaut à
/var/log/postgresql/postgresql-version-grappe.Journal.

--locale=local
Définissez les paramètres régionaux par défaut pour le cluster de bases de données. Si cette option n'est pas spécifiée, le
locale est héritée de l'environnement qui pg_createcluster s'exécute.

--lc-collate=local
--lc-type=local
--lc-messages=local
--lc-monétaire=local
--lc-numérique=local
--lc-temps=local
J'aime --lieu, mais définit uniquement les paramètres régionaux dans la catégorie spécifiée.

-e codage, --encodage=codage
Sélectionnez l'encodage de la base de données de modèles. Ce sera également l'encodage par défaut
de toute base de données que vous créez ultérieurement, à moins que vous ne la redéfinissiez ici. La valeur par défaut est dérivée
de la locale, ou SQL_ASCII si cela ne fonctionne pas. Les jeux de caractères pris en charge par
le serveur PostgreSQL sont décrits dans la documentation.

Note: Il n'est pas recommandé de définir cette option directement ! Définissez les paramètres régionaux à la place.

-p port, --port=port
Sélectionnez le port sur lequel le nouveau cluster écoute (pour le socket Unix et le port TCP) ;
ce doit être un nombre compris entre 1024 et 65535, car PostgreSQL ne s'exécute pas en tant que root
et a donc besoin d'un numéro de port non privilégié. Par défaut, le prochain port libre démarre
de 5432 est attribué.

--début
Démarrez immédiatement un serveur pour le cluster après l'avoir créé (c'est-à-dire appelez pg_ctlcluster
version grappe commencer). Par défaut, le cluster n'est pas démarré.

--start-conf=auto|Manuel|handicapé
Définissez la valeur initiale dans le fichier de configuration start.conf. Voir STARTUP CONTRÔLE ci-dessous.
Par défaut, auto est utilisé, ce qui signifie que le cluster est géré par
/etc/init.d/postgresql, c'est-à-dire démarre et s'arrête automatiquement au démarrage du système.

-o Puissance=Plus-value, --pgoption Puissance=Plus-value
Option de configuration à définir dans le nouveau fichier postgresql.conf.

--createclusterconf=filet
Alternative créercluster.conf fichier à utiliser. La valeur par défaut est
/etc/postgresql-common/createcluster.conf (ou $PGSYSCONFDIR/createcluster.conf).

--environnement=filet
Autre défaut sûr, heureux et sain fichier à utiliser. La valeur par défaut est
/etc/postgresql-common/environment (ou $PGSYSCONFDIR/environment). Si le fichier est
manquant, une chaîne d'espace réservé est utilisée. %v et %c sont remplacés ; voir VALEURS PAR DEFAUT
ci-dessous.

-- base de données d'initialisation Options
Options transmises directement à base de données d'initialisation (1).

Par défaut, pg_createcluster mettra à jour le fichier pg_hba.conf généré par initdb pour
utiliser l'authentification par les pairs sur les connexions locales (unix) et md5 sur TCP (hôte)
Connexions. Si la configuration d'authentification explicite est incluse ici (-A, --auth,
--auth-hôte, --auth-local), le fichier pg_hba.conf ne sera pas modifié.

STARTUP CONTRÔLE

Le fichier start.conf dans le répertoire de configuration du cluster contrôle le démarrage/l'arrêt
comportement du processus postmaster de ce cluster. Le fichier peut contenir des lignes de commentaires (démarré
avec '#'), des lignes vides, et doit avoir exactement une ligne avec l'un des mots-clés suivants :

auto
Le processus postmaster est démarré/arrêté automatiquement dans le script d'initialisation. C'est
également la valeur par défaut si le fichier est manquant.

Manuel
Le processus postmaster n'est pas géré par le script d'initialisation, mais en contrôlant manuellement le
cluster avec pg_ctlcluster(1) est autorisé.

handicapé
Ni le script d'initialisation ni pg_ctlcluster(1) sont autorisés à démarrer/arrêter le cluster.
Veuillez noter que cela n'empêchera pas le propriétaire du cluster d'appeler le niveau inférieur
des outils pour contrôler le processus de postmaster ; cette option est uniquement destinée à empêcher
accidents lors de la maintenance, pas plus.

Le fichier pg_ctl.conf dans le répertoire de configuration du cluster peut contenir des options supplémentaires
passé à pg_ctl de ce cluster.

DEFAULT VALEURS

Certaines valeurs par défaut utilisées par pg_createcluster peut être modifié dans
/etc/postgresql-common/createcluster.conf. Occurrences de %v sont remplacés par les principaux
numéro de version, et %c par le nom du cluster. Utilisation %% pour un littéral %.

create_main_cluster (Défaut: oui)
Créer un principal cluster lorsqu'un nouveau package de serveur postgresql-xy est installé.

start_conf (Défaut: auto)
Valeur start.conf par défaut à utiliser.

répertoire_données (Défaut: /var/lib/postgresql/%v/%c)
Répertoire de données par défaut.

répxlog (Par défaut : non défini)
Répertoire par défaut des journaux de transactions. Lorsqu'elle est utilisée, base de données d'initialisation créera un lien symbolique à partir de
pg_xlog dans le répertoire de données à cet emplacement. Non défini par défaut, c'est-à-dire que pg_xlog est
reste dans le répertoire de données.

initdb_options (Par défaut : non défini)
Autres options pour passer à base de données d'initialisation.

Autre options
Toutes les autres options répertoriées sont copiées dans le postgresql.conf du nouveau cluster, par exemple :

listen_addresses = '*'
log_line_prefix = '%%t '

Certaines options de postgresql.conf sont traitées spécialement :

ssl Ajouté uniquement à postgresql.conf si les certificats snakeoil par défaut existent et sont
lisible pour le propriétaire du cluster comme détaillé ci-dessus.

stats_temp_directory
Ajouté uniquement à postgresql.conf s'il existe, et accessible en écriture pour le propriétaire du cluster, ou
sinon si le répertoire parent est accessible en écriture.

Utilisez pg_createcluster en ligne à l'aide des services onworks.net