Instalasi

Distribusi Glasswall terdiri dari semua library, wrapper, alat, file config, dan file pengujian yang diperlukan untuk memulai dalam satu arsip. Anda perlu mengekstrak arsip tersebut dan menyertakan artefak yang relevan dalam proyek Anda. Struktur direktori yang digunakan dalam contoh di bawah ini benar untuk versi 16.4.0 dan seterusnya; untuk versi engine sebelumnya, Anda perlu menyesuaikan path sistem file yang ditampilkan.

Library Glasswall dibagi berdasarkan Operating System dan arsitektur yang didukung:

• /libs/debian/x86-64 - library OS Linux x86-64
• /libs/debian/arm64 - library OS Linux arm64
• /libs/windows/x86-64 - library OS Windows x86-64

Wrapper khusus bahasa dapat ditemukan di /libs/OS/ARCHITECTURE/sdk_editor_wrappers dan /libs/OS/ARCHITECTURE/sdk_word_search_wrappers. Ini memungkinkan pengguna menggunakan lebih banyak bahasa pemrograman untuk aplikasi mereka sendiri yang menggunakan engine Glasswall. Wrapper tersedia untuk:

• Java (8, 11 dan 18)
• .NET (8 atau lebih tinggi)
• Python (3.6 atau lebih tinggi)

Persyaratan umum​

Persyaratan umum adalah:

• Library Glasswall: glasswall_core2.dll untuk OS Windows dan libglasswall_core2.so untuk Linux. Library ini berisi engine Glasswall.
• Library kamera Glasswall: *_camera.dll untuk OS Windows dan *_camera.so untuk Linux dan Alpine OS. Ini adalah library yang digunakan oleh engine Glasswall untuk memproses jenis file tertentu.
• Policy manajemen konten yang memodifikasi perilaku pemrosesan. Contoh dapat ditemukan di /configs.
• Cara untuk mengeksekusi engine Glasswall. Ini dapat berupa aplikasi yang ditulis menggunakan salah satu wrapper bahasa yang disediakan, atau aplikasi yang berinteraksi langsung dengan library Glasswall.
• Pengaturan policy manajemen konten yang dapat diterapkan untuk mengubah perilaku pemrosesan CDR. Contoh dapat ditemukan di direktori configs.

Instalasi​

Variabel lingkungan​

Variabel lingkungan berikut perlu disiapkan agar Editor dapat menemukan library kamera Glasswall:

QT_PLUGIN_PATH=...: Di mana ... adalah path lengkap ke direktori yang berisi library kamera Editor dan Editor.

Jika Anda mengalami masalah tidak ada dokumen yang diproses meskipun dokumen tersebut didukung, periksa kembali bahwa variabel lingkungan ini telah disiapkan dengan benar.

Variabel lingkungan di Linux​

Variabel lingkungan sementara dapat dibuat dengan menjalankan export QT_PLUGIN_PATH=.... Ini akan membuat variabel lingkungan, tetapi hanya untuk shell saat ini dan proses turunannya. Setelah shell ditutup, variabel ini tidak akan lagi tersedia.

Variabel lingkungan permanen dapat dibuat dengan menambahkan export QT_PLUGIN_PATH=... ke file ~/.bashrc. Ini memungkinkan variabel lingkungan disiapkan setiap kali instance shell dibuat. Setelah menambahkan baris ini, Anda dapat memanggil source ~/.bashrc agar variabel ini tersedia untuk shell saat ini.

Variabel lingkungan di Docker​

Variabel lingkungan permanen dapat dibuat dengan menambahkan ENV QT_PLUGIN_PATH=... ke file Docker Anda.

Variabel lingkungan di Windows​

Variabel lingkungan sementara dapat dibuat dengan menjalankan set QT_PLUGIN_PATH=.... Ini akan membuat variabel lingkungan, tetapi hanya untuk shell saat ini dan proses turunannya. Setelah shell ditutup, variabel ini tidak akan lagi tersedia.

Variabel lingkungan permanen dapat dibuat dengan menjalankan setx QT_PLUGIN_PATH=.... Ini akan membuat variabel lingkungan saat instance shell baru dibuat. Setelah menambahkan baris ini, Anda dapat menjalankan set QT_PLUGIN_PATH=... agar variabel ini tersedia untuk shell saat ini.

PERINGATAN: Perintah di atas akan memotong variabel lingkungan Anda jika melebihi 1024 karakter. Dalam kasus ini Anda perlu menggunakan metode lain, seperti menggunakan antarmuka grafis, untuk membuat variabel lingkungan.

Linux​

Di Linux ada beberapa cara berbeda untuk menginstal library Glasswall. Di sini kami menunjukkan solusi sementara dan beberapa solusi permanen. Untuk setiap contoh, paket rilis telah diekstrak ke /home/Glasswall. Anda mungkin perlu menyesuaikan jalur file agar sesuai dengan lingkungan Anda.

Contoh 1 - solusi sementara​

Pengaturan sementara dapat dibuat dengan mengekstrak arsip ke sebuah direktori lalu menyiapkan variabel lingkungan LD_LIBRARY_PATH=... agar mengarah ke direktori tempat library Glasswall berada.

• Run;
  • export QT_PLUGIN_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor.
  • Ini akan menyiapkan QT_PLUGIN_PATH agar mengarah ke direktori yang berisi library kamera Glasswall.
