Liferay Community APAC
Liferay Forums dokumentasi

Beranda/Marketplace Apps/Liferay Forums/Instalasi

Halaman ini adalah terjemahan dari versi bahasa Inggris. Label antarmuka dan nama menu ditulis dalam bahasa Inggris. Jika ada perbedaan, versi bahasa Inggris yang berlaku.

Instalasi di Liferay SaaS

Di Liferay SaaS, Anda men-deploy tiga zip forum dengan command line tool Liferay Cloud, satu per satu, sesuai urutan. Liferay Cloud menjalankan batch dan situs forum sebagai job, dan microservice sebagai layanan yang terus berjalan.

Langkah-langkah ini telah diuji pada Liferay DXP 2026.Q1.4 LTS yang bersih dengan perbaikan yang diperlukan, di salinan lokal dari cara Liferay Cloud menjalankan client extension, tetapi belum di lingkungan Liferay SaaS.

  1. Langkah 1: Periksa Versi dan Perbaikan Liferay
  2. Langkah 2: Bersiap untuk Deploy
  3. Langkah 3: Deploy Batch
  4. Langkah 4: Deploy Microservice
  5. Langkah 5: Deploy Site Initializer
  6. Langkah 6: Siapkan Notifikasi Email
  7. Langkah 7: Periksa Instalasi
  8. Batas Panggilan API
  9. Deploy Berikutnya
  10. Menambahkan Situs Forum Lain
  11. Informasi Terkait

Langkah 1: Periksa Versi dan Perbaikan Liferay

Di Liferay SaaS, Liferay mengelola versi Liferay dan hotfix-nya, untuk semua lingkungan di cluster yang sama sekaligus: hotfix tidak dapat diinstal hanya untuk lingkungan Anda. Jadi, Anda bekerja dengan rilis yang dijalankan lingkungan Anda:

  1. Tanyakan kepada Liferay Support rilis dan hotfix mana yang dijalankan lingkungan Anda, dan pastikan rilis tersebut adalah rilis 2026.Q1 LTS.

  2. Bandingkan dengan perbaikan Liferay yang diperlukan. Untuk setiap perbaikan yang tidak tercakup, gunakan solusi sementara setelah instalasi. LPD-85594 tidak berpengaruh di Liferay SaaS: langkah-langkah di bawah ini tidak pernah menjalankan site initializer dua kali.

Langkah 2: Bersiap untuk Deploy

  1. Instal command line tool Liferay Cloud, lalu masuk dengan lcp login.

  2. Temukan ID lingkungan ekstensi yang menjadi tujuan deploy, dalam format <project>-<environment>. Konsol Liferay Cloud menampilkannya.

  3. Dari rilis terbaru, unduh:

Langkah 3: Deploy Batch

  1. Deploy batch:

     lcp deploy -p <project>-<environment> --extension liferay-forums-batch.zip

  2. Tunggu hingga job-nya selesai. Job selesai ketika Applications → Notification Templates menampilkan C2M0 Notification Email Reply dan C2M0 Notification Email Mention, yang dibuat batch paling akhir. Control Panel → Objects kemudian menampilkan folder C2M0 Forums, dengan tujuh object: C2M0 Attachment, C2M0 Message, C2M0 Subscription, C2M0 Suspicious Activity, C2M0 Thread, C2M0 User, dan C2M0 Vote.

Jangan lanjutkan sebelum batch selesai. Microservice yang di-deploy pada langkah berikutnya hanya mendapatkan akses ke bagian forum yang sudah ada pada saat itu. Jika di-deploy terlalu awal, microservice tidak mendapatkan akses, dan setiap postingan ditolak dengan pesan Your account has been banned from participating in the forums.

Langkah 4: Deploy Microservice

lcp deploy -p <project>-<environment> --extension liferay-forums-etc-spring-boot.zip

Liferay mendaftarkan microservice, dan Liferay Cloud memulainya dengan kredensialnya. Control Panel → Security → OAuth 2 Administration kemudian menampilkan Liferay Forums Etc Spring Boot OAuth Application Headless Server dan Liferay Forums Etc Spring Boot OAuth Application User Agent.

Langkah 5: Deploy Site Initializer

lcp deploy -p <project>-<environment> --extension liferay-forums-site-initializer.zip

Job-nya membuat situs forum di /web/forums.

Langkah 6: Siapkan Notifikasi Email

Batch membuat dua template email dengan alamat pengirim placeholder. Atur alamat yang sebenarnya, lalu restart layanan microservice, liferayforumsetcspringboot, dari konsol Liferay Cloud, sebelum anggota menerima email. Lihat Notifikasi Email.

Langkah 7: Periksa Instalasi

Lanjutkan dengan Memeriksa Instalasi, untuk situs forum di /web/forums.

Jika balasan ditolak, lihat Postingan Ditolak.

Batas Panggilan API

Liferay SaaS membatasi panggilan API per pengguna dan per jam. Microservice memanggil Liferay untuk setiap postingan, sebagai satu pengguna, untuk semua situs forum sekaligus. Forum yang ramai, atau beberapa situs forum yang ramai, dapat mencapai batas tersebut, dan postingan kemudian ditolak hingga jam tersebut berakhir. Konfirmasikan batas yang berlaku saat ini kepada Liferay Support jika Anda memperkirakan penggunaan yang tinggi.

Deploy Berikutnya

  • Jangan deploy batch lagi. Setiap deploy menjalankan job-nya lagi, yang melaporkan item yang gagal untuk template email, karena template tersebut sudah ada. Data Anda dan perubahan Anda pada template tetap tersimpan, tetapi job ditampilkan sebagai gagal.
  • Jangan deploy site initializer lagi. Job-nya akan berjalan lagi, dan mereset alamat situs forum ke /web/group-<number>, yang merusak tautan forum. LPD-85594 tidak mencegah hal ini di Liferay SaaS. Jika hal ini terjadi, kembalikan friendly URL di Site Settings.
  • Deploy microservice lagi hanya untuk versi barunya, dan periksa balasan setelahnya.

Menambahkan Situs Forum Lain

Setiap situs forum mendapatkan zip site initializer tersendiri, yang dibangun dari kode sumber rilis dan di-deploy satu kali. Microservice tidak perlu di-restart. Lihat Beberapa Situs.