Pemasangan

Pengedaran Glasswall terdiri daripada semua library, wrapper, alat, fail config dan ujian yang diperlukan untuk bermula dalam satu arkib. Anda perlu mengekstrak arkib tersebut dan memasukkan artifak yang berkaitan ke dalam projek anda. Struktur direktori yang digunakan dalam contoh di bawah adalah betul untuk version 16.4.0 dan seterusnya, untuk version engine yang terdahulu anda perlu melaraskan laluan sistem fail yang ditunjukkan.

Pustaka Glasswall dibahagikan mengikut Sistem Pengendalian dan seni bina yang disokong:

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

Wrapper khusus bahasa boleh didapati dalam /libs/OS/ARCHITECTURE/sdk_editor_wrappers dan /libs/OS/ARCHITECTURE/sdk_word_search_wrappers. Ini membolehkan pengguna menggunakan julat bahasa pengaturcaraan yang lebih luas untuk aplikasi mereka sendiri yang menggunakan enjin Glasswall. Wrapper tersedia untuk:

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

Keperluan umum​

Keperluan umum adalah:

• Pustaka Glasswall: glasswall_core2.dll untuk OS Windows dan libglasswall_core2.so untuk Linux. Pustaka ini mengandungi enjin Glasswall.
• Pustaka kamera Glasswall: *_camera.dll untuk OS Windows dan *_camera.so untuk Linux dan OS Alpine. Ini ialah pustaka yang digunakan oleh enjin Glasswall untuk memproses jenis fail tertentu.
• policy pengurusan kandungan yang mengubah suai tingkah laku pemprosesan. Contoh boleh didapati dalam /configs.
• Satu cara untuk melaksanakan enjin Glasswall. Ini boleh berupa aplikasi yang ditulis menggunakan salah satu wrapper bahasa yang disediakan, atau aplikasi yang berinteraksi secara langsung dengan pustaka Glasswall.
• Tetapan policy pengurusan kandungan yang boleh digunakan untuk mengubah tingkah laku pemprosesan CDR. Contoh boleh didapati dalam direktori configs.

Pemasangan​

Pemboleh ubah persekitaran​

Pemboleh ubah persekitaran berikut perlu disediakan supaya Editor dapat mencari pustaka kamera Glasswall:

QT_PLUGIN_PATH=...: Di mana ... ialah laluan penuh ke direktori yang mengandungi pustaka kamera Editor dan Editor.

Jika anda menghadapi isu apabila tiada dokumen diproses walaupun dokumen tersebut disokong, semak semula bahawa pemboleh ubah persekitaran ini disediakan dengan betul.

Pemboleh ubah persekitaran dalam Linux​

Pemboleh ubah persekitaran sementara boleh dicipta dengan menjalankan export QT_PLUGIN_PATH=.... Ini akan mencipta pemboleh ubah persekitaran tersebut, tetapi hanya untuk shell semasa dan proses anaknya. Setelah shell ditutup, pemboleh ubah ini tidak lagi tersedia.

Pemboleh ubah persekitaran kekal boleh dicipta dengan menambah export QT_PLUGIN_PATH=... ke fail ~/.bashrc. Ini membolehkan pemboleh ubah persekitaran disediakan setiap kali instance shell dicipta. Selepas menambah baris ini, anda boleh memanggil source ~/.bashrc untuk membolehkan pemboleh ubah ini hadir bagi shell semasa.

Pemboleh ubah persekitaran dalam Docker​

Pemboleh ubah persekitaran kekal boleh dicipta dengan menambah ENV QT_PLUGIN_PATH=... ke fail Docker anda.

Pemboleh ubah persekitaran dalam Windows​

Pemboleh ubah persekitaran sementara boleh dicipta dengan menjalankan set QT_PLUGIN_PATH=.... Ini akan mencipta pemboleh ubah persekitaran tersebut, tetapi hanya untuk shell semasa dan proses anaknya. Setelah shell ditutup, pemboleh ubah ini tidak lagi tersedia.

Pemboleh ubah persekitaran kekal boleh dicipta dengan menjalankan setx QT_PLUGIN_PATH=.... Ini akan mencipta pemboleh ubah persekitaran apabila instance shell baharu dicipta. Selepas menambah baris ini, anda boleh menjalankan set QT_PLUGIN_PATH=... untuk membolehkan pemboleh ubah ini hadir bagi shell semasa.

AMARAN: Arahan di atas akan memendekkan pemboleh ubah persekitaran anda jika ia melebihi 1024 aksara. Dalam kes ini, anda perlu menggunakan kaedah lain, seperti menggunakan antara muka grafik, untuk mencipta pemboleh ubah persekitaran tersebut.

Linux​

Di Linux terdapat beberapa cara berbeza untuk memasang pustaka Glasswall. Di sini kami menunjukkan satu penyelesaian sementara dan beberapa penyelesaian kekal. Bagi setiap contoh, pakej keluaran telah diekstrak ke /home/Glasswall. Anda mungkin perlu menyesuaikan laluan fail agar sepadan dengan persekitaran anda.

