Cài đặt

Bản phân phối Glasswall bao gồm tất cả các thư viện, wrapper, công cụ, tệp cấu hình và tệp kiểm thử cần thiết để bắt đầu trong một gói lưu trữ duy nhất. Bạn sẽ cần giải nén gói lưu trữ và đưa các thành phần liên quan vào dự án của mình. Cấu trúc thư mục được sử dụng trong các ví dụ bên dưới là chính xác cho phiên bản 16.4.0 trở đi; đối với các phiên bản trước của engine, bạn sẽ cần điều chỉnh các đường dẫn hệ thống tệp được hiển thị.

Các thư viện Glasswall được phân chia theo Hệ điều hành và kiến trúc được hỗ trợ:

• /libs/debian/x86-64 - thư viện hệ điều hành Linux x86-64
• /libs/debian/arm64 - thư viện hệ điều hành Linux arm64
• /libs/windows/x86-64 - thư viện hệ điều hành Windows x86-64

Có thể tìm thấy các wrapper dành riêng cho ngôn ngữ trong /libs/OS/ARCHITECTURE/sdk_editor_wrappers và /libs/OS/ARCHITECTURE/sdk_word_search_wrappers. Chúng cho phép người dùng sử dụng nhiều ngôn ngữ lập trình hơn cho các ứng dụng riêng của họ có sử dụng engine Glasswall. Các wrapper hiện có cho:

• Java (8, 11 và 18)
• .NET (8 trở lên)
• Python (3.6 trở lên)

Yêu cầu chung​

Các yêu cầu chung bao gồm:

• Các thư viện Glasswall: glasswall_core2.dll cho hệ điều hành Windows và libglasswall_core2.so cho Linux. Các thư viện này chứa engine Glasswall.
• Các thư viện camera của Glasswall: *_camera.dll cho hệ điều hành Windows và *_camera.so cho Linux và Alpine OS. Đây là các thư viện được engine Glasswall sử dụng để xử lý các loại tệp cụ thể.
• Các policy quản lý nội dung dùng để sửa đổi hành vi xử lý. Có thể tìm thấy ví dụ trong /configs.
• Một cách để thực thi engine Glasswall. Đây có thể là một ứng dụng được viết bằng một trong các wrapper ngôn ngữ được cung cấp, hoặc một ứng dụng tương tác trực tiếp với thư viện Glasswall.
• Các thiết lập policy quản lý nội dung có thể được áp dụng để thay đổi hành vi xử lý CDR. Có thể tìm thấy ví dụ trong thư mục configs.

Cài đặt​

Biến môi trường​

Biến môi trường sau đây cần được thiết lập để Editor có thể tìm thấy các thư viện camera của Glasswall:

QT_PLUGIN_PATH=...: Trong đó ... là đường dẫn đầy đủ tới thư mục chứa các thư viện camera của Editor và Editor.

Nếu bạn gặp sự cố không có tài liệu nào được xử lý dù chúng được hỗ trợ, hãy kiểm tra lại xem biến môi trường này đã được thiết lập đúng chưa.

Biến môi trường trong Linux​

Có thể tạo một biến môi trường tạm thời bằng cách chạy export QT_PLUGIN_PATH=.... Thao tác này sẽ tạo biến môi trường, nhưng chỉ cho shell hiện tại và các tiến trình con của nó. Khi shell được đóng, biến này sẽ không còn khả dụng nữa.

Có thể tạo một biến môi trường vĩnh viễn bằng cách thêm export QT_PLUGIN_PATH=... vào tệp ~/.bashrc. Việc này cho phép biến môi trường được thiết lập mỗi khi một phiên bản shell được tạo. Sau khi thêm dòng này, bạn có thể gọi source ~/.bashrc để biến này có mặt trong shell hiện tại.

Biến môi trường trong Docker​

Có thể tạo một biến môi trường vĩnh viễn bằng cách thêm ENV QT_PLUGIN_PATH=... vào tệp Docker của bạn.

Biến môi trường trong Windows​

Có thể tạo một biến môi trường tạm thời bằng cách chạy set QT_PLUGIN_PATH=.... Thao tác này sẽ tạo biến môi trường, nhưng chỉ cho shell hiện tại và các tiến trình con của nó. Khi shell được đóng, biến này sẽ không còn khả dụng nữa.

Có thể tạo một biến môi trường vĩnh viễn bằng cách chạy setx QT_PLUGIN_PATH=.... Thao tác này sẽ tạo biến môi trường khi một phiên bản shell mới được tạo. Sau khi thêm dòng này, bạn có thể chạy set QT_PLUGIN_PATH=... để biến này có mặt trong shell hiện tại.

CẢNH BÁO: Các lệnh ở trên sẽ cắt ngắn biến môi trường của bạn nếu nó vượt quá 1024 ký tự. Trong trường hợp này, bạn sẽ cần sử dụng phương pháp khác, chẳng hạn như dùng giao diện đồ họa, để tạo biến môi trường.

Linux​

Trên Linux có một vài cách khác nhau để cài đặt các thư viện Glasswall. Tại đây, chúng tôi minh họa một giải pháp tạm thời và một số giải pháp lâu dài. Với mỗi ví dụ, gói phát hành đã được giải nén vào /home/Glasswall. Bạn có thể cần điều chỉnh các đường dẫn tệp để phù hợp với môi trường của mình.

Ví dụ 1 - giải pháp tạm thời​

Có thể tạo một thiết lập tạm thời bằng cách giải nén kho lưu trữ vào một thư mục rồi thiết lập biến môi trường LD_LIBRARY_PATH=... để trỏ tới các thư mục chứa các thư viện Glasswall.

