{{TOC}}

GrowiをUbuntu22.04をインストールしたので、そのときの手順です。

### 環境

- Ubuntu 22.04
- Apache 2.4

の基本的な設定が済んだという状況です。

### 前提

- 名前解決できるドメインが用意されている。
- どのドメインに応じた証明書が用意されている。

### さっくりとはならない手順

1. Node.js/npmをインストールします。
1. Redis-serverをインストールします。
1. Javaをインストールします。
1. ElasticSearch 8をインストールします。
1. ElasticSearchの設定変更を行います。
1. ElasticSearchのプラグインをインストールします。
1. ElasticSearchの設定変更を反映します。
1. MongoDBをインストールします。
1. MongoDBのデータ格納先を変更します。
1. MongoDBのアップデートを防ぎます。
1. MongoDBの設定変更を反映します。
1. yarnのインストールを行います。
1. 必要パッケージをインストールします。
1. turboパッケージをインストールします。
1. Growiのインストールを行います。
1. yarnを用いてインストールします。
1. 自動起動のスクリプトを作成します。
1. Apacheのリバースプロキシの設定を行います。
1. ブラウザで起動します。

### 手順

#### node18をインストールします。

- レポジトリ追加

```bash
sudo curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash
```

- パッケージアップグレード

```bash
sudo aptitude update
```

- Node.jsインストール

```bash
sudo aptitude install nodejs
```

- Node.jsバージョン確認

```bash
node -v
```

2024/01/10現在:v18.19.0

- npmバージョン確認

```bash
npm -v
```

2024/01/10現在:10.2.3

#### redis-serverをインストールします。

- インストール

```
sudo aptitude install redis-server
```

- 起動確認

```
systemctl status redis-server
```

active(running)を確認します。

- 自動起動有効化

```
sudo systemctl enable redis-server
```

#### Javaをインストールします。

- インストール

```bash
sudo aptitude install openjdk-17-jdk
```

#### ElasticSearhをインストールします。

- gpg追加

```bash
sudo wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg
```

- 必要パッケージインストール

```bash
sudo aptitude install apt-transport-https
```

- レポジトリ追加

```bash
sudo echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-8.x.list
```

- パッケージのアップグレード

```bash
sudo aptitude update
```

- ElasticSearchインストール

```bash
sudo aptitude install elasticsearch
```

※この後、デフォルトパスワードが表示されますが、控えておく程度にしましょう。

##### JVM設定変更

- バックアップディレクトリ作成

```bash
sudo mkdir /etc/elasticsearch/old
```

※任意のバックアップディレクトリを指定します。

- 設定ファイルバックアップ

```bash
sudo cp -pi /etc/elasticsearch/jvm.options /etc/elasticsearch/old/jvm.options.`date +%Y%m%d`
```

- 設定ファイル書き換え

``` bash
echo -e "-Xms256m\n-Xmx256m" | sudo tee -a /etc/elasticsearch/jvm.options
```

- 書き換え確認

```bash
sudo diff -u /etc/elasticsearch/old/jvm.options.`date +%Y%m%d` /etc/elasticsearch/jvm.options
```

- 差分

```diff
+-Xms256m
+-Xmx256m
```

##### ElasticSearchの設定変更

※この作業だけ管理者権限で実行します。

- root昇格

```bash
sudo su -
```

- 設定ファイルバックアップ

```bash
cp -pi /etc/elasticsearch/elasticsearch.yml /path/to/backup/elasticsearch.yml.$(date +%Y%m%d)
```

任意のバックアップディレクトリを指定します。

- ファイル書き換え

```bash
sed -i -e 's/xpack.security.enabled: true/xpack.security.enabled: false/' \
-e '/xpack.security.http.ssl:/{n; s/ enabled: true/ enabled: false/}' \
-e '/xpack.security.transport.ssl:/{n; s/ enabled: true/ enabled: false/}' /etc/elasticsearch/elasticsearch.yml
```

- 差分確認

```bash
diff -u /path/to/backup/elasticsearch.yml.$(date +%Y%m%d) /etc/elasticsearch/elasticsearch.yml
```

