Proses Instal dan Konfigurasi pgAdmin untuk PostgreSQL di FreeBSD

pgAdmin merupakan alat manajemen untuk PostgreSQL dan database relasional turunan seperti EDB (Advanced Server EnterpriseDB). Program ini dapat dijalankan sebagai aplikasi web atau desktop. pgAdmin merupakan platform sumber terbuka yang gratis dan sangat populer. pgAdmin diciptakan untuk memudahkan pengguna database PostgreSQL, karena program ini memiliki antarmuka pengguna grafis untuk mengelola database relasional. Beberapa fiturnya meliputi alat kueri untuk pernyataan SQL dan impor/ekspor file csv.

Alat antarmuka pengguna grafis (GUI) telah menjadi bagian standar dari alur kerja teknologi saat ini. Untuk manajemen PostgreSQL, pgAdmin dianggap sebagai solusi yang tepat bagi pengguna yang membutuhkan tampilan dalam bentuk gambar atau GUI, seperti halnya menggunakan Windows. Seperti yang dikatakan pengembangnya, pgAdmin 4 merupakan versi terbaru, dan pengembangannya melibatkan penulisan ulang lengkap dari alat pgAdmin asli.

pgAdmin adalah salah satu pemimpin dalam manajemen sumber terbuka berbasis PostgreSQL, yang sering disebut sebagai platform basis data tercanggih di dunia. pgAdmin 4 dirancang untuk memenuhi kebutuhan pengguna Postgres pemula dan berpengalaman, menyediakan antarmuka grafis canggih yang menyederhanakan pembuatan, pemeliharaan, dan penggunaan objek basis data.

pgAdmin adalah proyek perangkat lunak gratis yang dirilis di bawah lisensi PostgreSQL/Artistic. pgAdmin 4 adalah perangkat lunak yang dibuat menggunakan Python dan JavaScript/jQuery. Runtime desktop yang ditulis dalam C++ dengan Qt memungkinkannya berjalan mandiri untuk pengguna individu, atau kode aplikasi web dapat disebarkan langsung di server web untuk digunakan oleh satu atau lebih pengguna melalui browser web mereka.

Fitur lain yang tak kalah menarik dari pgAdmin adalah kemampuannya dalam menangani query SQL, pemeliharaan, dan proses lain yang diperlukan tanpa menggunakan command prompt. Selain itu, pgAdmin juga menyediakan alat pemantauan yang memungkinkan pengguna untuk melihat status operasi secara sekilas, dan membantu mengotomatiskan pekerjaan secara rutin dan berkala. Secara keseluruhan, dapat dikatakan bahwa pgAdmin merupakan tambahan yang berharga bagi alur kerja sebagian besar pengguna PostgreSQL. Dengan begitu banyaknya dokumentasi, tidak sulit untuk memulai, bahkan jika Anda belum pernah memasang alat GUI di atas database sebelumnya. Langkah selanjutnya adalah memastikan pgAdmin kompatibel dengan instalasi PostgreSQL yang telah terpasang di server Anda.

Dalam artikel ini, kita akan mempelajari tentang PGAdmin, alat manajemen PostgreSQL. Seperti yang Anda ketahui, SQL Server Management Studio (SSMS) dan MySQL Workbench merupakan alat manajemen GUI untuk SQL Server dan MySQL. Demikian pula, untuk mengelola database Postgres dan layanannya, digunakan PGAadmin. PGAdmin adalah alat GUI berbasis web yang digunakan untuk berinteraksi dengan sesi basis data Postgres, baik secara lokal maupun di server jarak jauh. Anda dapat menggunakan PGAdmin untuk melakukan segala jenis administrasi basis data yang diperlukan untuk basis data Postgres.


Artikel ini ditulis berdasarkan praktik yang dilakukan pada server FreeBSD 13.2. Berikut ini adalah spesifikasi sistem yang digunakan untuk menulis artikel ini.

Spesifikasi Sistem:

