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 Self-Hosted (Tomcat)

Ikuti langkah-langkah ini jika Liferay diinstal dari bundle Tomcat di server yang Anda kelola.

Anda memerlukan akses file ke server Liferay, perbaikan Liferay yang diperlukan yang diinstal dengan patching tool Liferay atau solusi sementaranya, dan Liferay harus sudah selesai dimulai sebelum Anda memulai. Dalam langkah-langkah di bawah ini, <liferay-home> adalah folder instalasi Liferay, yaitu folder yang berisi folder osgi dan routes.

1. Langkah 1: Unduh Rilis
2. Langkah 2: Deploy Batch
3. Langkah 3: Deploy Zip Microservice
4. Langkah 4: Mulai Microservice
   1. Di Mesin Liferay
   2. Di Mesin Lain
5. Langkah 5: Siapkan Notifikasi Email
6. Langkah 6: Buat Situs Forum
7. Informasi Terkait

Langkah 1: Unduh Rilis

Dari rilis terbaru, unduh:

• liferay-forums-batch.zip
• liferay-forums-etc-spring-boot.zip
• liferay-forums-site-initializer.zip
• generate-site-initializer-zips.sh, hanya untuk menjalankan beberapa situs forum dengan skrip; lihat Membuat Situs Forum.

Langkah 2: Deploy Batch

1. Salin liferay-forums-batch.zip ke <liferay-home>/osgi/client-extensions.

2. Tunggu hingga log Liferay menampilkan lima baris yang berisi Finished batch engine import task setelah penyalinan. Proses ini memakan waktu sekitar satu menit.

Jangan lanjutkan sebelum kelimanya selesai. Microservice yang di-deploy pada langkah berikutnya hanya mendapatkan akses ke bagian forum yang sudah ada pada saat itu. Liferay juga mencatat beberapa baris seperti ini saat dimulai, jadi hitung hanya baris yang muncul setelah penyalinan.

Langkah 3: Deploy Zip Microservice

Salin liferay-forums-etc-spring-boot.zip ke <liferay-home>/osgi/client-extensions.

Liferay mendaftarkan microservice dan menulis kredensialnya ke <liferay-home>/routes/default. Liferay tidak menjalankan microservice itu sendiri; langkah berikutnya yang memulainya.

Langkah 4: Mulai Microservice

Microservice harus berjalan setiap kali Liferay berjalan: posting, notifikasi, dan moderasi semuanya bergantung padanya. Jalankan di mesin Liferay jika memungkinkan; cara ini lebih sederhana.

Di Mesin Liferay

1. Ekstrak liferay-forums-etc-spring-boot.zip ke folder pilihan Anda, seperti /opt/liferay-forums.

2. Dari folder tersebut, mulai microservice dengan LIFERAY_HOME diatur ke folder instalasi Liferay. Microservice menemukan alamat Liferay dan kredensialnya di sana, sehingga tidak ada yang perlu dikonfigurasi.

   Di Linux:

    LIFERAY_HOME=/opt/liferay ./start.sh
   

   Di Windows:

    set LIFERAY_HOME=C:\liferay
    start.bat
   

   Jika microservice berhenti dengan pesan bahwa routes tidak ada, zip-nya belum di-deploy ke Liferay tersebut, atau LIFERAY_HOME menunjuk ke folder yang salah.

3. Pastikan microservice berjalan. Perintah ini mencetak READY:

    curl http://localhost:58081/ready
   

Agar tetap berjalan setelah reboot di Linux, jalankan sebagai layanan sistem. Misalnya, unit systemd di /etc/systemd/system/liferay-forums.service:

[Unit]
Description=Liferay Forums microservice
After=network.target

[Service]
User=liferay
Environment=LIFERAY_HOME=/opt/liferay
WorkingDirectory=/opt/liferay-forums
ExecStart=/opt/liferay-forums/start.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

Unduh liferay-forums.service

Lalu jalankan sudo systemctl enable --now liferay-forums.

Di Mesin Lain

Liferay selalu memanggil microservice di localhost:58081, jadi port 58081 di mesin Liferay harus diteruskan ke mesin microservice.

1. Di mesin microservice, ekstrak liferay-forums-etc-spring-boot.zip ke folder pilihan Anda.

2. Di application.properties, di samping file jar, hapus tanda komentar dan isi empat pengaturan berikut:

    com.liferay.lxc.dxp.mainDomain=liferay.example.com
    com.liferay.lxc.dxp.server.protocol=https
    liferay-forums-etc-spring-boot-oahs.oauth2.headless.server.client.id=<client ID>
    liferay-forums-etc-spring-boot-oahs.oauth2.headless.server.client.secret=<client secret>
   

   mainDomain dan server.protocol menentukan cara microservice menjangkau Liferay; sertakan port di mainDomain kecuali port-nya 80 atau 443. Client ID dan secret adalah milik Liferay Forums Etc Spring Boot OAuth Application Headless Server, di Control Panel → Security → OAuth 2 Administration.

3. Mulai microservice tanpa LIFERAY_HOME: ./start.sh di Linux, atau start.bat di Windows.

4. Di mesin Liferay, teruskan port 58081 ke mesin microservice, dan biarkan penerusan tetap berjalan selama microservice berjalan. Izinkan port 58081 melewati firewall apa pun di antara kedua mesin. Anda dapat menjalankan socat di mesin Liferay:

    socat TCP-LISTEN:58081,bind=127.0.0.1,fork,reuseaddr TCP:<microservice-host>:58081
   

   Atau buka tunnel SSH dari mesin microservice:

    ssh -N -R 58081:localhost:58081 <user>@<liferay-host>
   

5. Di mesin Liferay, pastikan penerusan menjangkau microservice. Perintah ini mencetak READY:

    curl http://localhost:58081/ready
   

Langkah 5: Siapkan Notifikasi Email

Batch membuat dua template email dengan alamat pengirim placeholder. Atur alamat yang sebenarnya, lalu restart microservice, sebelum anggota menerima email. Lihat Notifikasi Email.

Langkah 6: Buat Situs Forum

Lanjutkan dengan Membuat Situs Forum.

Informasi Terkait

• Memeriksa Instalasi
• Instalasi