FreeBSD 12 に pgAdmin4 をインストールする方法 |
pgAdmin は、Linux、Unix、Mac OS X、および Windows 上で動作する、オープンソースの機能豊富な主要な PostgreSQL 管理および開発プラットフォームです。データベースの管理と操作を容易にする強力な GUI を提供します。
pgAdmin を使用すると、PostgreSQL 9.2 以降を管理できます。この記事の執筆時点では、pgAdmin の最新リリースは Bootstrap 3 から Bootstrap 4 に移行されたv4 です。
セットアップの前提条件
前提条件として、以下が必要です。
- FreeBSDサーバー
- PostgreSQLサーバーがインストールされている
- sudo権限を持つユーザーアカウント
ステップ 1: PostgreSQL データベース サーバーをインストールする
PostgreSQL データベース サーバーのインストールについては、以前のガイドを参照してください。
- FreeBSD 12 に PostgreSQL 11 をインストールする方法
ステップ 2: FreeBSD システムを更新する
私のセットアップでは、PostgreSQL を実行している同じサーバーに pgAdmin をインストールしています。ただし、別のサーバーにセットアップするオプションもあります。
まず、FreeBSD リポジトリ データベースを更新します。
freebsd-update fetch
freebsd-update install
ステップ 3: Python pip と Virtualenv をインストールする
/usr/local/bin/python
への Python 3.8 シンボリック リンクを作成します。
sudo ln -s /usr/local/bin/python3.8 /usr/local/bin/python
pip は Python パッケージをインストールするために必要です。以下のガイドに従って、FreeBSD サーバーにインストールします。
- FreeBSD 12 に pip Python パッケージ マネージャーをインストールする
Python のセットアップの概要:
sudo pkg install py38-pip
sudo pip install --upgrade pip
sudo pkg install py38-virtualenv
ステップ 4: pgAdmin パッケージをインストールする
以下を実行して、pgAdmin4 の仮想環境を作成します。
$ sudo virtualenv-3.8 pgadmin4
Using base prefix '/usr/local'
New python executable in /root/pgadmin4/bin/python3.8
Also creating executable in /root/pgadmin4/bin/python
Installing setuptools, pip, wheel...
done.
作成した仮想環境をアクティブ化します。
source pgadmin4/bin/activate
失敗した場合は、次を使用します。
source pgadmin4/bin/activate.csh
pgAdmin の Python 依存関係をインストールします。
sudo pip install cryptography==3.1.1 pyopenssl ndg-httpsclient pyasn1 simple-websocket
次に、標準の Python バインディングを SQLite3 ライブラリにインストールします。 Python 3.8 の場合は、次を実行します。
sudo pkg install py38-sqlite3
Python 2.7 の場合は、次を使用します。
sudo pkg install py27-sqlite3
ダウンロードする前に、pgAdmin4 の最新リリースを確認してください。最新リリースへのパスを取得したら、pip
コマンドを使用してインストールします。
sudo pip install https://ftp.postgresql.org/pub/pgadmin/pgadmin4/v6.9/pip/pgadmin4-6.9-py3-none-any.whl
多数の依存関係がインストールされるため、このインストールには時間がかかる場合がありますので、しばらくお待ちください。
完了したら、pgAdmin4 のデータ ディレクトリを作成します。
sudo mkdir -p /var/lib/pgadmin /var/log/pgadmin
sudo chmod 770 /var/lib/pgadmin /var/log/pgadmin
ステップ 5: pgAdmin 4 を構成して実行する
インストール後、pgAdmin 4 の設定ファイルを作成する必要があります。
cp ./pgadmin4/lib/python3.6/site-packages/pgadmin4/config.py ./pgadmin4/lib/python3.6/site-packages/pgadmin4/config_local.py
Python 2.7 の場合、python3.6
を python2.7
に置き換えます。
デフォルトのサーバーのリッスン アドレスを 0.0.0.0
に変更します。
vim ./pgadmin4/lib/python3.6/site-packages/pgadmin4/config_local.py
これは 138
行目あたりです。
DEFAULT_SERVER = '0.0.0.0'
デフォルトのリッスン ポートは 5050
ですが、希望のポートに変更できます。
The default port on which the app server will listen if not set in the environment by the runtime
DEFAULT_SERVER_PORT = 5050
次のコマンドを使用して pgAdmin を実行します。
$ sudo python ./pgadmin4/lib/python3.8/site-packages/pgadmin4/pgAdmin4.py
NOTE: Configuring authentication for SERVER mode.
Enter the email address and password to use for the initial pgAdmin user account:
Email address: [email
Password: <Enter Password>
Retype password: <Confirm Password>
pgAdmin 4 - Application Initialisation
Starting pgAdmin 4. Please navigate to http://0.0.0.0:5050 in your browser.
最初の実行では、pgAdmin ユーザー アカウントに使用するメール アドレス
とパスワード
を入力するよう求められます。
ステップ 6: pgAdmin Web インターフェイスにアクセスする
pgAdmin4 がインストールされ実行されているので、URL「http://your_server_ip:5050」にアクセスして Web ダッシュボードにアクセスできます。
作成したユーザーのメールアドレスとパスワードでログインします。ログイン後、PostgreSQL サーバーに接続する必要があります。
サーバー接続名とグループを入力します。
「接続」 タブで、アクセスの詳細 (DB ホスト、DB ユーザー、パスワード) を入力します。
設定を保存して接続を有効にします。
PostgreSQL データベース管理タスクに pgAdmin を使用できるようになりました。
MariaDB ユーザーの場合は、以下を確認してください。
- FreeBSD 12 に MariaDB をインストールする方法
- FreeBSD 12 に PHP 7.3 をインストールする方法