nextcloud のバックアップ(No.14)

nextcloud

初回設定、参考サイト
rsyslogのインストール
Log出力設定の変更
Install後のセキュリティ&セットアップ警告
全文検索機能を組み込む(elasticsearch,Full text search)
その他
エラー対処

初回設定、参考サイト †

このサイトが一番わかりやすそうかな。。。
自分は既存の環境(LAMP)にインストール、設定しました。
- NextCloud : インストール

rsyslogのインストール †

sudo apt install rsyslog

↑

Log出力設定の変更 †

↑

参考サイト †

【techblog】Nextcloudの管理用CLI「occ」詳細：ログ管理に関するコマンド

↑

ログの出力、確認 †

php (nextCloudのルートフォルダ)/occ log:file

↑

ログの出力方式変更 †

php (nextCloudのルートフォルダ)/occ log:manage --level=info --timezone Asia/Tokyo

↑

Install後のセキュリティ&セットアップ警告 †

自分の環境に特化した内容が含まれますので、あくまでご参考です

↑

「.soファイル」のコピー先の確認方法 †

phpinfo で「extension_dir」を確認

↑

OPcache †

↑

Install †

sudo yum install php74-php-opcache php74-php-pecl-apcu

↑

必要なファイルをApacheが参照しているディレクトリへコピー †

必要なファイルの検索1
```
find /opt -name "*opcache*"
```
必要なファイルの検索2
```
find /etc -name "*opcache*"
```

ファイルのコピー

sudo cp /etc/opt/remi/php74/php.d/10-opcache.ini /etc/php.d/
sudo cp /opt/remi/php74/root/usr/lib64/php/modules/opcache.so /usr/lib64/php/modules/

↑

設定変更 †

sudo vim /etc/php.d/10-opcache.ini

zend_extension=opcache
opcache.enable=1
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.memory_consumption=128
opcache.save_comments=1
opcache.revalidate_freq = 60
opcache.validate_timestamps = 0

↑

確認 †

php -v

結果例

PHP 7.4.33 (cli) (built: Apr 10 2024 09:34:29) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.33, Copyright (c), by Zend Technologies

phpinfoにも「Zend OPcache」の項目として出てきます

↑

APCu †

↑

Install †

sudo yum install php74-php-pecl-apcu

↑

必要なファイルをApacheが参照しているディレクトリへコピー †

必要なファイルの検索1
```
find /opt -name "*apcu*"
```
必要なファイルの検索2
```
find /etc -name "*apcu*"
```

ファイルのコピー

sudo cp /etc/opt/remi/php74/php.d/40-apcu.ini /etc/php.d/
sudo cp /opt/remi/php74/root/usr/lib64/php/modules/apcu.so /usr/lib64/php/modules/

↑

設定変更 †

sudo vim (nextCloudのルートフォルダ)/config/config.php

「'memcache.local' => '\OC\Memcache\APCu',」を追加

  'installed' => true,                                                                                                    │
  'default_phone_region' => 'JP',                                                                                         │
  'memcache.local' => '\OC\Memcache\APCu',                                                                                │
  'memcache.distributed' => '\OC\Memcache\Redis',                                                                         │
  'memcache.locking' => '\OC\Memcache\Redis',                                                                             │
  'redis' => [                                                                                                            │
       'host' => 'localhost',                                                                                             │
       'port' => 6379,                                                                                                    │
  ],                                                                                                                      │
);

↑

確認 †

httpdを再起動
```
sudo systemctl restart httpd
```
phpinfoに「apcu」の項目として出てきます。

↑

redis †

↑

Install †

sudo yum install php74-php-pecl-redis

↑

必要なファイルをApacheが参照しているディレクトリへコピー †

redis関連

必要なファイルの検索1
```
find /opt -name "*redis.so*"
```
必要なファイルの検索2
```
find /etc -name "*redis*"
```

ファイルのコピー

