# content
私の Firefish フォークをお使いの鯖缶さんへ
全文検索のエンジンを PGroonga に変更しました。
そのため、アップデート前に PGroonga をインストールする必要があります。

非 Docker ユーザー（特にインストールスクリプトを用いた方）向け

Ubuntu 向けのインストールスクリプトを使って Firefish をインストールされた場合には

$ psql --version

で PostgreSQL のバージョンを確認していただいてからこのページの「公式 PostgreSQL 用のインストール方法」の手順（一番上に書いてあるやつではないよ！$ sudo apt install -y -V postgresql-16-pgdg-pgroonga までです）を行ってください。
最後の postgresql-16-pgdg-pgroonga の部分は使っている PostgreSQL のバージョンに合わせて変更してください。例えば、PostgreSQL 14.x をお使いの場合には postgresql-14-pgdg-pgroonga としてください。

その後、.config/default.yml を開いて自分のデータベースの名前を確認してください（以下の例では firefish がデータベース名です）

db:
  host: localhost
  port: 5432
  db: firefish  # ここに書いてあるやつ

その後、以下のコマンドで PGroonga の拡張機能を有効にしてください（firefish の部分は自分のデータベース名に変えてください）

$ sudo -iu postgres psql --command="CREATE EXTENSION pgroonga;" --dbname=firefish

Meilisearch, Sonic, Elasticsearch のいずれかを使用していた場合、.config/default.yml からその設定をコメントアウトしてください（行頭に # をつけます）。

#meilisearch:
#  host: meilisearch
#  port: 7700
#  ssl: false
#  apiKey: xxxxxxxxxxxxxx

使っていた全文検索エンジンはアンインストールしてしまっても構いません（しばらく本家版に戻るつもりが無ければアンインストールしてしまうことをおすすめします）

ここまでの作業が終わったらいつも通り(?)アップデートスクリプトを使って Firefish をアップデートしてください。

Docker ユーザー向け

アップデートスクリプトでアップデートを行った後、Firefish を起動する前に（してしまっても大丈夫ですがエラーが出て正常に起動しにゃいので停止してください）

$ docker-compose up db --detach
$ docker-compose exec db psql --command "CREATE EXTENSION pgroonga;" --dbname=piyo --username=nyaa
$ docker-compose down db

を実行してください（ただし piyo と nyaa はそれぞれ .config/docker.env に書かれているデータベース名とユーザー名に変えてください）。成功すると

CREATE EXTENSION

と表示されるはずです。その後

$ docker-compose up --detach

で Firefish を起動できます。

質問がある場合にはこの投稿に（できれば公開投稿として）リプライしてください。

# contentMap.ja
私の Firefish フォークをお使いの鯖缶さんへ
全文検索のエンジンを PGroonga に変更しました。
そのため、アップデート前に PGroonga をインストールする必要があります。

非 Docker ユーザー（特にインストールスクリプトを用いた方）向け

Ubuntu 向けのインストールスクリプトを使って Firefish をインストールされた場合には

$ psql --version

で PostgreSQL のバージョンを確認していただいてからこのページの「公式 PostgreSQL 用のインストール方法」の手順（一番上に書いてあるやつではないよ！$ sudo apt install -y -V postgresql-16-pgdg-pgroonga までです）を行ってください。
最後の postgresql-16-pgdg-pgroonga の部分は使っている PostgreSQL のバージョンに合わせて変更してください。例えば、PostgreSQL 14.x をお使いの場合には postgresql-14-pgdg-pgroonga としてください。

その後、.config/default.yml を開いて自分のデータベースの名前を確認してください（以下の例では firefish がデータベース名です）

db:
  host: localhost
  port: 5432
  db: firefish  # ここに書いてあるやつ

その後、以下のコマンドで PGroonga の拡張機能を有効にしてください（firefish の部分は自分のデータベース名に変えてください）

$ sudo -iu postgres psql --command="CREATE EXTENSION pgroonga;" --dbname=firefish

Meilisearch, Sonic, Elasticsearch のいずれかを使用していた場合、.config/default.yml からその設定をコメントアウトしてください（行頭に # をつけます）。