OS: FreeBSD 13.2
IP Addres: 192.168.5.2
Domain: unixexplore.com
Versi PostgreSQL: postgresql15
Versi python: python39
Versi pgadmin: pgadmin3
Versi pip: pip23.1

1. Cara Install pgadmin

Dalam artikel ini kita tidak akan membahas cara menginstal PostgreSQL, kita akan berasumsi bahwa PostgreSQL telah diinstal pada server FreeBSD. Jadi kita lanjutkan dengan instalasi pgadmin. Pada sistem FreeBSD, yang terbaik adalah menggunakan sistem ports untuk menginstal pgadmin. Berikut cara menginstal pgadmin dengan sistem ports FreeBSD.

root@ns1:~ # cd /usr/ports/databases/py-sqlite3
root@ns1:/usr/ports/databases/py-sqlite3 # make install clean
root@ns1:/usr/ports/databases/py-sqlite3 # cd /usr/ports/lang/python39
root@ns1:/usr/ports/lang/python38 # make install clean
root@ns1:/usr/ports/lang/python38 # cd /usr/ports/devel/py-pip
root@ns1:/usr/ports/devel/py-pip # make install clean
root@ns1:/usr/ports/devel/py-pip # cd /usr/ports/devel/py-virtualenv
root@ns1:/usr/ports/devel/py-virtualenv # make install clean

Perintah di atas adalah skrip untuk menginstal dependensi yang dibutuhkan oleh program pgadmin. Perintah di atas sangat berguna untuk menjalankan pgadmin pada sistem FreeBSD. Setelah semua dependensi pgadmin terinstal, berikut adalah cara menginstal pgadmin.

root@ns1:~ # cd /usr/ports/databases/pgadmin3
root@ns1:/usr/ports/databases/pgadmin3 # make install clean

2. Buat Symlink Python

Karena pgadmin berjalan dengan aplikasi python dan banyak versi python yang terinstal secara otomatis di FreeBSD, maka membuat symlink python sangatlah penting. Symlink ini dapat digunakan untuk mengonfirmasi versi python yang digunakan, karena pada artikel ini menggunakan python38 symlink haruslah python38.

Berikut ini langkah-langkah untuk membuat symlin python38 di FreeBSD. Langkah pertama adalah menghapus berkas symlink yang ada.

root@ns1:~ # rm -R -f /usr/local/bin/python
root@ns1:~ # ln -s /usr/local/bin/python3.9 /usr/local/bin/python

Skrip pertama di atas menjelaskan penghapusan berkas biner python dan skrip kedua membuat tautan simbolik python38. Kedua perintah skrip di atas juga dapat digunakan untuk mengatasi galat dalam Python seperti "env python: Tidak ada berkas atau direktori tersebut". Setelah berkas tautan simbolik dibuat, mulai ulang komputer agar tautan simbolik aktif.

root@ns1:~ # reboot

3. Jalankan pgadmin

Untuk menjalankan pgadmin, pertama-tama kita harus membuat folder kerja. Kita akan membuat proyek kerja dengan nama "projectPgadmin" dan akan meletakkannya di folder /tmp.

root@ns1:~ # mkdir -p /tmp/projectPgadmin
root@ns1:~ # cd /tmp/projectPgadmin

Setelah itu, lanjutkan dengan membuat proyek kerja di lingkungan virtual Python dengan nama "pgadmin".

root@ns1:/tmp/projectPgadmin # python -m venv pgadmin
root@ns1:/tmp/projectPgadmin # cd pgadmin

Skrip di atas digunakan untuk membuat proyek kerja python dengan nama "pgadmin" dan proyek kerja tersebut berada di lingkungan virtual python. Proyek kerja tersebut belum aktif, sekarang kita akan mengaktifkan proyek kerja tersebut, ketik skrip di bawah ini untuk mengaktifkan proyek kerja "pgadmin". Untuk detail lebih lanjut tentang bekerja di lingkungan virtual python, Anda dapat membaca artikel di atas.