• Run;
  • export LD_LIBRARY_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor:/home/Glasswall/libs/debian/x86-64/sdk_word_search.
  • Ini akan menyiapkan LD_LIBRARY_PATH agar mengarah ke direktori yang berisi berbagai library. Jika Anda menggunakan Java, Anda juga perlu menambahkan path ke direktori wrapper Java ke LD_LIBRARY_PATH.

Contoh 2 - instalasi di /usr/lib​

Pengaturan permanen dapat dibuat dengan menyalin semua library ke /usr/lib/ atau direktori lain yang dicari oleh linker, lalu menjalankan ldconfig untuk memperbarui daftar library yang terinstal.

• Run with admin privileges;
  • find /home/Glasswall/libs/debian/x86-64 -type f -name "*.so*" -exec install -m 755 "{}" /usr/lib \;
  • Ini akan menyalin semua library Glasswall ke direktori /usr/lib dan menetapkan izin ke 755. Jika Anda menggunakan Java, Anda juga perlu melakukan ini untuk library wrapper Java.
• Run with admin privileges;
  • ldconfig
  • Ini akan memperbarui daftar library yang terinstal sehingga library Glasswall dapat ditemukan.
• Run;
  • echo 'QT_PLUGIN_PATH=/usr/lib/' > ~/.bashrc
  • Ini akan menambahkan variabel lingkungan QT_PLUGIN_PATH secara permanen untuk menunjuk ke lokasi library Glasswall.
• Run;
  • source ~/.bashrc
  • Ini akan memperbarui shell saat ini agar menyertakan variabel lingkungan QT_PLUGIN_PATH.

Contoh 3 - instalasi di /opt/glasswall​

Pengaturan permanen lainnya dapat dibuat dengan menyalin konten arsip yang telah diekstrak ke lokasi seperti /opt/glasswall, dan membuat file konfigurasi di /etc/ld.so.d/ yang memberi tahu sistem tempat menemukan library Glasswall.

• Run with admin privileges;
  • mkdir -p /opt/glasswall
  • Ini akan membuat direktori tempat konten paket rilis akan disimpan.
• Run with admin privileges;
  • cp -r /home/Glasswall/* /opt/glasswall/
  • Ini akan menyalin konten paket rilis yang telah diekstrak ke direktori /opt/glasswall/.
• Run with admin privileges;
  • find /opt/glasswall/ -name "*.so*" -exec chmod 755 "{}" \;
  • Ini akan menemukan semua library Glasswall dan mengatur izinnya menjadi 755
• Run with admin privileges;
  • echo -e "/opt/glasswall/libs/debian/x86-64/sdk_editor\n/opt/glasswall/libs/debian/x86-64/sdk_word_search" >> /etc/ld.so.conf.d/glasswall.conf
  • Ini akan membuat file konfigurasi /etc/ld.so.conf.d/glasswall.conf yang berisi path ke lokasi library Glasswall. Jika Anda menggunakan Java, Anda juga perlu menambahkan path ke library wrapper Java ke glasswall.conf.
• Run with admin privileges;
  • ldconfig
  • Ini akan memperbarui daftar library yang terinstal sehingga library Glasswall dapat ditemukan.
• Run;
  • echo 'QT_PLUGIN_PATH=/opt/glasswall/libs/debian/x86-64/sdk_editor' > ~/.bashrc
  • Ini akan menambahkan variabel lingkungan QT_PLUGIN_PATH secara permanen untuk menunjuk ke lokasi library Glasswall.
• Run;
  • source ~/.bashrc
  • Ini akan memperbarui instance shell saat ini agar menyertakan variabel lingkungan QT_PLUGIN_PATH.

Windows​

Pengaturan untuk Windows sangat mirip dengan pengaturan untuk Linux, di mana Anda perlu menentukan lokasi penyimpanan library Glasswall, lalu menyiapkan variabel lingkungan agar library Glasswall dapat ditemukan. Dalam contoh kami, kami menyimpan konten arsip rilis di C:\Program Files\Glasswall.

• Ekstrak konten arsip Release ke C:\Program Files\Glasswall
• Add the following paths to the PATH environment variable:
  • C:\Program Files\Glasswall\libs\windows\x86-64\sdk_editor
  • C:\Program Files\Glasswall\libs\windows\x86-64\sdk_word_search
• Jika Anda menggunakan Java, tambahkan path yang sesuai yang berisi library wrapper Java ke variabel lingkungan PATH.
• Add the Editor cameras directory to the QT_PLUGIN_PATH environment variable. For example:
  • C:\Program Files\Glasswall\libs\windows\x86-64\sdk_editor

OpenSSL dan Visual C++ Redistributable​

Pengguna Windows juga perlu menginstal OpenSSL dan paket Visual C++ Redistributable. Instalasi OpenSSL melalui Chocolatey direkomendasikan karena juga akan menginstal Visual C++ Redistributable.

• Petunjuk untuk menginstal Chocolatey dapat ditemukan di sini.
• Setelah Chocolatey terinstal, buka command prompt atau Windows Power Shell dengan izin administratif.
• Ketik perintah choco install openssl dan ikuti instruksi untuk menyelesaikan instalasi.
• Setelah selesai, mulai ulang aplikasi atau sesi konsol apa pun untuk menerapkan environment variables yang diperbarui.