- 差分

```diff
# Enable security features
-xpack.security.enabled: true
+xpack.security.enabled: false

xpack.security.enrollment.enabled: true

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

# Enable encryption and mutual authentication between cluster nodes
xpack.security.transport.ssl:
- enabled: true
+ enabled: false
```
- rootから抜ける

```bash
exit
```

##### ElasticSearchのプラグインを追加

- analysis-kuromoji インストール

```bash
sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-kuromoji
```

- analysis-isu インストール

```bash
sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-icu
```

##### 自動起動設定反映

- 起動

```bash
sudo systemctl start elasticsearch
```

- 起動確認

```bash
systemctl status elasticsearch
```
active(running)を確認します。

- 自動起動有効化

```bash
sudo systemctl enable elasticsearch
```

#### MongoDBインストール

#### レポジトリ追加

- 必要パッケージインストール

```bash
sudo aptitude install gnupg
```

- gpg追加

```bash
curl -fsSL https://pgp.mongodb.com/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg --dearmor
```

- レポジトリ追加

```bash
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
```

##### MongoDBインストール

- パッケージのアップグレード

```bash
sudo aptitude update
```

- MongoDBインストール

```bash
sudo aptitude install mongodb-org mongodb-org-server mongodb-org-shell mongodb-org-mongos mongodb-org-tools
```

##### MongoDBバージョン固定

※2024/01/10現在、GrowiはMongoDBのバージョンが固定されているので、自動更新されないようにします。

```bash
sudo aptitude hold mongodb-org

sudo aptitude hold mongodb-org-server

sudo aptitude hold mongodb-org-shell

sudo aptitude hold mongodb-org-mongos

sudo aptitude hold mongodb-org-tools hold
```

##### 保存先変更（オプション）

MongoDBの格納先を、冗長化構成されているパーティションにするため対応しました。

- 格納ディレクトリ作成

```bash
sudo mkdir /home/mongodb
```

保存先を変えたいところにします

- 所有者変更

```bash
sudo chown -R mongodb:mongodb /home/mongodb
```

- 所有者変更確認

```bash
ls -ld /home/mongodb
```

- 設定ファイルのバックアップ取得

```bash
sudo cp -pi /etc/mongod.conf /path/to/backup/mongod.conf.$(date +%Y%m%d)
```
任意のバックアップディレクトリを指定します。

- バックアップ確認

```bash
sudo diff -u /etc/mongod.conf /path/to/backup/mongod.conf.$(date +%Y%m%d)
```

バックアップが保存されたか、差分がないことで確認します。

- ファイル書き換え

```bash
sudo sed -i 's/dbPath: \/var\/lib\/mongodb/dbPath: \/home\/mongodb/' /etc/mongod.conf
```

- 差分確認

```bash
sudo diff -u /path/to/backup/mongod.conf.$(date +%Y%m%d) /etc/mongodb.conf
```

- 差分

```diff
- dbPath: /var/lib/mongodb
+ dbPath: /home/mongodb
```

##### 自動起動有効

- mongodサービス起動

```bash
sudo systemctl start mongod
```

- サービス起動確認

```bash
systemctl status mongod
```
active (running)を確認します

- 自動起動有効化

```bash
sudo systemctl enable mongod
```

#### yarnインストール

- npmでyarnインストール

```bash
sudo npm install -g yarn
```

- turboインストール

※Growi v6.1.0から必須パッケージとなりました。

```bash
sudo yarn global add turbo
```

#### Growiインストール

- git clone

```bash
sudo git clone https://github.com/weseek/growi /home/www-data/growi
```

※任意のディレクトリを指定します。

- ディレクトリ移動

```bash
cd /home/www-data/growi && pwd
```

先ほどcloneしたディレクトリです。

- チェックアウト

```bash
sudo git checkout -b v6.3.0 refs/tags/v6.3.0
```
2024/01/09現在の最新版です。

- yarnによるインストール

```bash
sudo yarn
```

CPUのスペックによっては相当な時間がかかります。

#### 自動起動スクリプトの作成

- systemd作成

