Skip to content

Commit

Permalink
release note for Gfarm version 2.8.0
Browse files Browse the repository at this point in the history
  • Loading branch information
otatebe committed Sep 3, 2023
1 parent ab5cb0b commit d89021f
Show file tree
Hide file tree
Showing 3 changed files with 93 additions and 33 deletions.
34 changes: 20 additions & 14 deletions INSTALL.en
Original file line number Diff line number Diff line change
Expand Up @@ -25,22 +25,15 @@ Please use GNU make on operating systems other than Linux and NetBSD.

Options for configure:

--with-openldap=directory

Specifies an installation directory for OpenLDAP. When this
option is not specified, the installation directory is searched for
automatically.

--with-postgresql=directory

Specifies an installation directory for PostgreSQL. When this
option is not specified, the installation directory is searched for
automatically.

--with-openssl=directory
--with-openssl=PKG

Specifies an installation directory for OpenSSL. The default
directory is /usr.
Specifies a package name for OpenSSL. The default is openssl.

--with-globus=directory

Expand Down Expand Up @@ -112,26 +105,39 @@ Required Package

* RPM Package

openssl-devel
openldap-devel
openssl-devel (openssl11-devel(*) required for TLS on CentOS 7)
postgresql-devel or libpq-devel
cyrus-sasl-devel (required for SASL)
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-devel (required to build gfarm2fs)
fuse-devel, libacl-devel (required to build 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})
golang (required for jwt-agent)

(*) 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
libldap2-dev
libpq-dev
libsasl2-dev, sasl2-bin (required for SASL)
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)
libfuse-dev (required to build gfarm2fs)
libfuse-dev, libacl1-dev (required to build gfarm2fs)
python3, python3-docopt, python3-schema (required to execute gfptar)
ruby (required to execute gfjournal{dump,admin})
golang (required for jwt-agent)

(**) https://github.com/oss-tsukuba/cyrus-sasl-xoauth2-idp.git

$Id$
45 changes: 26 additions & 19 deletions INSTALL.ja
Original file line number Diff line number Diff line change
Expand Up @@ -25,22 +25,16 @@ Linux と NetBSD 以外の OS では,GNU make を使ってください.

configure コマンドには,下記のオプションがあります.

・--with-openldap=ディレクトリ

OpenLDAP のインストールされているディレクトリを指定します.
オプション省略時は自動的にインストールディレクトリの検索が試みられま
す.

・--with-postgresql=ディレクトリ

PostgreSQL のインストールされているディレクトリを指定します.
オプション省略時は自動的にインストールディレクトリの検索が試みられま
す.

・--with-openssl=ディレクトリ
・--with-openssl=パッケージ名

OpenSSL のインストールされているディレクトリを指定します
オプション省略時は /usr が指定されます.
OpenSSL のパッケージ名を指定します
オプション省略時は openssl が指定されます.

・--with-globus=ディレクトリ

Expand Down Expand Up @@ -103,42 +97,55 @@ configure コマンドには,下記のオプションがあります.
また,config-gfarm 時に -X オプションの指定が必要になります.
このオプションは省略可能です.

・--enable-linuxkernel

linux kernel 2.6 上の Gfarmカーネルドライバーを作成することを指示します。
詳しくは linux/doc/manual.{pdf,doc} を参照してください。

利用するコンパイラを明示したい場合には,環境変数 CC に,コンパイラのコ
マンド名を指定して configure を実行してください.以下は gcc を指定する
例です.

% env CC=gcc ./configure [options]

・--enable-linuxkernel

linux kernel 2.6 上の Gfarmカーネルドライバーを作成することを指示します。
詳しくは linux/doc/manual.{pdf,doc} を参照してください。

構築に必要なパッケージ
----------------------

* RPM パッケージ