#meilisearch:
#  host: meilisearch
#  port: 7700
#  ssl: false
#  apiKey: xxxxxxxxxxxxxx

使っていた全文検索エンジンはアンインストールしてしまっても構いません（しばらく本家版に戻るつもりが無ければアンインストールしてしまうことをおすすめします）

ここまでの作業が終わったらいつも通り(?)アップデートスクリプトを使って Firefish をアップデートしてください。

Docker ユーザー向け

アップデートスクリプトでアップデートを行った後、Firefish を起動する前に（してしまっても大丈夫ですがエラーが出て正常に起動しにゃいので停止してください）

$ docker-compose up db --detach
$ docker-compose exec db psql --command "CREATE EXTENSION pgroonga;" --dbname=piyo --username=nyaa
$ docker-compose down db

を実行してください（ただし piyo と nyaa はそれぞれ .config/docker.env に書かれているデータベース名とユーザー名に変えてください）。成功すると

CREATE EXTENSION

と表示されるはずです。その後

$ docker-compose up --detach

で Firefish を起動できます。

質問がある場合にはこの投稿に（できれば公開投稿として）リプライしてください。

# source.content
私の Firefish フォークをお使いの鯖缶さんへ
全文検索のエンジンを [PGroonga](https://pgroonga.github.io/ja/) に変更しました。
そのため、アップデート前に PGroonga をインストールする必要があります。

# 非 Docker ユーザー（特にインストールスクリプトを用いた方）向け

Ubuntu 向けのインストールスクリプトを使って Firefish をインストールされた場合には
```sh
$ psql --version
```
で PostgreSQL のバージョンを確認していただいてから?[このページ](https://pgroonga.github.io/ja/install/ubuntu.html)の「公式 PostgreSQL 用のインストール方法」の手順（一番上に書いてあるやつではないよ！`$ sudo apt install -y -V postgresql-16-pgdg-pgroonga` までです）を行ってください。
最後の `postgresql-16-pgdg-pgroonga` の部分は使っている PostgreSQL のバージョンに合わせて変更してください。例えば、PostgreSQL 14.x をお使いの場合には `postgresql-14-pgdg-pgroonga` としてください。

その後、`.config/default.yml` を開いて自分のデータベースの名前を確認してください（以下の例では `firefish` がデータベース名です）
```yaml
db:
  host: localhost
  port: 5432
  db: firefish  # ここに書いてあるやつ
```

その後、以下のコマンドで PGroonga の拡張機能を有効にしてください（`firefish` の部分は自分のデータベース名に変えてください）
```sh
$ sudo -iu postgres psql --command="CREATE EXTENSION pgroonga;" --dbname=firefish
```

Meilisearch, Sonic, Elasticsearch のいずれかを使用していた場合、`.config/default.yml` からその設定をコメントアウトしてください（行頭に `#` をつけます）。
```yaml
#meilisearch:
#  host: meilisearch
#  port: 7700
#  ssl: false
#  apiKey: xxxxxxxxxxxxxx
```
使っていた全文検索エンジンはアンインストールしてしまっても構いません（しばらく本家版に戻るつもりが無ければアンインストールしてしまうことをおすすめします）

ここまでの作業が終わったらいつも通り(?)アップデートスクリプトを使って Firefish をアップデートしてください。

# Docker ユーザー向け

アップデートスクリプトでアップデートを行った後、Firefish を起動する前に（してしまっても大丈夫ですがエラーが出て正常に起動しにゃいので停止してください）

```sh
$ docker-compose up db --detach
$ docker-compose exec db psql --command "CREATE EXTENSION pgroonga;" --dbname=piyo --username=nyaa
$ docker-compose down db
```
を実行してください（ただし `piyo` と `nyaa` はそれぞれ `.config/docker.env` に書かれているデータベース名とユーザー名に変えてください）。成功すると
```
CREATE EXTENSION
```
と表示されるはずです。その後
```sh
$ docker-compose up --detach
```
で Firefish を起動できます。

質問がある場合にはこの投稿に（できれば公開投稿として）リプライしてください。