sudo cp /etc/opt/remi/php74/php.d/50-redis.ini /etc/php.d/
sudo cp /opt/remi/php74/root/usr/lib64/php/modules/redis.so /usr/lib64/php/modules/

igbinary.so

必要なファイルの検索1
```
find /opt -name "*igbinary*"
```
必要なファイルの検索2
```
find /etc -name "*igbinary*"
```

ファイルのコピー

sudo cp /etc/opt/remi/php74/php.d/40-igbinary.ini /etc/php.d/
sudo cp /opt/remi/php74/root/usr/lib64/php/modules/igbinary.so /usr/lib64/php/modules/

msgpack.so

必要なファイルの検索1
```
find /opt -name "*msgpack*"
```
必要なファイルの検索2
```
find /etc -name "*msgpack*"
```

ファイルのコピー

sudo cp /etc/opt/remi/php74/php.d/40-msgpack.ini /etc/php.d/
sudo cp /opt/remi/php74/root/usr/lib64/php/modules/msgpack.so /usr/lib64/php/modules/

↑

設定変更 †

sudo vim (nextCloudのルートフォルダ)/config/config.php

「'memcache.distributed' => '\OC\Memcache\Redis',」以下を追加

  'installed' => true,
  'default_phone_region' => 'JP',
  'memcache.local' => '\OC\Memcache\APCu',
  'memcache.distributed' => '\OC\Memcache\Redis',
  'memcache.locking' => '\OC\Memcache\Redis',
  'redis' => [
       'host' => 'localhost',
       'port' => 6379,
  ],
);

↑

確認 †

httpdを再起動
```
sudo systemctl restart httpd
```
phpinfoに「redis」の項目として出てきます。

↑

OPcacheのインターン化文字列バッファーがまもなく一杯になります。全てのスクリプトをキャッシュに保管できるようにするには、opcache.interned_strings_bufferの値を8より多い値で、PHP設定に適用することを推奨します。 †

sudo vim /etc/php.d/10-opcache.ini
```
opcache.interned_strings_buffer=32
```
restart httpd
```
sudo systemctl restart httpd
```

↑

php-fpm のチューニング †

参考サイト(nextcloudが速くなるチューニングポイント)
sudo vim /etc/php/8.2/fpm/pool.d/www.conf

設定値参考

pm = static
pm.max_children = 120
pm.start_servers = 12
pm.min_spare_servers = 6
pm.max_spare_servers = 18

↑

全文検索機能を組み込む(elasticsearch,Full text search) †

↑

環境 †

NextCloud純正のVMイメージから仮想マシンを作ってます。
elasticsearchはNextCloudのサーバに同居させてます。

debian	12.9
nextcloud	Nextcloud Hub 9 (30.0.6)
elasticsearch	Version: 8.17.2, Build: deb/747663ddda3421467150de0e4301e8d4bc636b0c/2025-02-05T22:10:57.067596412Z, JVM: 23
java	openjdk version "17.0.14" 2025-01-21 OpenJDK Runtime Environment (build 17.0.14+7-Debian-1deb12u1) OpenJDK 64-Bit Server VM (build 17.0.14+7-Debian-1deb12u1, mixed mode, sharing)

↑

elasticsearchサーバの構築 †

↑

install †

レポジトリkeyのインストール

wget https://artifacts.elastic.co/GPG-KEY-elasticsearch -O /etc/apt/keyrings/GPG-KEY-elasticsearch.key
echo "deb [signed-by=/etc/apt/keyrings/GPG-KEY-elasticsearch.key] https://artifacts.elastic.co/packages/8.x/apt stable main" | tee /etc/apt/sources.list.d/elastic-8.x.list

関連パッケージのインストール(ただあとでsslは無効化するので不要かも。。。)
```
sudo apt-get install apt-transport-https
```

install

sudo apt update
apt -y install elasticsearch