```bash
cat <<- __EOF__ | sudo tee -a /etc/systemd/system/growi.service
[Unit]
Description = growi
After=network-online.target mongod.service
ConditionPathExists=【/home/www-data/growi】

[Service]
ExecStart=【/home/www-data/growi/】growi-start.sh
Restart=no
Type=simple

[Install]
WantedBy=multi-user.target
__EOF__
```

※【】内を、git cloneしたディレクトリにします。

- Growiインストールディレクトリに作成

```bash
cat <<- __EOF__ | sudo tee -a 【/home/www-data/growi】/growi-start.sh
#!/bin/sh
cd 【/home/www-data/growi】
NODE_ENV=production \
AUDIT_LOG_ENABLED=true \
FORCE_WIKI_MODE=private \
MONGO_URI=mongodb://localhost:27017/growi \
ELASTICSEARCH_URI=http://localhost:9200/growi \
REDIS_URI=redis://localhost:6379 \
PASSWORD_SEED=[任意の文字列] \
FILE_UPLOAD=local \
npm start
__EOF__
```

※【】内を、git cloneしたディレクトリにします。
[]内には任意の文字列を入れます。

- 権限変更

```bash
sudo chmod +x /home/www-data/growi/growi-start.sh
```

- systemd設定反映

```bash
sudo systemctl daemon-reload
```

- growi有効化

```bash
sudo systemctl start growi.service
```
- growi有効化確認

```bash
systemctl status growi.service
```

active(running)を確認

- 自動起動有効化

```bash
sudo systemctl enable growi.service
```

#### Apacheによるリバースプロキシの設定

- モジュールインストール

```bash
sudo a2enmod proxy_http
```

- apache再起動

```bash
sudo systemctl restart apache2.service
```

- ログ保存ディレクトリ作成

```bash
suod mkdir /var/log/growi/
```

- 所有者変更

```bash
sudo chown -R www-data:www-data /var/log/growi
```

- 設定ファイル作成

```bash
cat <<- __EOF__ | sudo tee -a /etc/apache2/sites-available/growi.conf
#!/bin/sh
<VirtualHost _default_:80>
ServerName 【hoge.example.com】
# ドメイン名を指定します
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
# HTTPアクセスを強制的にHTTPSにリダイレクトします
</VirtualHost>

<VirtualHost _default_:443>
ServerName 【hoge.example.com】
# ドメイン名を指定します
CustomLog /var/log/growi/growi_access.log combined
ErrorLog /var/log/growi/growi_error.log

#SSL設定
SSLEngine on
Protocols h2 http/1.1
# SSLを有効化します

SSLCertificateFile 【/etc/certs/hoge.example.com.crt】
# SSL証明書を指定します
SSLCertificateKeyFile 【/etc/private/hoge.example.com.key】
# 秘密鍵を指定します

# Header に Host: example.com を追加するため
ProxyPreserveHost On
# HTTPS利用時: Header に x-forwarded-proto: https を追加するため
RequestHeader set x-forwarded-proto 'https'
# Apache では static assets で 304 が返らないことがあるので ETag を無効化する
<ifModule mod_headers.c>
Header unset ETag
</ifModule>
FileETag None

# socket.io の path を rewrite する
RewriteEngine On
RewriteCond %{REQUEST_URI} ^/socket.io [NC]
RewriteCond %{QUERY_STRING} transport=websocket [NC]
RewriteRule /(.*) ws://localhost:3000/$1 [P,L]

ProxyPass / http://localhost:3000/
ProxyPassReverse / http://localhost:3000/

</VirtualHost>

SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:EC6-GCM-SHA384
SSLHonorCipherOrder off
SSLSessionTickets off
__EOF__
```

【】内を自分の環境に変更してください。

- 設定反映

```bash
sudo a2ensite growi.conf
```

- コンフィグ確認

```bash
sudo apache2ctl configtest
```

Syntax OKを確認します。

- Apache2再起動

```bash
sudo systemctl restart apache2.service
```

#### Growiインストール確認

http://設定したドメイン でアクセスします。


この初期サイトが表示されたらインストール完了です。