Contoh 1 - penyelesaian sementara​

Persediaan sementara boleh dibuat dengan mengekstrak arkib ke dalam direktori dan kemudian menetapkan pemboleh ubah persekitaran LD_LIBRARY_PATH=... supaya menunjuk ke direktori tempat pustaka Glasswall berada.

• Run;
  • export QT_PLUGIN_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor.
  • Ini akan menetapkan QT_PLUGIN_PATH supaya menunjuk ke direktori yang mengandungi pustaka 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 menetapkan LD_LIBRARY_PATH supaya menunjuk ke direktori yang mengandungi pelbagai pustaka. Jika anda menggunakan Java, anda juga perlu menambah laluan ke direktori pembalut Java ke dalam LD_LIBRARY_PATH.

Contoh 2 - pemasangan dalam /usr/lib​

Persediaan kekal boleh dibuat dengan menyalin semua pustaka ke /usr/lib/ atau direktori lain yang dicari oleh pemaut, dan kemudian menjalankan ldconfig untuk mengemas kini senarai pustaka yang dipasang.

• 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 pustaka Glasswall ke dalam direktori /usr/lib dan menetapkan keizinan kepada 755. Jika anda menggunakan Java, anda juga perlu melakukan ini untuk pustaka pembalut Java.
• Run with admin privileges;
  • ldconfig
  • Ini akan mengemas kini senarai pustaka yang dipasang supaya pustaka Glasswall boleh ditemui.
• Run;
  • echo 'QT_PLUGIN_PATH=/usr/lib/' > ~/.bashrc
  • Ini akan menambah pemboleh ubah persekitaran QT_PLUGIN_PATH secara kekal supaya menunjuk ke lokasi pustaka Glasswall.
• Run;
  • source ~/.bashrc
  • Ini akan mengemas kini shell semasa untuk memasukkan pemboleh ubah persekitaran QT_PLUGIN_PATH.

Contoh 3 - pemasangan dalam /opt/glasswall​

Satu lagi persediaan kekal boleh dibuat dengan menyalin kandungan arkib yang diekstrak ke lokasi seperti /opt/glasswall, dan mencipta fail konfigurasi dalam /etc/ld.so.d/ yang memberitahu sistem di mana untuk mencari pustaka Glasswall.

• Run with admin privileges;
  • mkdir -p /opt/glasswall
  • Ini akan mencipta direktori tempat kandungan pakej keluaran akan disimpan.
• Run with admin privileges;
  • cp -r /home/Glasswall/* /opt/glasswall/
  • Ini akan menyalin kandungan pakej keluaran yang telah diekstrak ke dalam direktori /opt/glasswall/.
• Run with admin privileges;
  • find /opt/glasswall/ -name "*.so*" -exec chmod 755 "{}" \;
  • Ini akan mencari semua pustaka Glasswall dan menetapkan keizinannya kepada 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 mencipta fail konfigurasi /etc/ld.so.conf.d/glasswall.conf yang mengandungi laluan ke lokasi pustaka Glasswall. Jika anda menggunakan Java, anda juga perlu menambah laluan ke pustaka pembalut Java ke glasswall.conf.
• Run with admin privileges;
  • ldconfig
  • Ini akan mengemas kini senarai pustaka yang dipasang supaya pustaka Glasswall boleh ditemui.
• Run;
  • echo 'QT_PLUGIN_PATH=/opt/glasswall/libs/debian/x86-64/sdk_editor' > ~/.bashrc
  • Ini akan menambah pemboleh ubah persekitaran QT_PLUGIN_PATH secara kekal supaya menunjuk ke lokasi pustaka Glasswall.
• Run;
  • source ~/.bashrc
  • Ini akan mengemas kini instance shell semasa untuk memasukkan pemboleh ubah persekitaran QT_PLUGIN_PATH.

Windows​

Persediaan untuk Windows sangat serupa dengan persediaan untuk Linux, di mana anda perlu mencari lokasi untuk menyimpan pustaka Glasswall, dan kemudian menetapkan pemboleh ubah persekitaran supaya pustaka Glasswall boleh ditemui. Dalam contoh kami, kami menyimpan kandungan arkib keluaran dalam C:\Program Files\Glasswall.

• Ekstrak kandungan arkib Release ke dalam 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 laluan yang sesuai yang mengandungi pustaka pembalut Java ke pemboleh ubah persekitaran 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 memasang OpenSSL dan pakej Visual C++ Redistributable. Pemasangan OpenSSL melalui Chocolatey adalah disyorkan kerana ia juga akan memasang Visual C++ Redistributable.

• Arahan untuk memasang Chocolatey boleh didapati di sini.
• Setelah Chocolatey dipasang, buka command prompt atau Windows Power Shell dengan kebenaran pentadbiran.
• Taip arahan choco install openssl dan ikuti arahan untuk melengkapkan pemasangan.
• Setelah selesai, mulakan semula sebarang aplikasi atau sesi konsol untuk menggunakan pemboleh ubah persekitaran yang dikemas kini.