pg-wrapper
pg-wrapper — managePostgres Pro symbolic links
Synopsis
pg-wrapper
links
{update
|remove
}
Description
pg-wrapper is a shell script provided in thePostgres Pro distribution to managePostgres Pro symbolic links for the provided programs and adjust the handling ofSQL man pages on Linux systems. SincePostgres Pro is installed into pg-wrapper is provided as part of the pg-wrapper must be run as root./opt/pgpro/std-12
, this is required to make client and server programs available in the standard systemPATH
and find the newSQL man pages. This setup is not performed automatically at installation time to avoid possible conflicts with otherPostgreSQL-based products you may have installed, unless you have opted for using thepostgrespro-std-12
quick-install package.postgrespro-std-12-client
package. Once this package is installed, you can findpg-wrapper in the
directory, whereinstall-dir
/bininstall-dir
is/opt/pgpro/std-12
.
Options
pg-wrapper accepts the following command-line arguments:
links
{update
|remove
}ManagePostgres Pro symbolic links andSQL man pages:
update
— create or replace symbolic links for server and client programs provided withPostgres Pro, as well as addSQL man pages to the man page configuration file.remove
— remove symbolic links andSQL man page support for the currentPostgres Pro version.
Notes
If you are installingPostgres Pro from thepostgrespro-std-12
package,pg-wrapper is invoked automatically.
If you are installing individualPostgres Pro packages, you can run this script manually to create symbolic links to the provided client and server programs, as well as addSQL man pages to the man page configuration file. For parallel installations with other Ifupdate-alternatives is supported, IfSQL man pages are already installed from a different product, the pages unique for the new installation will be displayed, while the previous installation will keep its priority for all the coinciding man pages. For the newSQL documentation to be displayed for all pages, you have to modify the system configuration, for example, change the Ifupdate-alternatives is not supported, For details on binary installation specifics on Linux, seeSection 16.1.PostgreSQL
-based products,pg-wrapper
behavior depends on whether theupdate-alternatives utility is supported by your system and the already installedPostgreSQL
-based product:pg-wrapper
adds symbolic links toPostgres Pro programs into the alternative system, in accordance with their priority, as well as addsSQL man pages to the man page configuration file. For details on how to change the alternatives system priorities, see the man page forupdate-alternatives on your system.MANPATH
value.pg-wrapper
updates the system configuration only if there are no conflicts with any programs or man pages already installed. Otherwise,pg-wrapper does not create or update any program links and skipsSQL man page integration. In this case, you can either continue using the already available program versions andSQL man pages, or modify thePATH
andMANPATH
settings manually.