• Run;
  • export QT_PLUGIN_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor.
  • Thao tác này sẽ thiết lập QT_PLUGIN_PATH để trỏ tới thư mục chứa các thư viện camera Glasswall.
• Run;
  • export LD_LIBRARY_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor:/home/Glasswall/libs/debian/x86-64/sdk_word_search.
  • Thao tác này sẽ thiết lập LD_LIBRARY_PATH để trỏ tới các thư mục chứa các thư viện khác nhau. Nếu bạn đang sử dụng Java, bạn cũng sẽ cần thêm các đường dẫn tới các thư mục Java wrapper vào LD_LIBRARY_PATH.

Ví dụ 2 - cài đặt trong /usr/lib​

Có thể tạo một thiết lập vĩnh viễn bằng cách sao chép tất cả các thư viện vào /usr/lib/ hoặc một thư mục khác được linker tìm kiếm, rồi chạy ldconfig để cập nhật danh sách các thư viện đã cài đặt.

• Run with admin privileges;
  • find /home/Glasswall/libs/debian/x86-64 -type f -name "*.so*" -exec install -m 755 "{}" /usr/lib \;
  • Thao tác này sẽ sao chép tất cả các thư viện Glasswall vào thư mục /usr/lib và đặt quyền thành 755. Nếu bạn đang sử dụng Java, bạn cũng sẽ cần thực hiện việc này cho các thư viện Java wrapper.
• Run with admin privileges;
  • ldconfig
  • Thao tác này sẽ cập nhật danh sách các thư viện đã cài đặt để có thể tìm thấy các thư viện Glasswall.
• Run;
  • echo 'QT_PLUGIN_PATH=/usr/lib/' > ~/.bashrc
  • Thao tác này sẽ thêm vĩnh viễn biến môi trường QT_PLUGIN_PATH để trỏ tới vị trí của các thư viện Glasswall.
• Run;
  • source ~/.bashrc
  • Thao tác này sẽ cập nhật shell hiện tại để bao gồm biến môi trường QT_PLUGIN_PATH.

Ví dụ 3 - cài đặt trong /opt/glasswall​

Một thiết lập cố định khác có thể được tạo bằng cách sao chép nội dung của kho lưu trữ đã giải nén vào một vị trí như /opt/glasswall, và tạo một tệp cấu hình trong /etc/ld.so.d/ để cho hệ thống biết nơi tìm các thư viện Glasswall.

• Run with admin privileges;
  • mkdir -p /opt/glasswall
  • Lệnh này sẽ tạo thư mục nơi nội dung của gói phát hành sẽ được lưu trữ.
• Run with admin privileges;
  • cp -r /home/Glasswall/* /opt/glasswall/
  • Lệnh này sẽ sao chép nội dung đã giải nén của gói phát hành vào thư mục /opt/glasswall/.
• Run with admin privileges;
  • find /opt/glasswall/ -name "*.so*" -exec chmod 755 "{}" \;
  • Lệnh này sẽ tìm tất cả các thư viện Glasswall và đặt quyền của chúng thành 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
  • Lệnh này sẽ tạo tệp cấu hình /etc/ld.so.conf.d/glasswall.conf chứa các đường dẫn tới vị trí của các thư viện Glasswall. Nếu bạn đang sử dụng Java, bạn cũng sẽ cần thêm các đường dẫn tới các thư viện wrapper Java vào glasswall.conf.
• Run with admin privileges;
  • ldconfig
  • Thao tác này sẽ cập nhật danh sách các thư viện đã cài đặt để có thể tìm thấy các thư viện Glasswall.
• Run;
  • echo 'QT_PLUGIN_PATH=/opt/glasswall/libs/debian/x86-64/sdk_editor' > ~/.bashrc
  • Thao tác này sẽ thêm vĩnh viễn biến môi trường QT_PLUGIN_PATH để trỏ tới vị trí của các thư viện Glasswall.
• Run;
  • source ~/.bashrc
  • Lệnh này sẽ cập nhật phiên shell hiện tại để bao gồm biến môi trường QT_PLUGIN_PATH.

Windows​

Thiết lập cho Windows rất giống với thiết lập cho Linux, trong đó bạn cần tìm một nơi để lưu trữ các thư viện Glasswall, sau đó thiết lập các biến môi trường để có thể tìm thấy các thư viện Glasswall. Trong ví dụ của chúng tôi, chúng tôi lưu trữ nội dung của kho lưu trữ phát hành trong C:\Program Files\Glasswall.

• Giải nén nội dung của kho lưu trữ Release vào 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
• Nếu bạn đang sử dụng Java, hãy thêm các đường dẫn thích hợp chứa các thư viện wrapper Java vào biến môi trường 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 và Visual C++ Redistributable​

Người dùng Windows cũng sẽ cần cài đặt OpenSSL và các gói Visual C++ Redistributable. Bạn nên cài đặt OpenSSL bằng Chocolatey; cách này cũng sẽ cài đặt Visual C++ Redistributable.

• Hướng dẫn cài đặt Chocolatey có thể được tìm thấy tại đây.
• Sau khi Chocolatey được cài đặt, hãy mở command prompt hoặc Windows Power Shell với quyền quản trị.
• Nhập lệnh choco install openssl và làm theo hướng dẫn để hoàn tất quá trình cài đặt.
• Sau khi hoàn tất, hãy khởi động lại mọi ứng dụng hoặc phiên console để áp dụng các biến môi trường đã được cập nhật.