-
Notifications
You must be signed in to change notification settings - Fork 12
/
Copy pathINSTALL.en
154 lines (113 loc) · 5.12 KB
/
INSTALL.en
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
=======================================
Gfarm installation from the source code
=======================================
This distribution is fully tested on Linux. The building tests were done
on NetBSD, and Solaris.
This section describes how to build Gfarm binaries from the source
distribution. You can skip this document if you use a binary
distribution.
To build the Gfarm system, the OpenSSL library and either the OpenLDAP
library, or the PostgreSQL library are required. Regarding RPM
packages and Debian packages for them, see required package section
below.
The following is the installation procedure for the Gfarm system.
Please use GNU make on operating systems other than Linux and NetBSD.
% ./configure [options]
% make
% su
Password:
# make install
Options for configure:
--with-postgresql=directory
Specifies an installation directory for PostgreSQL. When this
option is not specified, the installation directory is searched for
automatically.
--with-openssl=PKG
Specifies a package name for OpenSSL. The default is openssl.
--with-globus=directory
Specifies an installation directory for the Globus Toolkit to utilize the
GSI authentication method. When a directory is not specified,
pkg-config is tried at first, and then the environment variable
GLOBUS_LOCATION is tried.
This is optional. The flavor of the Globus library is searched for
automatically.
If you need to specify a flavor, specify it with the
--with-globus-flavor=flavor option.
--with-infiniband=directory
Specifies to use RDMA through InfiniBand. When an original package is
installed, appoint the directory.
Memory resource limit must be enough to perform RDMA effectively.
Please edit /etc/security/limits.conf and enlarge the limit.
"* hard memlock unlimited"
--without-mtsafe-netdb
Specifies if either getaddrinfo(3) or getnameinfo(3) library function
is not multi-thread safe.
--prefix=directory
Specifies a destination directory for installation. The default is
/usr/local directory. This is optional.
--sysconfdir=directory
Specifies a directory where the ``gfarm2.conf'' configuration file is
located. The default is the ``etc'' directory under the directory
specified in the above --prefix option. This document assumes
that --sysconfdir=/etc is specified. This is optional.
--enable-voms
Enables to compile the gfvoms-sync command to synchronize Gfarm
group membership with VOMS (Virtual Organization Membership Service)
servers. This option requires Python and ZSI (Zolera SOAP
Infrastructure).
This is optional.
--enable-xmlattr
Enables XML extended attribute feature that can be queried by the
XML Path Language (XPath). For details, see manual pages of gfxattr
and gffindxmlattr. This option requires postgresql-8.3 or
later that configures with the --with-libxml option. See
http://www.postgresql.org/docs/8.3/static/install-procedure.html for
details. The -X option is also required to config-gfarm when
setting up the Gfarm file system.
This is optional.
--enable-linuxkernel
Enables to compile the Gfarm kernel driver on linux kernel 2.6.
When you need to specify a compiler program explicitly, use the
environment variable, CC. This is an example using gcc.
% env CC=gcc ./configure [options]
Required Package
----------------
* RPM Package
openssl-devel (openssl11-devel(*) required for TLS/SASL on CentOS 7)
postgresql-devel or libpq-devel
cyrus-sasl-devel (required for SASL)
scitokens-cpp-devel, cyrus-sasl-xoauth2-idp(**) (required for SASL XOAUTH2)
krb5-devel (required for Kerberos)
globus-gssapi-gsi-devel(*), pkgconfig (required for --with-globus option)
rdma-core-devel (required for --with-infiniband option)
postgresql, postgresql-server (required to execute config-gfarm)
fuse, fuse-devel, libacl-devel (required for gfarm2fs)
ganglia-gmond-python (required to execute config-gf[ms]d-iostat)
python3, python3-docopt(*), python3-schema(*) (required to execute gfptar)
ruby (required to execute gfjournal{dump,admin})
jq (required for jwt-parse)
(*) These packages are included in EPEL. EPEL packages can be used by
# yum install epel-release
(**) https://github.com/oss-tsukuba/cyrus-sasl-xoauth2-idp.git
* Debian Package
libssl-dev
libpq-dev
libsasl2-dev, sasl2-bin (required for SASL)
libscitokens-dev, cyrus-sasl-xoauth2-idp(**) (required for SASL XOAUTH2)
libkrb5-dev (required for Kerberos)
libglobus-gssapi-gsi-dev, pkgconf (required for --with-globus option)
libibverbs-dev (required for --with-infiniband option)
postgresql, postgresql-client (required to execute config-gfarm)
fuse, libfuse-dev, libacl1-dev (required for gfarm2fs)
python3, python3-docopt, python3-schema (required to execute gfptar)
ruby (required to execute gfjournal{dump,admin})
jq (required for jwt-parse)
(**) https://github.com/oss-tsukuba/cyrus-sasl-xoauth2-idp.git
Note
----
* Even if the required packages for TLS, SASL, SASL XOAUTH2, Kerberos
are missing, it is still possible to build Gfarm without these
authentication methods.
* pip (Python Package Installer) Package
orjson (If it is installed, use it to accelerate gfptar)
$Id$