ArchWiki - 利用者の投稿記録 [ja]

利用者:Blackle0pard

2024-02-21T03:40:09Z

Blackle0pard: /* ArchLinuxの利用環境 */

==編集について==
* ArchWikiに記載されているとおりのコマンド・設定が実機で実行できない場合、内容の確認・編集を実施します。
* 英語が得意なわけでもなく、スキルが高いわけではないので。自分が気づいた箇所、自分に出来る範囲で取り組みます。
* 自分の編集箇所に間違い等があれば、指摘頂けると嬉しいです。
==連絡方法==
* Slack(archlinuxjp): blackle0pard
* Twitter : [https://twitter.com/blackle0pard_/ @blackle0pard_]
==ArchLinuxの利用環境==

MediaWiki

2022-04-24T12:25:57Z

Blackle0pard: アップグレードの項目を追記

[[Category:ウィキソフトウェア]]
[[en:MediaWiki]]
[https://www.mediawiki.org/wiki/MediaWiki MediaWiki] は PHP で書かれたフリーでオープンソースのウィキソフトウェアです。元は Wikipedia のために開発されました。

== インストール ==

{{Note|[[LAMP]] ではなく XAMPP を使う場合、インストール後に必要な設定が変わってきます。詳しくは [https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki_on_XAMPP こちら] を参照。}}

MediaWiki を動かすには以下の3つが必要です:

* {{pkg|mediawiki}} パッケージ
* ウェブサーバー – [[Apache]], [[Nginx]], [[Lighttpd]]
* データベースシステム – [[MariaDB]], [[PostgreSQL]], [[SQLite]], [[MySQL]]

任意で、サムネイルを表示するには {{pkg|imagemagick}} または {{pkg|php-gd}} パッケージを、Unicode 正規化を使うには {{pkg|php-intl}} パッケージもインストールしてください。

==設定==

MediaWiki を動かすには PHP の設定や MediaWiki の設定スニペットの追加などを行います。

===PHP===

まず、{{ic|/etc/php/php.ini}} の {{ic|open_basedir}} を変更して mediawiki のデータディレクトリ (デフォルトでは {{ic|/var/lib/mediawiki}}) を記述してください:

{{hc|/etc/php/php.ini|2=
open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/var/lib/mediawiki/
}}

そして、同じく {{ic|/etc/php/php.ini}} の以下の行をアンコメントします ({{ic|Dynamic Extensions}} セクションの下):
extension=gd.so
extension=intl.so
extension=iconv.so

{{Note|
* データベースとして SQLite を使いたいときは、{{ic|1=extension=pdo_sqlite.so}} もアンコメントしてください。
* データベースとして MariaDB を使いたいときは、{{ic|1=extension=mysqli.so}} もアンコメントしてください。
}}

次に、{{ic|session.save_path}} パスでセッションの処理を変更します。この設定を行わないと致命的なエラーが表示されることがあります ({{ic|PHP Fatal error: session_start(): Failed to initialize storage module[...]}})。{{ic|/var/lib/php/sessions}} や {{ic|/tmp/}} に設定するのが良いでしょう。

{{hc|/etc/php/php.ini|2=
session.save_path = "/var/lib/php/sessions"
}}

ディレクトリが存在していない場合はディレクトリを作成してパーミッションを設定してください:

{{bc|
# mkdir -p /var/lib/php/sessions/
# chown http:http /var/lib/php/sessions
# chmod go-rwx /var/lib/php/sessions
}}

=== ウェブサーバー ===

==== Apache ====

{{ic|/etc/webapps/mediawiki/apache.example.conf}} を {{ic|/etc/httpd/conf/extra/mediawiki.conf}} にコピーして必要に応じて編集してください。

以下の行を {{ic|/etc/httpd/conf/httpd.conf}} に追加:
Include conf/extra/mediawiki.conf

{{ic|httpd.service}} デーモンを[[再起動]]してください。

{{Note|デフォルトファイルの {{ic|/etc/webapps/mediawiki/apache.example.conf}} は PHP の open_basedir 設定を上書きするため、他のページに干渉することがあります。{{ic|php_admin_value}} から始まる行を {{ic|<nowiki><Directory></nowiki>}} タグの間に移動することで挙動を変更できます。さらに、同一サーバー上で複数のアプリケーションを動かす場合、{{ic|/etc/httpd/conf/extra/mediawiki.conf}} ではなく {{ic|/etc/php/php.ini}} の open_basedir に値を追加する方法もあります。}}

==== Nginx ====

[[Nginx]] で MediaWiki を動作させるには、以下のファイルを作成してください:

{{hc|/etc/nginx/mediawiki.conf|<nowiki>

location / {
index index.php;
try_files $uri $uri/ @mediawiki;
}
location @mediawiki {
rewrite ^/(.*)$ /index.php;
}
location ~ \.php5?$ {
include /etc/nginx/fastcgi_params;
fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
fastcgi_index index.php5;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
try_files $uri @mediawiki;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
try_files $uri /index.php;
expires max;
log_not_found off;
}
# Restrictions based on the .htaccess files
location ^~ ^/(cache|includes|maintenance|languages|serialized|tests|images/deleted)/ {
deny all;
}
location ^~ ^/(bin|docs|extensions|includes|maintenance|mw-config|resources|serialized|tests)/ {
internal;
}
location ^~ /images/ {
try_files $uri /index.php;
}
location ~ /\. {
access_log off;
log_not_found off;
deny all;
}
</nowiki>}}

{{Pkg|php-fpm}} をインストール・[[起動]]します。

以下のような server ディレクティブを記述してください:

{{hc|/etc/nginx/nginx.conf|
server {
listen 80;
server_name mediawiki;
root /usr/share/webapps/mediawiki;
index index.php;
charset utf-8;
# For correct file uploads
client_max_body_size 100m; # Equal or more than upload_max_filesize in /etc/php/php.ini
client_body_timeout 60;
include mediawiki.conf;

}
}}

最後に、{{ic|nginx.service}} と {{ic|php-fpm.service}} デーモンを[[再起動]]してください。

==== Lighttpd ====

インストール・設定済みの [[Lighttpd]] が必要です。lighttpd の server.modules に "mod_alias" と "mod_rewrite" が必要になります。lighttpd の設定ファイルに以下の行を追加してください:

{{hc|/etc/lighttpd/lighttpd.conf|<nowiki>
alias.url += ("/mediawiki" => "/usr/share/webapps/mediawiki/")
url.rewrite-once += (
"^/mediawiki/wiki/upload/(.+)" => "/mediawiki/wiki/upload/$1",
"^/mediawiki/wiki/$" => "/mediawiki/index.php",
"^/mediawiki/wiki/([^?]*)(?:\?(.*))?" => "/mediawiki/index.php?title=$1&$2"
)
</nowiki>}}

{{ic|lighttpd.service}} デーモンを[[再起動]]してください。

=== データベース ===

データベースサーバーが既にセットアップされている場合、MediaWiki は[[#LocalSettings.php|次のステップ]]で (設定されたデータベースの root パスワードを使って) 自動的にデータベースを作成します。自動的に作成しない場合、手動でデータベースを作成する必要があります。[https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki#Create_a_database 上流の指示] を見て下さい。

=== LocalSettings.php ===

ブラウザで wiki の url (通常は {{ic|http://''your_server''/mediawiki/}}) を開いて初期設定を行って下さい。[https://www.mediawiki.org/wiki/Manual:Config_script 上流の指示] に従って下さい。

{{ic|LocalSettings.php}} ファイルが生成されるので、ダウンロードして {{ic|/usr/share/webapps/mediawiki/LocalSettings.php}} に保存します。このファイルには wiki の設定が定義されています。{{pkg|mediawiki}} パッケージをアップグレードしても、上書きされることはありません。

== アップグレード ==

[[mw:Manual:Upgrading]]を参照してください。また、下記のコマンドを忘れずに実行してください。

# cd /usr/share/webapps/mediawiki
# php maintenance/update.php

== ヒントとテクニック ==

=== Mathematics (texvc) ===

通常通りに {{Pkg|texvc}} をインストールして設定で有効にするだけで使えます:

$wgUseTeX = true;

問題が発生したら、シェルコマンドの制限を増やして下さい:

{{bc|1=
$wgMaxShellMemory = 8000000;
$wgMaxShellFileSize = 1000000;
$wgMaxShellTime = 300;
}}

=== Unicode ===

php, apache, mysql が UTF-8 を使っていることを確認してください。エンコードが不一致だとおかしなバグが発生することがあります。

=== VisualEditor ===

MediaWiki の VisualEditor 拡張は MediaWiki にリッチテキストエディタを装備します。[https://www.mediawiki.org/wiki/Extension:VisualEditor こちらのページ] に従ってインストールしてください。

Node.js バックエンドの [https://www.mediawiki.org/wiki/Parsoid Parsoid] も必要です。[[AUR]] の {{AUR|parsoid-git}} パッケージでインストールできます。

{{ic|/usr/share/webapps/parsoid/api/localsettings.js}} の MediaWiki のパスを調整してください:

parsoidConfig.setInterwiki( 'localhost', '<nowiki>http://localhost/mediawiki/api.php</nowiki>' );

その後 {{ic|parsoid.service}} を起動・[[有効化]]してください。

もしくは {{AUR|parsoid}} パッケージを使用して yaml ファイルでサービスを設定することもできます。以下の行が必要です:

{{hc|/usr/share/webapps/parsoid/config.yaml|
<nowiki>
uri: `'http://localhost/mediawiki/api.php'`
domain: 'localhost'
</nowiki>
}}

mediawiki の設定も合わせてください:

{{hc|/usr/share/webapps/mediawiki/LocalSettings.php|
<nowiki>
$wgVirtualRestConfig['modules']['parsoid'] = array(
// URL to the Parsoid instance
// Use port 8142 if you use the Debian package
'url' => 'http://localhost:8000',
// Parsoid "domain", see below (optional)
'domain' => 'localhost',
// Parsoid "prefix", see below (optional)
'prefix' => 'localhost'
</nowiki>
}}

設定後、{{ic|parsoid}} サービスを起動・有効化してください。

MediaWiki

2022-04-24T12:17:55Z

Blackle0pard: /* インストール */ 対応するデータベースシステムにMariaDBを追記

[[Category:ウィキソフトウェア]]
[[en:MediaWiki]]
[https://www.mediawiki.org/wiki/MediaWiki MediaWiki] は PHP で書かれたフリーでオープンソースのウィキソフトウェアです。元は Wikipedia のために開発されました。

== インストール ==

{{Note|[[LAMP]] ではなく XAMPP を使う場合、インストール後に必要な設定が変わってきます。詳しくは [https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki_on_XAMPP こちら] を参照。}}

MediaWiki を動かすには以下の3つが必要です:

* {{pkg|mediawiki}} パッケージ
* ウェブサーバー – [[Apache]], [[Nginx]], [[Lighttpd]]
* データベースシステム – [[MariaDB]], [[PostgreSQL]], [[SQLite]], [[MySQL]]

任意で、サムネイルを表示するには {{pkg|imagemagick}} または {{pkg|php-gd}} パッケージを、Unicode 正規化を使うには {{pkg|php-intl}} パッケージもインストールしてください。

==設定==

MediaWiki を動かすには PHP の設定や MediaWiki の設定スニペットの追加などを行います。

===PHP===

まず、{{ic|/etc/php/php.ini}} の {{ic|open_basedir}} を変更して mediawiki のデータディレクトリ (デフォルトでは {{ic|/var/lib/mediawiki}}) を記述してください:

{{hc|/etc/php/php.ini|2=
open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/var/lib/mediawiki/
}}

そして、同じく {{ic|/etc/php/php.ini}} の以下の行をアンコメントします ({{ic|Dynamic Extensions}} セクションの下):
extension=gd.so
extension=intl.so
extension=iconv.so

{{Note|
* データベースとして SQLite を使いたいときは、{{ic|1=extension=pdo_sqlite.so}} もアンコメントしてください。
* データベースとして MariaDB を使いたいときは、{{ic|1=extension=mysqli.so}} もアンコメントしてください。
}}

次に、{{ic|session.save_path}} パスでセッションの処理を変更します。この設定を行わないと致命的なエラーが表示されることがあります ({{ic|PHP Fatal error: session_start(): Failed to initialize storage module[...]}})。{{ic|/var/lib/php/sessions}} や {{ic|/tmp/}} に設定するのが良いでしょう。

{{hc|/etc/php/php.ini|2=
session.save_path = "/var/lib/php/sessions"
}}

ディレクトリが存在していない場合はディレクトリを作成してパーミッションを設定してください:

{{bc|
# mkdir -p /var/lib/php/sessions/
# chown http:http /var/lib/php/sessions
# chmod go-rwx /var/lib/php/sessions
}}

=== ウェブサーバー ===

==== Apache ====

{{ic|/etc/webapps/mediawiki/apache.example.conf}} を {{ic|/etc/httpd/conf/extra/mediawiki.conf}} にコピーして必要に応じて編集してください。

以下の行を {{ic|/etc/httpd/conf/httpd.conf}} に追加:
Include conf/extra/mediawiki.conf

{{ic|httpd.service}} デーモンを[[再起動]]してください。

{{Note|デフォルトファイルの {{ic|/etc/webapps/mediawiki/apache.example.conf}} は PHP の open_basedir 設定を上書きするため、他のページに干渉することがあります。{{ic|php_admin_value}} から始まる行を {{ic|<nowiki><Directory></nowiki>}} タグの間に移動することで挙動を変更できます。さらに、同一サーバー上で複数のアプリケーションを動かす場合、{{ic|/etc/httpd/conf/extra/mediawiki.conf}} ではなく {{ic|/etc/php/php.ini}} の open_basedir に値を追加する方法もあります。}}

==== Nginx ====

[[Nginx]] で MediaWiki を動作させるには、以下のファイルを作成してください:

{{hc|/etc/nginx/mediawiki.conf|<nowiki>

location / {
index index.php;
try_files $uri $uri/ @mediawiki;
}
location @mediawiki {
rewrite ^/(.*)$ /index.php;
}
location ~ \.php5?$ {
include /etc/nginx/fastcgi_params;
fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
fastcgi_index index.php5;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
try_files $uri @mediawiki;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
try_files $uri /index.php;
expires max;
log_not_found off;
}
# Restrictions based on the .htaccess files
location ^~ ^/(cache|includes|maintenance|languages|serialized|tests|images/deleted)/ {
deny all;
}
location ^~ ^/(bin|docs|extensions|includes|maintenance|mw-config|resources|serialized|tests)/ {
internal;
}
location ^~ /images/ {
try_files $uri /index.php;
}
location ~ /\. {
access_log off;
log_not_found off;
deny all;
}
</nowiki>}}

{{Pkg|php-fpm}} をインストール・[[起動]]します。

以下のような server ディレクティブを記述してください:

{{hc|/etc/nginx/nginx.conf|
server {
listen 80;
server_name mediawiki;
root /usr/share/webapps/mediawiki;
index index.php;
charset utf-8;
# For correct file uploads
client_max_body_size 100m; # Equal or more than upload_max_filesize in /etc/php/php.ini
client_body_timeout 60;
include mediawiki.conf;

}
}}

最後に、{{ic|nginx.service}} と {{ic|php-fpm.service}} デーモンを[[再起動]]してください。

==== Lighttpd ====

インストール・設定済みの [[Lighttpd]] が必要です。lighttpd の server.modules に "mod_alias" と "mod_rewrite" が必要になります。lighttpd の設定ファイルに以下の行を追加してください:

{{hc|/etc/lighttpd/lighttpd.conf|<nowiki>
alias.url += ("/mediawiki" => "/usr/share/webapps/mediawiki/")
url.rewrite-once += (
"^/mediawiki/wiki/upload/(.+)" => "/mediawiki/wiki/upload/$1",
"^/mediawiki/wiki/$" => "/mediawiki/index.php",
"^/mediawiki/wiki/([^?]*)(?:\?(.*))?" => "/mediawiki/index.php?title=$1&$2"
)
</nowiki>}}

{{ic|lighttpd.service}} デーモンを[[再起動]]してください。

=== データベース ===

データベースサーバーが既にセットアップされている場合、MediaWiki は[[#LocalSettings.php|次のステップ]]で (設定されたデータベースの root パスワードを使って) 自動的にデータベースを作成します。自動的に作成しない場合、手動でデータベースを作成する必要があります。[https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki#Create_a_database 上流の指示] を見て下さい。

=== LocalSettings.php ===

ブラウザで wiki の url (通常は {{ic|http://''your_server''/mediawiki/}}) を開いて初期設定を行って下さい。[https://www.mediawiki.org/wiki/Manual:Config_script 上流の指示] に従って下さい。

{{ic|LocalSettings.php}} ファイルが生成されるので、ダウンロードして {{ic|/usr/share/webapps/mediawiki/LocalSettings.php}} に保存します。このファイルには wiki の設定が定義されています。{{pkg|mediawiki}} パッケージをアップグレードしても、上書きされることはありません。

== ヒントとテクニック ==

=== Mathematics (texvc) ===

通常通りに {{Pkg|texvc}} をインストールして設定で有効にするだけで使えます:

$wgUseTeX = true;

問題が発生したら、シェルコマンドの制限を増やして下さい:

{{bc|1=
$wgMaxShellMemory = 8000000;
$wgMaxShellFileSize = 1000000;
$wgMaxShellTime = 300;
}}

=== Unicode ===

php, apache, mysql が UTF-8 を使っていることを確認してください。エンコードが不一致だとおかしなバグが発生することがあります。

=== VisualEditor ===

MediaWiki の VisualEditor 拡張は MediaWiki にリッチテキストエディタを装備します。[https://www.mediawiki.org/wiki/Extension:VisualEditor こちらのページ] に従ってインストールしてください。

Node.js バックエンドの [https://www.mediawiki.org/wiki/Parsoid Parsoid] も必要です。[[AUR]] の {{AUR|parsoid-git}} パッケージでインストールできます。

{{ic|/usr/share/webapps/parsoid/api/localsettings.js}} の MediaWiki のパスを調整してください:

parsoidConfig.setInterwiki( 'localhost', '<nowiki>http://localhost/mediawiki/api.php</nowiki>' );

その後 {{ic|parsoid.service}} を起動・[[有効化]]してください。

もしくは {{AUR|parsoid}} パッケージを使用して yaml ファイルでサービスを設定することもできます。以下の行が必要です:

{{hc|/usr/share/webapps/parsoid/config.yaml|
<nowiki>
uri: `'http://localhost/mediawiki/api.php'`
domain: 'localhost'
</nowiki>
}}

mediawiki の設定も合わせてください:

{{hc|/usr/share/webapps/mediawiki/LocalSettings.php|
<nowiki>
$wgVirtualRestConfig['modules']['parsoid'] = array(
// URL to the Parsoid instance
// Use port 8142 if you use the Debian package
'url' => 'http://localhost:8000',
// Parsoid "domain", see below (optional)
'domain' => 'localhost',
// Parsoid "prefix", see below (optional)
'prefix' => 'localhost'
</nowiki>
}}

設定後、{{ic|parsoid}} サービスを起動・有効化してください。

ロケール

2021-12-11T08:10:46Z

Blackle0pard: /* システム全体のロケールを設定する */ : 追加の設定ではなく、代替の設定手順なので日本語の表記を修正。

[[Category:地域化]]
[[ar:Locale]]
[[cs:Locale]]
[[de:Locale]]
[[en:Locale]]
[[es:Locale]]
[[fr:Locale]]
[[it:Locale]]
[[ko:Locale]]
[[pt:Locale]]
[[ru:Locale]]
[[zh-hans:Locale]]
{{Related articles start}}
{{Related|環境変数}}
{{Related|地域化}}
{{Related articles end}}
ロケール (Locale) は {{Pkg|glibc}} などのロケールに対応しているプログラムやライブラリによって使われ、テキストのレンダリング、時刻や日付、地域通貨の正しい表示、アルファベットなどの決まり事が設定されます。

== ロケールの生成 ==

ロケール名は基本的に {{ic|language[_territory][.codeset][@modifier]}} という形式になっています。''language'' は [[w:ja:ISO 639-1コード一覧|ISO 639 言語コード]]、''territory'' は [[w:ja:ISO_3166-1|ISO 3166 国名コード]]、''codeset'' は[[w:ja:文字集合|文字集合]]または [[w:ja:ISO/IEC 8859-1|ISO-8859-1]] や [[w:ja:UTF-8|UTF-8]] などのエンコーディングです。詳しくは {{man|3|setlocale}} を参照してください。

利用可能なロケールのリストを確認するには、以下のコマンドを実行:

$ locale -a

システムでロケールを利用するには、まず生成する必要があります。{{ic|/etc/locale.gen}} の中の適当なエントリをアンコメントして ''locale-gen'' を実行することで生成できます。同じく、エントリをコメントアウトするとロケールは無効になります。変更するときは、システム上の他のユーザーが必要としている言語や特定の[[#変数|変数]]にも注意してください。

例えば日本語の {{ic|ja_JP.UTF-8 UTF-8}} をアンコメントする場合:

{{hc|/etc/locale.gen|
...
#ja_JP.EUC-JP EUC-JP
ja_JP.UTF-8 UTF-8
#ka_GE.UTF-8 UTF-8
...
}}

ファイルを保存して、ロケールを生成:

# locale-gen

{{Note|1=<nowiki></nowiki>
* {{ic|locale-gen}} は {{Pkg|glibc}} のアップデート時に毎回実行されます [https://github.com/archlinux/svntogit-packages/blob/packages/glibc/trunk/glibc.install#L5]。
* {{ic|UTF-8}} を使用することが推奨されています [https://utf8everywhere.org/]。}}

== ロケールの設定 ==

現在設定されているロケールと関連する環境設定を確認するには:

$ locale

使用するロケールは {{ic|locale.conf}} ファイルに設定します。ファイルの中では1行毎に[[環境変数]]を設定します。''locale'' の出力と同じフォーマットです。

生成済みの利用可能なロケールを確認するには:

$ localedef --list-archive

もしくは {{man|1|localectl}} を使用:

$ localectl list-locales

=== システム全体のロケールを設定する ===

システム全体のロケールを設定するには {{ic|LANG}} 変数を {{ic|/etc/locale.conf}} に書き込みます。使用するロケールは {{ic|/etc/locale.gen}} でアンコメントしたエントリの最初のカラムと同じです:

{{hc|1=/etc/locale.conf|2=
LANG=''ja_JP.UTF-8''
}}

{{ic|/etc/locale.conf}} を修正する代わりに、以下のコマンドを実行することでも設定可能:

# localectl set-locale LANG=''ja_JP.UTF-8''

他の設定など詳しくは[[#変数|変数]]や {{man|5|locale.conf}} を参照。

=== ユーザーセッションでシステムロケールを上書き ===

システム全体のロケールは {{ic|~/.config/locale.conf}} (または {{ic|$XDG_CONFIG_HOME/locale.conf}} や {{ic|$HOME/.config/locale.conf}}) を作成・編集することでユーザーセッションで上書きできます。

{{ic|locale.conf}} ファイルの優先順位は {{ic|/etc/profile.d/locale.sh}} で定義されています。

{{Tip|
* {{ic|/var/log}} のログは英語のままで、ユーザー環境では自分の言語を使うということが可能です。
* {{ic|/etc/skel/.config/locale.conf}} ファイルを作成することで ''useradd'' と {{ic|-m}} オプションで追加された新しいユーザーの {{ic|~/.config/locale.conf}} が自動的に生成されます。}}

=== ロケールを即座に変更する ===

システムやユーザーの {{ic|locale.conf}} ファイルを作成・編集した場合、新しく設定した値は次にログインしたときに有効になります。新しい設定をすぐに使うには {{ic|LANG}} の設定を解除して {{ic|/etc/profile.d/locale.sh}} を source してください:

$ unset LANG
$ source /etc/profile.d/locale.sh

{{Note|最初に {{ic|LANG}} 変数の設定を解除しないと、{{ic|locale.sh}} は {{ic|locale.conf}} の値を反映しません。新しい、変更した変数だけが反映されます。{{ic|locale.conf}} から削除した値はセッション内で残り続けます。}}

=== 他の使用方法 ===

[[環境変数]]で説明されている方法でロケール変数を定義することも可能です。

例えば、開発中に特定のアプリケーションをテスト・デバッグしたいとき、以下のように起動することができます:

$ LANG=C ./my_application.sh

同じく、現在のシェルから実行する全てのプロセルにロケールを設定するには (例えば、システムのインストール中などに使うと有用です):

$ export LANG=C

== 変数 ==

{{ic|locale.conf}} ファイルは以下の環境変数をサポートしています:

* [[#LANG: デフォルトロケール|LANG]]
* [[#LANGUAGE: フォールバックロケール|LANGUAGE]]
* {{ic|LC_ADDRESS}}
* [[#LC_COLLATE: 照合順序|LC_COLLATE]]
* {{ic|LC_CTYPE}}
* {{ic|LC_IDENTIFICATION}}
* {{ic|LC_MEASUREMENT}}
* {{ic|LC_MESSAGES}}
* {{ic|LC_MONETARY}}
* {{ic|LC_NAME}}
* {{ic|LC_NUMERIC}}
* {{ic|LC_PAPER}}
* {{ic|LC_TELEPHONE}}
* [[#LC_TIME: 日付と時刻の形式|LC_TIME]]

上記の {{ic|LC_*}} 変数の意味は {{man|7|locale}} の man ページに、詳しい説明は {{man|5|locale}} の man ページに存在します。

{{Note|複数の環境変数が設定されている場合の優先順位は [[https://www.gnu.org/software/gettext/manual/gettext.html#Locale-Environment-Variables GNU gettext のドキュメント]]に述べられています。

=== LANG: デフォルトロケール ===

この変数で設定されたロケールは {{ic|LC_*}} 変数全てで使われます (明示的に別のロケールを設定した場合はそちらが優先されます)。

例えば、数値や日付などはスペイン語表記にしつつメッセージを英語で表示するには、{{ic|LANG}} を {{ic|es_ES.UTF-8}} に、{{ic|LC_MESSAGES}} を {{ic|en_US.UTF-8}} に設定します。

=== LANGUAGE: フォールバックロケール ===

{{Pkg|gettext}} を使って翻訳されたプログラムは通常の変数に加えて {{Ic|LANGUAGE}} オプションも認識します。ユーザーは [https://www.gnu.org/software/gettext/manual/gettext.html#The-LANGUAGE-variable ロケールの使用順序] を指定することが可能です。もし一番使用したい言語が使えない場合、デフォルトのロケールの代わりに別の似たようなロケールが使われます。例えば、アメリカ流の綴りよりも英国流の綴りを好むオーストラリアのユーザーの場合:

{{hc|locale.conf|2=
LANG=en_AU.UTF-8
LANGUAGE=en_AU:en_GB:en
}}

=== LC_TIME: 日付と時刻の形式 ===

例えば {{ic|LC_TIME}} が {{ic|en_US.UTF-8}} に設定されていた場合、日付フォーマットは "MM/DD/YYYY" になります。ISO 8601 の日付フォーマットである "YYYY-MM-DD" を使いたい場合:

{{hc|locale.conf|2=
LC_TIME=en_DK.UTF-8
}}

{{Note|1=プログラムは必ずしも変数によって指定されたフォーマットで日付を表示するとは限りません。例えば {{man|1|date}} は別のパラメータを使って指定するようになっています。また [[Firefox]] 57以降では {{ic|LC_TIME}} が考慮されていません ([https://bugzilla.mozilla.org/show_bug.cgi?id=1429578 Bug 1429578])。}}

=== LC_COLLATE: 照合順序 ===

ソートや正規表現で使われる照合順序を管理する変数です。

例えば値を {{ic|C}} に設定することで ''ls'' コマンドはドットファイルを先に表示して、大文字・小文字のファイル名を後にします:

{{hc|locale.conf|2=
LC_COLLATE=C
}}

詳しくは [https://superuser.com/a/448294/175967] を参照してください。

潜在的な問題を回避するため、Arch では以前 {{ic|/etc/profile}} で {{ic|1=LC_COLLATE=C}} と設定していましたが、現在は使われなくなっています。

=== LC_ALL: トラブルシューティング ===

この変数で設定されたロケールは常に {{ic|LANG}} と他の {{ic|LC_*}} 変数よりも優先して使われます。

{{ic|LC_ALL}} は {{ic|locale.conf}} ファイルで設定できない唯一の {{ic|LC_*}} 変数です。あくまで {{ic|/etc/profile}} などで使うテスト用あるいはトラブルシューティング用の変数です。

== トラブルシューティング ==

=== ターミナルが UTF-8 をサポートしていません ===

以下は UTF-8 をサポートしているターミナルのリストです:

* gnustep-terminal
* konsole
* [[mlterm]]
* [[rxvt-unicode]]
* [[st]]
* [[termite]]
* [[アプリケーション一覧/ユーティリティ#VTE ベース|VTE ベースのターミナル]]
* [[xterm]] - {{ic|-u8}} 引数を使って実行するか [[X resources]] で {{ic|xterm*utf8: 2}} を設定してください。

==== Gnome-terminal や rxvt-unicode ====

UTF-8 のロケールからアプリケーションを起動する必要があり、それ以外のロケールを使用していると UTF-8 のサポートが有効になりません。上で書いているように {{ic|en_US.UTF-8}} ロケール (またはあなたの地域の UTF-8 ロケール) を生成し、デフォルトのロケールとして設定して再起動してください。

=== 設定を変更しても言語が変わらない ===

{{ic|locale.conf}} 以外の他のファイルによって環境変数が再定義されている可能性があります (例: {{ic|~/.pam_environment}})。詳しくは[[環境変数#変数の定義]]を参照してください。

[[GNOME]] などのデスクトップ環境を使用している場合、{{ic|locale.conf}} の設定がデスクトップ環境の言語設定で上書きされることがあります。
[[KDE]] Plasma も UI の言語を Plsama 側で変更できます。変更後にもデフォルト言語が表示されている場合、[https://bbs.archlinux.org/viewtopic.php?pid=1435219#p1435219] にあるように {{ic|~/.config/plasma-localerc}} を削除すると解決する場合があります。

[[LightDM]] の場合、ユーザーセッションが記録されるファイル {{ic|~/.dmrc}} から意図しないロケールが読み込まれる可能性があります。

== 参照 ==

* [https://wiki.gentoo.org/wiki/Localization/Guide/ja Gentoo Linux ローカリゼーションガイド]
* [http://demo.icu-project.org/icu-bin/locexp?_=en_US&x=col ICU's interactive collation testing]
* [http://www.openi18n.org/ Free Standards Group Open Internationalisation Initiative]
* [http://pubs.opengroup.org/onlinepubs/007908799/xbd/locale.html ''The Single UNIX Specification'' definition of Locale] by The Open Group
* [https://help.ubuntu.com/community/EnvironmentVariables#Locale_setting_variables Locale environment variables]

2021-05-14T11:53:27Z

Blackle0pard: 英語版に合わせて、「Code managers」の項目を追加

[[Category:認証]]
[[Category:Google]]
[[en:Google Authenticator]]
[[es:Google Authenticator]]
[[ru:Google Authenticator]]
[[zh-hans:Google Authenticator]]
[https://github.com/google/google-authenticator Google Authenticator] はワンタイムパスコード (OTP) による2段階認証を提供します。OTP 生成アプリケーションは iOS, Android, Blackberry で利用できます。[[S/KEY 認証]]と同じように認証機構は Linux の [[PAM]] システムに統合されています。このガイドではこの機構をインストール・設定する方法を示します。

==インストール==

{{Pkg|libpam-google-authenticator}} パッケージをインストールしてください。開発版は {{AUR|google-authenticator-libpam-git}} でインストールできます。

==PAM の設定==

{{Warning|SSH で設定を行っている場合は、全てが動作するか確認する前にセッションを終了してはいけません。自分自身をロックアウトしてしまう危険があります。また、PAM を有効にする前にキーファイルを生成するようにしてください。}}

大抵は2段階認証が必要になるのはリモートログインのときだけです。該当する PAM 設定ファイルは {{ic|/etc/pam.d/sshd}} です。Google Authenticator をあらゆるところで使いたい場合、{{ic|/etc/pam.d/system-auth}} に変更を加えます。ただし、その場合は自分を締め出してしまわないように細心の注意を払って下さい。このガイドでは {{ic|/etc/pam.d/sshd}} を編集するので、ローカルセッションではとりあえず安全に設定することができます (絶対安全というわけではありません)。

Unix パスワードと OTP の両方を入力するために {{ic|pam_google_authenticator.so}} を以下のように {{ic|/etc/pam.d/sshd}} の system-remote-login 行の上に追加します:

'''auth required pam_google_authenticator.so'''
auth include system-remote-login
account include system-remote-login
password include system-remote-login
session include system-remote-login

こうすると Unix パスワードの前に OTP を尋ねるようになります。2つのモジュールの順番を入れ替えると訊かれる順序が逆になります。

{{Warning|秘密鍵ファイルを生成したユーザーだけが SSH を使ってログインできるようになります (下を参照)。}}

OTP または Unix パスワードのどちらかでログインできるようにするには:

auth '''sufficient''' pam_google_authenticator.so

{{ic|/etc/ssh/'''sshd_config'''}} でチャレンジレスポンス認証を有効にします:
ChallengeResponseAuthentication yes
そして {{ic|sshd}} の設定をリロードしてください:
# systemctl reload sshd

{{Warning|SSH 鍵のペアによる認証を使っていて[[SSH 鍵#パスワードログインの無効化|パスワードログインを無効化]]していた場合、OpenSSH はこれら全ての設定を無視します。ただし、OpenSSH 6.2 から、{{ic|AuthenticationMethods}} を追加することで2段階認証と鍵による認証の両方を使うことができるようになっています。[[SSH 鍵#2段階認証と公開鍵]] を見て下さい。}}

==秘密鍵ファイルの生成==

{{Tip|QR コードを生成するには {{Pkg|qrencode}} をインストールします。認証アプリで QR コードをスキャンすれば自動的に鍵が設定されます。}}

2段階認証を使用したい場合はユーザーのホームフォルダに秘密鍵ファイルを生成する必要があります。''google-authenticator'' を使うことでとても簡単に生成することができます:

$ google-authenticator
Do you want authentication tokens to be time-based (y/n) y
<Here you will see generated QR code>
Your new secret key is: ZVZG5UZU4D7MY4DH
Your verification code is 269371
Your emergency scratch codes are:
70058954
97277505
99684896
56514332
82717798

Do you want me to update your "/home/username/.google_authenticator" file (y/n) y

Do you want to disallow multiple uses of the same authentication
token? This restricts you to one login about every 30s, but it increases
your chances to notice or even prevent man-in-the-middle attacks (y/n) y

By default, tokens are good for 30 seconds and in order to compensate for
possible time-skew between the client and the server, we allow an extra
token before and after the current time. If you experience problems with poor
time synchronization, you can increase the window from its default
size of 1:30min to about 4min. Do you want to do so (y/n) n

If the computer that you are logging into is not hardened against brute-force
login attempts, you can enable rate-limiting for the authentication module.
By default, this limits attackers to no more than 3 login attempts every 30s.
Do you want to enable rate-limiting (y/n) y

緊急時のスクラッチコードを安全なところに保管しておくことを推奨します (例: コードを印刷して金庫にしまう)。携帯電話 (つまり OTP 生成ツール) をなくしてしまったときの唯一の (SSH による) ログイン手段となります。コードは {{ic|~/.google_authenticator}} にも保存されるので、ログインしている間はいつでも確認することが可能です。

==OTP 生成ツールの設定==
下記から携帯電話に生成ツールをインストールしてください。

* '''FreeOTP''' for [https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp Android]/[https://itunes.apple.com/es/app/freeotp-authenticator/id872559395 iOS].
* '''Google Authenticator''' for [https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2 Android]/[https://itunes.apple.com/es/app/google-authenticator/id388497605 iOS].

アプリケーションメニューから適切なボタンをクリックして新しいアカウントを作成し、秘密鍵ファイルを生成したときに表示される URL から QR コードをスキャンするか、秘密鍵を手動で入力します (上の例では 'ZVZG5UZU4D7MY4DH')。

これで30秒ごとに新しく生成されるパスコードトークンをあなたの携帯で見ることができます。

==テスト==
他のマシンや他のターミナルウィンドウからホストに SSH で接続して認証システムが動作しているか確認してください:

$ ssh hostname
login as: <username>
Verification code: <generated/backup-code>
Password: <password>
$

==秘密鍵の保存場所==
秘密鍵ファイルの置き場所を変更したい場合、{{ic|--secret}} フラグを使います:

$ google-authenticator --secret="/'''PATH_FOLDER'''/'''USERNAME'''"

{{ic|/etc/pam.d/sshd}} を編集して PAM の設定も忘れずに変更してください:

{{hc|/etc/pam.d/sshd|2=
auth required pam_google_authenticator.so user=root secret=/'''PATH_FOLDER'''/${USER}
}}

{{ic|user=root}} を使うことで PAM は root ユーザーでファイルを検索します。

また、秘密鍵ファイルのパーミッションに注意してください。所有者だけがファイルを読み込めるように設定してください。例えば root を所有者とする場合:

# chown root:root /'''PATH_FILE'''/'''SECRET_KEY_FILES'''
# chmod 400 /'''PATH_FILE'''/'''SECRET_KEY_FILES'''

==デスクトップログイン==
Google Authenticator の PAM プラグインをコンソールのログインや [[GDM]] のログインで使うこともできます。以下を {{ic|/etc/pam.d/login}} または {{ic|/etc/pam.d/gdm-password}} ファイルに追加してください:

auth required pam_google_authenticator.so

== コードの生成 ==

If you have Google Authenticator configured with other systems, then losing your device can prevent you from being able to log in to those systems. Having additional ways to generate the codes can be helpful.

=== コードの管理 ===

A script that enables the display, generation, storage and management of google authenticator codes is available from the AUR ({{AUR|gashell}}). Alternatively there is also auther ({{AUR|auther-git}}).

=== コマンドライン ===

The easiest way to generate codes is with {{ic|oath-tool}}. It is available in the {{Pkg|oath-toolkit}} package, and can be used as follows:

$ oathtool --totp -b ''secret key''

On most Android systems with sufficient user access, the Google Authenticator database can be copied off the device and accessed directly, as it is an sqlite3 database. This shell script will read a Google Authenticator database and generate live codes for each key found:

{{hc|google-authenticator.sh|2=
#!/bin/sh

# This is the path to the Google Authenticator app file. It's typically located
# in /data under Android. Copy it to your PC in a safe location and specify the
# path to it here.
DB="/path/to/com.google.android.apps.authenticator/databases/databases"

sqlite3 "$DB" 'SELECT email,secret FROM accounts;' {{!}} while read A
do
NAME=`echo "$A" {{!}} cut -d '{{!}}' -f 1`
KEY=`echo "$A" {{!}} cut -d '{{!}}' -f 2`
CODE=`oathtool --totp -b "$KEY"`
echo -e "\e[1;32m$CODE\e[0m - \e[1;33m$NAME\e[0m"
done
}}

Google Authenticator

2021-05-14T11:47:29Z

Blackle0pard: /* OTP 生成ツールの設定 */ 　英語版に合わせて紹介のツールを変更

Logrotate

2021-05-11T02:39:30Z

Blackle0pard: /* ログの圧縮 */ typo

[[Category:ロギング]]
[[Category:データ圧縮とアーカイブ]]
[[en:Logrotate]]
{{Related articles start}}
{{Related|Cron}}
{{Related|systemd/タイマー}}
{{Related articles end}}

https://github.com/logrotate/logrotate より:

:''ログファイルが大量に生成されるシステムで、ログファイルの管理を簡単にするために logrotate ユーティリティは作られました。Logrotate はログファイルの自動的なローテーション圧縮や削除、メール送信などを可能にします。Logrotate を設定することで、ログファイルを毎日毎周毎月ごとに管理したり、特定のサイズまで達した時の動作を決められます。''

logrotate の''ローテーション''では、既存のログファイルに数字を割り振って名前を変更し、元の''空の''ログファイルを再作成します。例えば、{{ic|/var/log/syslog.log}} は {{ic|/var/log/syslog.log.1}} に名前が変更されます。{{ic|/var/log/syslog.log.1}} が既に存在する場合、名前は {{ic|/var/log/syslog.log.2}} に変更されます (バックログの数は設定で変えられます)。

==インストール==

Logrotate は {{Pkg|logrotate}} パッケージでインストールできます。

<s>デフォルトでは、logrotate は [[systemd/タイマー|systemd タイマー]]によって毎日動作します: {{ic|logrotate.timer}}</s>

日次でlogrotateの実行を有効にするには次のコマンドを利用します。

{{bc|
# systemctl enable logrotate.timer
}}
{{bc|
# systemctl start logrotate.timer
}}
{{hc|
# systemctl status logrotate.timer
|
● logrotate.timer - Daily rotation of log files
Loaded: loaded (/usr/lib/systemd/system/logrotate.timer; enabled; vendor preset: disabled)
Active: active (waiting) since Sun 2020-06-08 xx:xx:xx JST; 5s ago
Trigger: Mon 2020-06-08 00:00:00 JST; 56min left
Triggers: ● logrotate.service
Docs: man:logrotate(8)
man:logrotate.conf(5)
}}
{{hc|
# systemctl list-timers
|
NEXT LEFT LAST PASSED UNIT ACTIVATE
Mon 2020-06-08 00:00:00 JST 12h left n/a n/a logrotate.timer logrotate.service
}}

==設定==

logrotate の一番重要な設定ファイルは {{ic|/etc/logrotate.conf}} です。また、{{ic|/etc/logrotate.d}} ディレクトリには他の設定ファイルが含まれています。

logrotate が正しく動作するか確認するには、以下のコマンドを実行してください。デバッグ出力が生成されます:
{{bc|# logrotate --debug /etc/logrotate.conf}}
logrotate スクリプトをテストするには (例えば {{ic|/etc/logrotate.d}} ディレクトリの nginx スクリプト)、以下のように実行してみてください:
{{bc|# logrotate -f -v /etc/logrotate.d/nginx}}

=== ログの圧縮 ===

{{ic|zstd}}のようなコマンドを使って、ログローテーション時にログを圧縮することが出来ます。

{{hc|/etc/logrotate.conf|
compress
compresscmd /usr/bin/zstd
compressext .zst
compressoptions -T0 --long
uncompresscmd /usr/bin/unzstd
}}

詳細は[https://man.archlinux.org/man/logrotate.conf.5 logrotate.conf(5)]や [https://man.archlinux.org/man/zstd.1 zstd] を確認して下さい。

==トラブルシューティング==

=== exim のログがローテーションされない ===

{{ic|/etc/logrotate.conf}} に {{ic|olddir}} 変数を設定した場合、以下のようなメッセージが表示されます:

{{Ic|error: failed to rename /var/log/exim/mainlog to /var/log/old/mainlog.1: Permission denied}}

この問題を修正するには、ユーザー {{ic|exim}} をグループ {{ic|log}} に追加してください。そして {{ic|olddir}} ({{ic|/var/log/old}}) のグループをデフォルトの {{ic|root}} から {{ic|log}} に変更してください。

=== logrotate の状態を確認 ===
{{ic|cat /var/lib/logrotate.status}} を実行することで logroate によってローテートされているファイルを確認できます:
{{hc| # cat /var/lib/logrotate.status |
"/var/log/mysql/query.log" 2016-3-20-5:0:0
"/var/log/samba/samba-smbd.log" 2016-3-21-5:0:0
"/var/log/httpd/access_log" 2016-3-20-5:0:0
}}

== 参照 ==

* [https://wiki.gentoo.org/wiki/Logrotate Logrotate on Gentoo Linux Wiki]
* [https://man.archlinux.org/man/logrotate.8 logrotate(8) Manual page]
* [https://man.archlinux.org/man/logrotate.conf.5 logrotate.conf(5) Manual page]

Logrotate

2021-05-11T02:34:16Z

Blackle0pard: /* 設定 */ 英語版に合わせて「ログの圧縮」を追加。コマンドの書き方を修正。

[[Category:ロギング]]
[[Category:データ圧縮とアーカイブ]]
[[en:Logrotate]]
{{Related articles start}}
{{Related|Cron}}
{{Related|systemd/タイマー}}
{{Related articles end}}

https://github.com/logrotate/logrotate より:

:''ログファイルが大量に生成されるシステムで、ログファイルの管理を簡単にするために logrotate ユーティリティは作られました。Logrotate はログファイルの自動的なローテーション圧縮や削除、メール送信などを可能にします。Logrotate を設定することで、ログファイルを毎日毎周毎月ごとに管理したり、特定のサイズまで達した時の動作を決められます。''

logrotate の''ローテーション''では、既存のログファイルに数字を割り振って名前を変更し、元の''空の''ログファイルを再作成します。例えば、{{ic|/var/log/syslog.log}} は {{ic|/var/log/syslog.log.1}} に名前が変更されます。{{ic|/var/log/syslog.log.1}} が既に存在する場合、名前は {{ic|/var/log/syslog.log.2}} に変更されます (バックログの数は設定で変えられます)。

==インストール==

Logrotate は {{Pkg|logrotate}} パッケージでインストールできます。

<s>デフォルトでは、logrotate は [[systemd/タイマー|systemd タイマー]]によって毎日動作します: {{ic|logrotate.timer}}</s>

日次でlogrotateの実行を有効にするには次のコマンドを利用します。

{{bc|
# systemctl enable logrotate.timer
}}
{{bc|
# systemctl start logrotate.timer
}}
{{hc|
# systemctl status logrotate.timer
|
● logrotate.timer - Daily rotation of log files
Loaded: loaded (/usr/lib/systemd/system/logrotate.timer; enabled; vendor preset: disabled)
Active: active (waiting) since Sun 2020-06-08 xx:xx:xx JST; 5s ago
Trigger: Mon 2020-06-08 00:00:00 JST; 56min left
Triggers: ● logrotate.service
Docs: man:logrotate(8)
man:logrotate.conf(5)
}}
{{hc|
# systemctl list-timers
|
NEXT LEFT LAST PASSED UNIT ACTIVATE
Mon 2020-06-08 00:00:00 JST 12h left n/a n/a logrotate.timer logrotate.service
}}

==設定==

logrotate の一番重要な設定ファイルは {{ic|/etc/logrotate.conf}} です。また、{{ic|/etc/logrotate.d}} ディレクトリには他の設定ファイルが含まれています。

logrotate が正しく動作するか確認するには、以下のコマンドを実行してください。デバッグ出力が生成されます:
{{bc|# logrotate --debug /etc/logrotate.conf}}
logrotate スクリプトをテストするには (例えば {{ic|/etc/logrotate.d}} ディレクトリの nginx スクリプト)、以下のように実行してみてください:
{{bc|# logrotate -f -v /etc/logrotate.d/nginx}}

=== ログの圧縮 ===

{{ic|zstd}}のようなコマンドを使って、ログローテーション時にログを圧縮することが出来ます。

{{hc|# /etc/logrotate.conf|
compress
compresscmd /usr/bin/zstd
compressext .zst
compressoptions -T0 --long
uncompresscmd /usr/bin/unzstd
}}

詳細は[https://man.archlinux.org/man/logrotate.conf.5 logrotate.conf(5)]や [https://man.archlinux.org/man/zstd.1 zstd] を確認して下さい。

==トラブルシューティング==

=== exim のログがローテーションされない ===

{{ic|/etc/logrotate.conf}} に {{ic|olddir}} 変数を設定した場合、以下のようなメッセージが表示されます:

{{Ic|error: failed to rename /var/log/exim/mainlog to /var/log/old/mainlog.1: Permission denied}}

この問題を修正するには、ユーザー {{ic|exim}} をグループ {{ic|log}} に追加してください。そして {{ic|olddir}} ({{ic|/var/log/old}}) のグループをデフォルトの {{ic|root}} から {{ic|log}} に変更してください。

=== logrotate の状態を確認 ===
{{ic|cat /var/lib/logrotate.status}} を実行することで logroate によってローテートされているファイルを確認できます:
{{hc| # cat /var/lib/logrotate.status |
"/var/log/mysql/query.log" 2016-3-20-5:0:0
"/var/log/samba/samba-smbd.log" 2016-3-21-5:0:0
"/var/log/httpd/access_log" 2016-3-20-5:0:0
}}

== 参照 ==

* [https://wiki.gentoo.org/wiki/Logrotate Logrotate on Gentoo Linux Wiki]
* [https://man.archlinux.org/man/logrotate.8 logrotate(8) Manual page]
* [https://man.archlinux.org/man/logrotate.conf.5 logrotate.conf(5) Manual page]

Logrotate

2021-05-11T02:12:08Z

Blackle0pard: /* logrotate の状態を確認 */ テンプレート:hc を使用

[[Category:ロギング]]
[[Category:データ圧縮とアーカイブ]]
[[en:Logrotate]]
{{Related articles start}}
{{Related|Cron}}
{{Related|systemd/タイマー}}
{{Related articles end}}

https://github.com/logrotate/logrotate より:

:''ログファイルが大量に生成されるシステムで、ログファイルの管理を簡単にするために logrotate ユーティリティは作られました。Logrotate はログファイルの自動的なローテーション圧縮や削除、メール送信などを可能にします。Logrotate を設定することで、ログファイルを毎日毎周毎月ごとに管理したり、特定のサイズまで達した時の動作を決められます。''

logrotate の''ローテーション''では、既存のログファイルに数字を割り振って名前を変更し、元の''空の''ログファイルを再作成します。例えば、{{ic|/var/log/syslog.log}} は {{ic|/var/log/syslog.log.1}} に名前が変更されます。{{ic|/var/log/syslog.log.1}} が既に存在する場合、名前は {{ic|/var/log/syslog.log.2}} に変更されます (バックログの数は設定で変えられます)。

==インストール==

Logrotate は {{Pkg|logrotate}} パッケージでインストールできます。

<s>デフォルトでは、logrotate は [[systemd/タイマー|systemd タイマー]]によって毎日動作します: {{ic|logrotate.timer}}</s>

日次でlogrotateの実行を有効にするには次のコマンドを利用します。

{{bc|
# systemctl enable logrotate.timer
}}
{{bc|
# systemctl start logrotate.timer
}}
{{hc|
# systemctl status logrotate.timer
|
● logrotate.timer - Daily rotation of log files
Loaded: loaded (/usr/lib/systemd/system/logrotate.timer; enabled; vendor preset: disabled)
Active: active (waiting) since Sun 2020-06-08 xx:xx:xx JST; 5s ago
Trigger: Mon 2020-06-08 00:00:00 JST; 56min left
Triggers: ● logrotate.service
Docs: man:logrotate(8)
man:logrotate.conf(5)
}}
{{hc|
# systemctl list-timers
|
NEXT LEFT LAST PASSED UNIT ACTIVATE
Mon 2020-06-08 00:00:00 JST 12h left n/a n/a logrotate.timer logrotate.service
}}

==設定==

logrotate の一番重要な設定ファイルは {{ic|/etc/logrotate.conf}} です。また、{{ic|/etc/logrotate.d}} ディレクトリには他の設定ファイルが含まれています。

logrotate が正しく動作するか確認するには、以下のコマンドを実行してください。デバッグ出力が生成されます:
logrotate -d
logrotate スクリプトをテストするには (例えば {{ic|/etc/logrotate.d}} ディレクトリの nginx スクリプト)、以下のように実行してみてください:
logrotate -f -v /etc/logrotate.d/nginx

==トラブルシューティング==

=== exim のログがローテーションされない ===

{{ic|/etc/logrotate.conf}} に {{ic|olddir}} 変数を設定した場合、以下のようなメッセージが表示されます:

{{Ic|error: failed to rename /var/log/exim/mainlog to /var/log/old/mainlog.1: Permission denied}}

この問題を修正するには、ユーザー {{ic|exim}} をグループ {{ic|log}} に追加してください。そして {{ic|olddir}} ({{ic|/var/log/old}}) のグループをデフォルトの {{ic|root}} から {{ic|log}} に変更してください。

=== logrotate の状態を確認 ===
{{ic|cat /var/lib/logrotate.status}} を実行することで logroate によってローテートされているファイルを確認できます:
{{hc| # cat /var/lib/logrotate.status |
"/var/log/mysql/query.log" 2016-3-20-5:0:0
"/var/log/samba/samba-smbd.log" 2016-3-21-5:0:0
"/var/log/httpd/access_log" 2016-3-20-5:0:0
}}

== 参照 ==

* [https://wiki.gentoo.org/wiki/Logrotate Logrotate on Gentoo Linux Wiki]
* [https://man.archlinux.org/man/logrotate.8 logrotate(8) Manual page]
* [https://man.archlinux.org/man/logrotate.conf.5 logrotate.conf(5) Manual page]

Logrotate

2021-05-11T02:07:25Z

Blackle0pard: /* 参照 */ 英語版に合わせました。

[[Category:ロギング]]
[[Category:データ圧縮とアーカイブ]]
[[en:Logrotate]]
{{Related articles start}}
{{Related|Cron}}
{{Related|systemd/タイマー}}
{{Related articles end}}

https://github.com/logrotate/logrotate より:

:''ログファイルが大量に生成されるシステムで、ログファイルの管理を簡単にするために logrotate ユーティリティは作られました。Logrotate はログファイルの自動的なローテーション圧縮や削除、メール送信などを可能にします。Logrotate を設定することで、ログファイルを毎日毎周毎月ごとに管理したり、特定のサイズまで達した時の動作を決められます。''

logrotate の''ローテーション''では、既存のログファイルに数字を割り振って名前を変更し、元の''空の''ログファイルを再作成します。例えば、{{ic|/var/log/syslog.log}} は {{ic|/var/log/syslog.log.1}} に名前が変更されます。{{ic|/var/log/syslog.log.1}} が既に存在する場合、名前は {{ic|/var/log/syslog.log.2}} に変更されます (バックログの数は設定で変えられます)。

==インストール==

Logrotate は {{Pkg|logrotate}} パッケージでインストールできます。

<s>デフォルトでは、logrotate は [[systemd/タイマー|systemd タイマー]]によって毎日動作します: {{ic|logrotate.timer}}</s>

日次でlogrotateの実行を有効にするには次のコマンドを利用します。

{{bc|
# systemctl enable logrotate.timer
}}
{{bc|
# systemctl start logrotate.timer
}}
{{hc|
# systemctl status logrotate.timer
|
● logrotate.timer - Daily rotation of log files
Loaded: loaded (/usr/lib/systemd/system/logrotate.timer; enabled; vendor preset: disabled)
Active: active (waiting) since Sun 2020-06-08 xx:xx:xx JST; 5s ago
Trigger: Mon 2020-06-08 00:00:00 JST; 56min left
Triggers: ● logrotate.service
Docs: man:logrotate(8)
man:logrotate.conf(5)
}}
{{hc|
# systemctl list-timers
|
NEXT LEFT LAST PASSED UNIT ACTIVATE
Mon 2020-06-08 00:00:00 JST 12h left n/a n/a logrotate.timer logrotate.service
}}

==設定==

logrotate の一番重要な設定ファイルは {{ic|/etc/logrotate.conf}} です。また、{{ic|/etc/logrotate.d}} ディレクトリには他の設定ファイルが含まれています。

logrotate が正しく動作するか確認するには、以下のコマンドを実行してください。デバッグ出力が生成されます:
logrotate -d
logrotate スクリプトをテストするには (例えば {{ic|/etc/logrotate.d}} ディレクトリの nginx スクリプト)、以下のように実行してみてください:
logrotate -f -v /etc/logrotate.d/nginx

==トラブルシューティング==

=== exim のログがローテーションされない ===

{{ic|/etc/logrotate.conf}} に {{ic|olddir}} 変数を設定した場合、以下のようなメッセージが表示されます:

{{Ic|error: failed to rename /var/log/exim/mainlog to /var/log/old/mainlog.1: Permission denied}}

この問題を修正するには、ユーザー {{ic|exim}} をグループ {{ic|log}} に追加してください。そして {{ic|olddir}} ({{ic|/var/log/old}}) のグループをデフォルトの {{ic|root}} から {{ic|log}} に変更してください。

=== logrotate の状態を確認 ===
{{ic|cat /var/lib/logrotate.status}} を実行することで logroate によってローテートされているファイルを確認できます:
{{bc|
"/var/log/mysql/query.log" 2016-3-20-5:0:0
"/var/log/samba/samba-smbd.log" 2016-3-21-5:0:0
"/var/log/httpd/access_log" 2016-3-20-5:0:0
}}

== 参照 ==

* [https://wiki.gentoo.org/wiki/Logrotate Logrotate on Gentoo Linux Wiki]
* [https://man.archlinux.org/man/logrotate.8 logrotate(8) Manual page]
* [https://man.archlinux.org/man/logrotate.conf.5 logrotate.conf(5) Manual page]

2021-05-09T13:47:54Z

Blackle0pard: /* インストール */

[[Category:ロギング]]
[[Category:データ圧縮とアーカイブ]]
[[en:Logrotate]]
{{Related articles start}}
{{Related|Cron}}
{{Related|systemd/タイマー}}
{{Related articles end}}

https://github.com/logrotate/logrotate より:

:''ログファイルが大量に生成されるシステムで、ログファイルの管理を簡単にするために logrotate ユーティリティは作られました。Logrotate はログファイルの自動的なローテーション圧縮や削除、メール送信などを可能にします。Logrotate を設定することで、ログファイルを毎日毎周毎月ごとに管理したり、特定のサイズまで達した時の動作を決められます。''

logrotate の''ローテーション''では、既存のログファイルに数字を割り振って名前を変更し、元の''空の''ログファイルを再作成します。例えば、{{ic|/var/log/syslog.log}} は {{ic|/var/log/syslog.log.1}} に名前が変更されます。{{ic|/var/log/syslog.log.1}} が既に存在する場合、名前は {{ic|/var/log/syslog.log.2}} に変更されます (バックログの数は設定で変えられます)。

==インストール==

Logrotate は {{Pkg|logrotate}} パッケージでインストールできます。

<s>デフォルトでは、logrotate は [[systemd/タイマー|systemd タイマー]]によって毎日動作します: {{ic|logrotate.timer}}</s>

日次でlogrotateの実行を有効にするには次のコマンドを利用します。

{{bc|
% sudo systemctl enable logrotate.timer
% sudo systemctl list-timers
NEXT LEFT LAST PASSED UNIT ACTIVATE
Mon 2020-06-08 00:00:00 JST 12h left n/a n/a logrotate.timer logrotate.service
}}

==設定==

logrotate の一番重要な設定ファイルは {{ic|/etc/logrotate.conf}} です。また、{{ic|/etc/logrotate.d}} ディレクトリには他の設定ファイルが含まれています。

logrotate が正しく動作するか確認するには、以下のコマンドを実行してください。デバッグ出力が生成されます:
logrotate -d
logrotate スクリプトをテストするには (例えば {{ic|/etc/logrotate.d}} ディレクトリの nginx スクリプト)、以下のように実行してみてください:
logrotate -f -v /etc/logrotate.d/nginx

==トラブルシューティング==

=== exim のログがローテーションされない ===

{{ic|/etc/logrotate.conf}} に {{ic|olddir}} 変数を設定した場合、以下のようなメッセージが表示されます:

{{Ic|error: failed to rename /var/log/exim/mainlog to /var/log/old/mainlog.1: Permission denied}}

この問題を修正するには、ユーザー {{ic|exim}} をグループ {{ic|log}} に追加してください。そして {{ic|olddir}} ({{ic|/var/log/old}}) のグループをデフォルトの {{ic|root}} から {{ic|log}} に変更してください。

=== logrotate の状態を確認 ===
{{ic|cat /var/lib/logrotate.status}} を実行することで logroate によってローテートされているファイルを確認できます:
{{bc|
"/var/log/mysql/query.log" 2016-3-20-5:0:0
"/var/log/samba/samba-smbd.log" 2016-3-21-5:0:0
"/var/log/httpd/access_log" 2016-3-20-5:0:0
}}

== 参照 ==

* [https://wiki.gentoo.org/wiki/Logrotate Logrotate on Gentoo Linux Wiki]
* [https://linux.die.net/man/8/logrotate logrotate(8) Manual page]