/
INSTALL
187 lines (139 loc) · 6.39 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
Installing pgAdmin from source
==============================
This document describes how to build pgAdmin from source on *nix, Mac and
Windows.
Linux, FreeBSD, Solaris and other unix variants
-----------------------------------------------
You will need:
- A modern development environment:
- GTK 2.2 or above.
- GNU automake 1.9 or above.
- GNU autoconf 2.59 or above.
- GNU gcc 3.4 or above.
- wxGTK 2.8.x from http://www.wxwidgets.org/
- libxml2 2.6.18 or above from http://www.xmlsoft.org/
- libxslt 1.1.x or above from http://www.xmlsoft.org/
- libssh2 1.10.0 or above from http://www.libssh2.org/
- PostgreSQL 10.x or above from http://www.postgresql.org/
- Sphinx 1.0 or above from http://sphinx.pocoo.org/
Building:
1) Install libssh2, libxml2 and libxslt if they are not already present on your system,
per the instructions included with them.
2) Install PostgreSQL per the instructions included. It is recommended that you
build with OpenSSL support, using the --with-openssl configure option.
3) Unpack the wxGTK tarball to a convenient location, and build and install it
as follows:
cd /path/to/wxGTK/source/
./configure --with-gtk --enable-gtk2 --enable-unicode
make
sudo make install
# Install wxWidgets contrib modules.
cd contrib/
make
sudo make install
A script is included in the pgAdmin source tarball
(xtra/wx-build/build-wxgtk) which will build and install wxWidgets in each
combination of shared/static/debug/release builds for you.
4) Unpack the pgAdmin tarball to a convenient location, and build and install it
as follows:
bash bootstrap # Required only if building from a GIT checkout
./configure
make all
sudo make install
If any of the prerequisite components are installed in locations that the
configure script cannot find, you may specify their locations on the command
line. See the configure help (./configure --help) for details.
Mac OS X
--------
You will need:
- A modern development environment:
- XCode 2.0 or above
- GNU automake 1.9 or above.
- GNU autoconf 2.59 or above.
- wxMac 2.8.x from http://www.wxwidgets.org/
- libxml2 2.6.18 or above from http://www.xmlsoft.org/
- libxslt 1.1.x or above from http://www.xmlsoft.org/
- libssh2 1.10.0 or above from http://www.libssh2.org/
- PostgreSQL 10.x or above from http://www.postgresql.org/
- Sphinx 1.0 or above from http://sphinx.pocoo.org/
Building:
1) Install libssh2, libxml2 and libxslt per the instructions included with them into a
non-system location. The default versions included with OS X Panther and
Tiger are too old and will not work correctly with pgAdmin.
2) Install PostgreSQL per the instructions included. It is recommended that you
build with OpenSSL support, using the --with-openssl configure option.
3) Unpack the wxMac tarball to a convenient location, and build and install it
as follows:
cd /path/to/wxMac/source/
./configure --with-mac --enable-gtk2 --enable-unicode
make
sudo make install
# Install wxWidgets contrib modules.
cd contrib/
make
sudo make install
Note: You may also pass the --enable-universal_binary option to configure to
build a Universal binary. This will also require a Universal build of
PostgreSQL's libpq library.
A script is included in the pgAdmin source tarball
(xtra/wx-build/build-wxmac) which will install a Universal build ofwxWidgets
in each combination of shared/static/debug/release builds for you.
4) Unpack the pgAdmin tarball to a convenient location, and build and install it
as follows:
bash bootstrap # Required only if building from a GIT checkout
./configure --enable-appbundle
make all
make install
This final step will build an OSX appbundle called pgAdmin3.app in the root
of your source tree. As this can take a minute or two, the
pkg/mac/debug-bundle.sh script may be used to build a non-relocatable 'fake'
appbundle using symbolic links directly to the executable files. This
appbundle is called pgAdmin3-debug.app, and doesn't need to be rebuilt when
pgAdmin is recompiled.
If any of the prerequisite components are installed in locations that the
configure script cannot find, you may specify their locations on the command
line. See the configure help (./configure --help) for details.
4) After building pgAdmin, you will need to build an application bundle in
order to launch the application. One way to do this is to execute the
script pkg/mac/debug-bundle.sh; you can then launch pgAdmin using the open
command (e.g. open pgAdmin3-Debug.app).
Windows
-------
You will need:
- Windows 10 or above.
- Microsoft Visual C++ 2019.
- The Windows 10 Platform SDK.
- WiX toolset v3 from https://wixtoolset.org/
- wxMSW 3.0.5 or above from http://www.wxwidgets.org/
If you only want to build the pgAdmin3 binary you need the packages
- Header Files
- Development Files
- Release DLLs
If you want to build the documentation and/or the installer you additionally
need the package "Source Code".
- libssh2 1.10.0 or above from https://www.libssh2.org/
- PostgreSQL 10.19 or later (binary distribution) from http://www.postgresql.org/
- Sphinx 1.0 or above from http://sphinx.pocoo.org/
- Microsoft HTML Help Workshop
Building:
1) Unpack the wxMSW packages to a convenient location pointed to by the
%WXWIN% environment variable.
2) If you later want to build the pgAdmin3 documentation/installer you
need to build the tool "hhp2cached":
- Open a Visual Studio Developer Command Prompt
- Navigate to %WXWIN%\utils\hhp2cached\
- Run
echo SHARED = 1 >> ..\..\build\msw\config.vc
echo BUILD = release>> ..\..\build\msw\config.vc
nmake -f makefile.vc COMPILER_VERSION=142
3) Unpack PostgreSQL to a convenient location pointed to by the %PGDIR%
environment variable.
4) Unpack, compile and install libssh2 to a convenient location pointed to by the
%LIBSSH2DIR% environment variable.
5) Unpack the pgAdmin source code to a convenient location.
6) Start Visual C++ and load the pgAdmin solution file. Build the required
targets.
7) To run the resulting executable, you'll need to copy all of the
prerequisite DLLs from the wxWidgets and PostgreSQL installations into the
directory where the EXE file is located, or have those directories in your
path.