アナライザトークナイザ、「analysis-kuromoji」のインストール
```
sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-kuromoji
```

↑

メモリ関連の設定 †

sudo vim /etc/elasticsearch/jvm.options

以下を追加(値は各自のサーバ状況に合わせて下さい)

################################################################
## IMPORTANT: JVM heap size
################################################################
##
## The heap size is automatically configured by Elasticsearch
## based on the available memory in your system and the roles
## each node is configured to fulfill. If specifying heap is
## required, it should be done through a file in jvm.options.d,
## which should be named with .options suffix, and the min and
## max should be set to the same value. For example, to set the
## heap to 4 GB, create a new file in the jvm.options.d
## directory containing these lines:
##
## -Xms4g
## -Xmx4g
##
## See https://www.elastic.co/guide/en/elasticsearch/reference/8.17/heap-size.html
## for more information
##
################################################################

-Xms1g
-Xmx2g

↑

sslの無効化 †

sudo vim /etc/elasticsearch/elasticsearch.yml

# Enable security features
#xpack.security.enabled: true
xpack.security.enabled: false

#xpack.security.enrollment.enabled: true
xpack.security.enrollment.enabled: false

# Enable encryption for HTTP API client connections, such as Kibana, Logstash, and Agents
#xpack.security.http.ssl:
#  enabled: true
#  keystore.path: certs/http.p12
#
xpack.security.http.ssl:
  enabled: false
#  keystore.path: certs/http.p12


# Enable encryption and mutual authentication between cluster nodes
#xpack.security.transport.ssl:
#  enabled: true
#  verification_mode: certificate
#  keystore.path: certs/transport.p12
#  truststore.path: certs/transport.p12

xpack.security.transport.ssl:
  enabled: false
#  verification_mode: certificate
#  keystore.path: certs/transport.p12
#  truststore.path: certs/transport.p12



# Create a new cluster with the current node only
# Additional nodes can still join the cluster later
cluster.initial_master_nodes: ["serverName"]

# Allow HTTP API connections from anywhere
# Connections are encrypted and require user authentication
http.host: 0.0.0.0

# Allow other nodes to join the cluster from anywhere
# Connections are encrypted and mutually authenticated
#transport.host: 0.0.0.0

#----------------------- END SECURITY AUTO CONFIGURATION -------------------------

↑

elasticsearchデーモンの起動と自動起動設定 †

sudo systemctl restart elasticsearch 
sudo systemctl enable elasticsearch

↑

動作確認 †

なんかしら帰ってきます。ブラウザでも確認可能。
```
curl http://localhost:9200
```

↑

nextcloud側の設定 †

↑

設定 †

右上のイニシャル・アイコンから「管理者設定」を選択
左側から全文検索を選択
設定イメージ
設定値(コピペできるように)
- http://localhost:9200/
- nextcloud
  - これ、はまりました。。。この文字列でないとelasticsearchが動かないです。。。
- analysis-kuromoji

↑

全文検索、index作成テストと作成 †

occ は、/var/www/nextcloud/occ かもしれない。

sudo -u www-data php occ fulltextsearch:check
sudo -u www-data php occ fulltextsearch:test

indexの作成

sudo -u www-data php occ fulltextsearch:index

エラー数をリセットしたい場合

sudo -u www-data php occ fulltextsearch:index "{\"errors\": \"reset\"}"

↑

daemon化 †

↑

scriptの作成 †

sudo vi /usr/local/bin/nextCloudFullTextSearch.sh

#!/bin/sh

# Quick start-stop-daemon example, derived from Debian /etc/init.d/ssh
set -e

# Must be a valid filename
NAME=fulltextsearch-daemon
PIDFILE=/var/run/$NAME.pid
#This is the command to be run, give the full pathname
DAEMON="/usr/bin/php"
DAEMON_OPTS="/var/www/nextcloud/occ fulltextsearch:live"