openssl-devel
openldap-devel
openssl-devel (CentOS 7 で TLS を用いるためには openssl11-devel(*)が必要)
postgresql-devel or libpq-devel
cyrus-sasl-devel (SASL認証に必要)
cyrus-sasl-xoauth2-idp(**) (SASL XOAuth2 認証に必要)
krb5-devel (Kerberos 認証に必要)
globus-gssapi-gsi-devel(*), pkgconfig (--with-globus オプションに必要)
rdma-core-devel (--with-infiniband オプションに必要)
postgresql, postgresql-server (config-gfarm の実行に必要)
fuse-devel (gfarm2fs の構築に必要)
fuse-devel, libacl-devel (gfarm2fs の構築に必要)
ganglia-gmond-python (config-gf[ms]d-iostat の実行に必要)
python3, python3-docopt(*), python3-schema(*) (gfptar の実行に必要)
ruby (gfjournal{dump,admin} の実行に必要)
golang (jwt-agent の構築に必要)

(*) EPELに含まれます.EPELは以下で利用できます.
# yum install epel-release
(**) https://github.com/oss-tsukuba/cyrus-sasl-xoauth2-idp.git

* Debian パッケージ

libssl-dev
libldap2-dev
libpq-dev
libsasl2-dev sasl2-bin (SASL認証に必要)
cyrus-sasl-xoauth2-idp(**) (SASL XOAuth2 認証に必要)
libkrb5-dev (Kerberos 認証に必要)
libglobus-gssapi-gsi-dev, pkg-config (--with-globus オプションに必要)
libibverbs-dev (--with-infiniband オプションに必要)
postgresql, postgresql-client (config-gfarm の実行に必要)
libfuse-dev (gfarm2fs の構築に必要)
libfuse-dev, libacl1-dev (gfarm2fs の構築に必要)
python3, python3-docopt, python3-schema (gfptar の実行に必要)
ruby (gfjournal{dump,admin} の実行に必要)
golang (jwt-agent の構築に必要)

(**) https://github.com/oss-tsukuba/cyrus-sasl-xoauth2-idp.git

$Id$
47 changes: 47 additions & 0 deletions RELNOTES
Original file line number Diff line number Diff line change
@@ -1,3 +1,50 @@
Release note for Gfarm 2.8.0
============================

[2023.9.3]

Update note
* this release requires config-gfarm-update --update

New feature
* Transport Layer Security (TLS) for secure communication
* New authentication methods - SASL (XOAUTH2, PLAIN, ANONYMOUS) and Kerberos
* Multitenant support

New command
* gfcp - copy a file in parallel
* gfpconcat - concatinate files in parallel

New authentication method
* sasl_auth, sasl - SASL (XOAUTH2, PLAIN, ANONYMOUS) authentication in TLS.
After the authentication, sasl_auth uses a plain socket, while sasl uses TLS
secure connection.
* tls_sharedsecret, tls_client_certificate - shared secret and client
certificate authentications in TLS. Afther the authentication, both uses
TLS secure connection.
* kerberos_auth, kerberos - Kerberos authentication. After the authentication,
kerberos_auth uses a plain socket, while kerberos uses Kerberos encrypted
connection.

New configuration directive
* auth_trial_order - specify authentication order
* sasl_mechanisms, sasl_user, sasl_password - for SASL authentication
* tls_cipher_suite, tls_ca_certificate_path, tls_ca_revocation_path,
tls_ca_peer_verify_chain_path, tls_certificate_file,
tls_certificate_chain_file, tls_key_file, tls_allow_no_crl,
tls_key_update, tls_build_chain_local, tls_proxy_certificate,
tls_security_level - for TLS secure communication

Documentation
* SASL authentication and secure communication with TLS

Updated feature
* gfpcopy - -t option for parallel copy of large files. Default is 2.
* gfpcopy - -T option to specify the threshold for large files. Default is 1G.
* gfuser - -A option to specify a global name for each authentication method
* gfuser - -L option to display more user information
* gfstatus - -S option to display static settings

Release note for Gfarm 2.7.25
=============================

Expand Down

0 comments on commit d89021f

Please sign in to comment.