root@ns1:/tmp/projectPgadmin/pgadmin # source bin/activate.csh
(pgadmin) root@ns1:/tmp/projectPgadmin/pgadmin # 

Kemudian lanjutkan dengan skrip di bawah ini untuk memperbarui aplikasi pip.

(pgadmin) root@ns1:/tmp/projectPgadmin/pgadmin # pip install --upgrade pip

Setelah pip berhasil diperbarui, ketik perintah berikut untuk menginstal repositori pgadmin.

(pgadmin) root@ns1:/tmp/projectPgadmin/pgadmin # python3 -m pip install cryptography==3.3 pyopenssl ndg-httpsclient pyasn1 simple-websocket
(pgadmin) root@ns1:/tmp/projectPgadmin/pgadmin # python3 -m pip install https://ftp.postgresql.org/pub/pgadmin/pgadmin4/v6.21/pip/pgadmin4-6.21-py3-none-any.whl

Langkah berikutnya adalah mengetik perintah berikut untuk menyalin file config.py ke file config_local.py.

(pgadmin) root@ns1:/tmp/projectPgadmin/pgadmin # cd ..
(pgadmin) root@ns1:/tmp/projectPgadmin # cp ./pgadmin/lib/python3.9/site-packages/pgadmin4/config.py ./pgadmin/lib/python3.9/site-packages/pgadmin4/config_local.py

Setelah proses penyalinan file selesai, edit file config_local.py dan ubah IP Server menjadi IP Pribadi komputer server FreeBSD kita. Jika Anda mengedit file config_local.py menggunakan editor "ee" atau "vim", Anda harus keluar dari lingkungan virtual Python terlebih dahulu, gunakan perintah "deactivate" untuk keluar dari lingkungan virtual Python.

(pgadmin) root@ns1:/tmp/projectPgadmin # deactivate
root@ns1:/tmp/projectPgadmin # ee ./pgadmin/lib/python3.9/site-packages/pgadmin4/config_local.py
DEFAULT_SERVER = '192.168.5.2'
DEFAULT_SERVER_PORT = 5050

4. Test pgadmin

Setelah semua aplikasi dikonfigurasi, sekarang kita akan menguji apakah aplikasi pgadmin dapat berjalan di server FreeBSD. Untuk melakukan pengujian ini, kita harus aktif di lingkungan virtual Python. Berikut ini adalah skrip yang digunakan untuk mengaktifkan pgadmin, dimulai dari folder /root.

root@ns1:~ # cd /tmp/projectPgadmin/pgadmin
root@ns1:/tmp/projectPgadmin/pgadmin # source bin/activate.csh
(pgadmin) root@ns1:/tmp/projectPgadmin/pgadmin # cd ..
(pgadmin) root@ns1:/tmp/projectPgadmin # python ./pgadmin/lib/python3.9/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: datainchi@gmail.com
Password: gunungrinjani
Retype password: gunungrinjani
pgAdmin 4 - Application Initialisation
======================================

Starting pgAdmin 4. Please navigate to http://192.168.5.2:5050 in your browser.
 * Serving Flask app 'pgadmin' (lazy loading)
 * Environment: production
   WARNING: This is a development server. Do not use it in a production deployment.
   Use a production WSGI server instead.
 * Debug mode: off

Script hijau di atas adalah untuk mengaktifkan aplikasi pgadmin. Isi email sesuai dengan email yang ada dan password sesuai keinginan. Dalam kasus ini admin saya memberikan password "gunungrinjani".

Setelah yakin aplikasi pgadmin sudah aktif, buka web browser Google Chrome, Yandex atau Firefox, pada address bar ketik "http://192.168.5.2:5050".

Dengan pgadmin, Anda dapat dengan mudah menggunakan database PostgreSQL, karena tampilannya dalam bentuk grafis atau GUI, sehingga memudahkan pengguna untuk mengelola, memodifikasi, dan menjalankan PostgreSQL.