export PATH="${PATH:+$PATH:}/usr/sbin:/sbin"

case "$1" in
  start)
        echo -n "Starting daemon: "$NAME
        start-stop-daemon --start --background --quiet --pidfile $PIDFILE --exec $DAEMON -- $DAEMON_OPTS
        echo "."
        ;;
  stop)
        echo -n "Stopping daemon: "$NAME
        start-stop-daemon --stop --quiet --oknodo --pidfile $PIDFILE
        echo "."
        ;;
  restart)
        echo -n "Restarting daemon: "$NAME
        start-stop-daemon --stop --quiet --oknodo --retry 30 --pidfile $PIDFILE
        start-stop-daemon --start --background --quiet --pidfile $PIDFILE --exec $DAEMON -- $DAEMON_OPTS
        echo "."
        ;;

  *)
        echo "Usage: "$1" {start|stop|restart}"
        exit 1
esac

exit 0

実行権限の追加

sudo chmod +x /usr/local/bin/nextCloudFullTextSearch.sh

↑

systemctlへ登録 †

sudo vi /etc/systemd/system/nextCloudFullTextSearch.service

[Unit]
Description = nextCloudFullTextSearch

[Service]
Restart = no
Type = forking
User=www-data
Group=www-data
ExecStart = /usr/local/bin/nextCloudFullTextSearch.sh start
ExecReload = /usr/local/bin/nextCloudFullTextSearch.sh reload
ExecStop = /usr/local/bin/nextCloudFullTextSearch.sh stop

[Install]
WantedBy = multi-user.target

登録できたか確認

sudo systemctl list-unit-files --type=service  | grep next

maskの解除
```
sudo systemctl unmask nextCloudFullTextSearch.service
```
- 何故か上記のファイルが消えたので再度作成

↑

起動と自動起動化 †

sudo systemctl enable nextCloudFullTextSearch.service
sudo systemctl restart nextCloudFullTextSearch.service

↑

実行されているか確認 †

ps ax | grep occ

↑

エラー対応 †

↑

Testing search platform. fail †

エラー内容

$ sudo docker exec --user www-data nextcloud php occ fulltextsearch:test
.Testing your current setup:
Creating mocked content provider. ok
Testing mocked provider: get indexable documents. (2 items) ok
Loading search platform. (Elasticsearch) ok
Testing search platform. fail
.Testing your current setup:
Creating mocked content provider. ok
Testing mocked provider: get indexable documents. (2 items) ok
Loading search platform. (Elasticsearch) ok
Testing search platform. fail

原因
- 多分、ssl関連
対策
- elasticsearchの非ssl化(https -> http)

↑

retrieving content from a big index (license). fail †

原因
- 「インデックス,インデックスの名前」が間違えている
対策
- インデックス名を正しい文字列へ
- NextCloud ->
  -> 右上(イニシャル・アイコン)から「管理者設定」->
  -> 左側「全文検索」->
  -> 「インデックス,インデックスの名前」

↑

その他 †

↑

sessionディレクトリへ権限追加 †

参考サイト【Nextcloud】ログインループ (3) -アッサリ解決-

↑

sessionディレクトリの確認 †

phpinfo()で確認する
```
<?php

phpinfo();

?>
```

↑

sessionディレクトリへアクセス兼を設定 †

sudo chown apache: -R /var/lib/php/session

↑

パスワード・リセット †

sudo -u www-data php /var/www/nextcloud/occ user:resetpassword admin

↑

WindowsのExplorer(エクスプローラー)でマウント †

参考サイト

↑

Apache実行ユーザーの変更 †

↑

ログインできない †

大体、sessionフォルダへのアクセス権の問題

sudo chown apacheUser:ApacheUsers /var/lib/php/sessions -R

↑

redis エラー †

redis グループへApache2実行ユーザーを追加
```
sudo gpasswd -a apacheUser redis
```

daemon再起動

systemctl restart redis
systemctl restart apache2

↑

cron実行ユーザーの変更 †

sudo vim /etc/cron.d/nextcloud

↑

エラー対処 †

↑

参考サイト †

Linuxで様々なサービスを構築しよう！！！

↑

cron.phpが実行されない †

以下に変更(/dev/null 2>&1を消し、apc.enable を追加)

sudo vim /etc/cron.d/nextcloud

/usr/bin/php -f /var/www/nextcloud/cron.php --define apc.enable_cli=1

設定変更後は少し時間がかかる事がありますが、何回か実行していると5分以内に収まるようになります。
実行されているかの確認は、NextCloudの「管理者設定」->「基本設定」で確認可能です。

↑

updateに失敗する(create backup failed) †

以下のコマンドで確認

sudo -u www-data php --define apc.enable_cli=1 /var/www/nextcloud/updater/updater.phar

バックアップの失敗はpermissionエラーの場合が多い。
以下のコマンドを実行
```
sudo chown www-data:www-data -R /var/www/nextcloud/*
```

↑

メンタンス・モード(Maintenanceモード)が解除されない。 †

以下のファイルを編集

sudo vim /var/www/nextcloud/config/config.php

以下の場所
```
 'maintenance' => false,
```

↑

Downgrading is not supported and is likely to cause unpredictable issues †

apacheの再起動
```
sudo systemctl restart apache2
```

↑

同期エラーで修正しようとしても「ローカルファイルコピー元のファイルが存在しません」となる †

NextCloud側にゴミが残っているので、ブラウザでNextCloudにアクセスし、当該ファイルを削除する。
(F5キーなど最新の情報に更新するのを忘れずに。。。)

nextcloud のバックアップ(No.14)

nextcloud

初回設定、参考サイト †

rsyslogのインストール †

Log出力設定の変更 †

参考サイト †

ログの出力、確認 †

ログの出力方式変更 †

Install後のセキュリティ&セットアップ警告 †

「.soファイル」のコピー先の確認方法 †

OPcache †

Install †

必要なファイルをApacheが参照しているディレクトリへコピー †

設定変更 †

確認 †

APCu †

Install †

必要なファイルをApacheが参照しているディレクトリへコピー †

設定変更 †

確認 †

redis †

Install †

必要なファイルをApacheが参照しているディレクトリへコピー †

設定変更 †

確認 †

OPcacheのインターン化文字列バッファーがまもなく一杯になります。全てのスクリプトをキャッシュに保管できるようにするには、opcache.interned_strings_bufferの値を8より多い値で、PHP設定に適用することを推奨します。 †

php-fpm のチューニング †

全文検索機能を組み込む(elasticsearch,Full text search) †

環境 †

elasticsearchサーバの構築 †

install †

メモリ関連の設定 †

sslの無効化 †

elasticsearchデーモンの起動と自動起動設定 †

動作確認 †

nextcloud側の設定 †

関連アプリのインストール †

設定 †

全文検索、index作成テストと作成 †

daemon化 †

scriptの作成 †

systemctlへ登録 †

起動と自動起動化 †

実行されているか確認 †

エラー対応 †

Testing search platform. fail †

retrieving content from a big index (license). fail †

その他 †

sessionディレクトリへ権限追加 †

sessionディレクトリの確認 †

sessionディレクトリへアクセス兼を設定 †

パスワード・リセット †

WindowsのExplorer(エクスプローラー)でマウント †

Apache実行ユーザーの変更 †

ログインできない †

redis エラー †

cron実行ユーザーの変更 †

エラー対処 †

参考サイト †

cron.phpが実行されない †

updateに失敗する(create backup failed) †

メンタンス・モード(Maintenanceモード)が解除されない。 †

Downgrading is not supported and is likely to cause unpredictable issues †

同期エラーで修正しようとしても「ローカルファイルコピー元のファイルが存在しません」となる †