メイン コンテンツにスキップ

インストール

Glasswall の配布物には、単一のアーカイブ内に、開始に必要なすべてのライブラリ、ラッパー、ツール、設定ファイル、およびテストファイルが含まれています。アーカイブを展開し、関連する成果物をプロジェクトに含める必要があります。以下の例で使用されているディレクトリ構造は version 16.4.0 以降では正しいものです。以前のバージョンのエンジンでは、表示されているファイルシステムパスを調整する必要があります。

Glasswall ライブラリは、サポートされるオペレーティングシステムとアーキテクチャごとに分かれています:

  • /libs/debian/x86-64 - Linux x86-64 OS ライブラリ
  • /libs/debian/arm64 - Linux arm64 OS ライブラリ
  • /libs/windows/x86-64 - Windows x86-64 OS ライブラリ

言語固有のラッパーは /libs/OS/ARCHITECTURE/sdk_editor_wrappers および /libs/OS/ARCHITECTURE/sdk_word_search_wrappers にあります。これにより、ユーザーは Glasswall engine を使用する独自のアプリケーションで、より幅広いプログラミング言語を利用できます。ラッパーは以下に対応しています:

  • Java (8、11、18)
  • .NET (8 以上)
  • Python (3.6 以上)

一般要件​

一般要件は次のとおりです:

  • Glasswall ライブラリ: Windows OS 用の glasswall_core2.dll と Linux 用の libglasswall_core2.so。これらのライブラリには Glasswall engine が含まれています。
  • Glasswall カメラライブラリ: Windows OS 用の *_camera.dll と、Linux および Alpine OS 用の *_camera.so。これらは、特定のファイルタイプを処理するために Glasswall engine が使用するライブラリです。
  • 処理動作を変更するコンテンツ管理 policy。例は /configs にあります。
  • Glasswall engine を実行する手段。これは、提供されている言語ラッパーのいずれかを使用して作成されたアプリケーション、または Glasswall ライブラリと直接やり取りするアプリケーションです。
  • CDR の処理動作を変更するために適用できるコンテンツ管理 policy 設定。例は configs ディレクトリにあります。

インストール​

環境変数​

Editor が Glasswall camera libraries を見つけられるようにするには、次の環境変数を設定する必要があります:

QT_PLUGIN_PATH=...: ... は、Editor および Editor camera libraries を含むディレクトリへの完全パスです。

サポートされているにもかかわらずドキュメントがまったく処理されない問題が発生している場合は、この環境変数が正しく設定されていることを再確認してください。

Linux での環境変数​

一時的な環境変数は、export QT_PLUGIN_PATH=... を実行することで作成できます。これにより環境変数は作成されますが、現在のシェルとその子プロセスに対してのみ有効です。シェルを閉じると、この変数は利用できなくなります。

A permanent environment variable can be created by adding export QT_PLUGIN_PATH=... to the ~/.bashrc file. This enables the environment variable to be set up every time a shell instance is created. After adding this line you can call source ~/.bashrc to enable this variable to be present for the current shell.

Docker での環境変数​

永続的な環境変数は、Docker file に ENV QT_PLUGIN_PATH=... を追加することで作成できます。

Windows での環境変数​

一時的な環境変数は、set QT_PLUGIN_PATH=... を実行することで作成できます。これにより環境変数は作成されますが、現在のシェルとその子プロセスでのみ有効です。シェルを閉じると、この変数は利用できなくなります。

永続的な環境変数は、setx QT_PLUGIN_PATH=... を実行することで作成できます。これにより、新しいシェルインスタンスが作成されたときに環境変数が作成されます。この行を追加した後、set QT_PLUGIN_PATH=... を実行すると、現在のシェルでもこの変数を有効にできます。

警告: 上記のコマンドでは、環境変数が 1024 文字を超える場合に切り詰められます。この場合、環境変数を作成するには、グラフィカルインターフェースを使用するなど、別の方法を使用する必要があります。

Linux​

Linux では、Glasswall ライブラリをインストールする方法がいくつかあります。ここでは、一時的な方法といくつかの永続的な方法を示します。各例では、リリースパッケージは /home/Glasswall に展開されています。お使いの環境に合わせてファイルパスを調整する必要がある場合があります。

例 1 - 一時的な方法​

一時的なセットアップは、アーカイブをディレクトリに展開し、その後、環境変数 LD_LIBRARY_PATH=... を設定して、Glasswall ライブラリが配置されているディレクトリを指すようにすることで作成できます。

  • Run;
    • export QT_PLUGIN_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor.
    • これにより、QT_PLUGIN_PATH が Glasswall カメラライブラリを含むディレクトリを指すように設定されます。
  • Run;
    • export LD_LIBRARY_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor:/home/Glasswall/libs/debian/x86-64/sdk_word_search.
    • これにより、LD_LIBRARY_PATH が各種ライブラリを含むディレクトリを指すように設定されます。Java を使用している場合は、Java ラッパーディレクトリへのパスも LD_LIBRARY_PATH に追加する必要があります。

例 2 - /usr/lib へのインストール​

永続的なセットアップは、すべてのライブラリを /usr/lib/ またはリンカーが検索する別のディレクトリにコピーし、その後 ldconfig を実行してインストール済みライブラリの一覧を更新することで作成できます。

  • Run with admin privileges;
    • find /home/Glasswall/libs/debian/x86-64 -type f -name "*.so*" -exec install -m 755 "{}" /usr/lib \;
    • これにより、すべての Glasswall ライブラリが /usr/lib ディレクトリにコピーされ、権限が 755 に設定されます。Java を使用している場合は、Java ラッパーライブラリについても同様に行う必要があります。
  • Run with admin privileges;
    • ldconfig
    • これにより、インストール済みライブラリの一覧が更新され、Glasswall ライブラリを見つけられるようになります。
  • Run;
    • echo 'QT_PLUGIN_PATH=/usr/lib/' > ~/.bashrc
    • これにより、Glasswall ライブラリの場所を指す QT_PLUGIN_PATH 環境変数が永続的に追加されます。
  • Run;
    • source ~/.bashrc
    • これにより、現在のシェルが更新され、QT_PLUGIN_PATH 環境変数が含まれるようになります。

例 3 - /opt/glasswall へのインストール​

抽出したアーカイブの内容を/opt/glasswallのような場所にコピーし、システムにGlasswallライブラリの場所を知らせる設定ファイルを/etc/ld.so.d/に作成することで、別の永続的なセットアップを作成できます。

  • Run with admin privileges;
    • mkdir -p /opt/glasswall
    • これにより、リリースパッケージの内容を保存するディレクトリが作成されます。
  • Run with admin privileges;
    • cp -r /home/Glasswall/* /opt/glasswall/
    • これにより、リリースパッケージの抽出済みコンテンツが/opt/glasswall/ディレクトリにコピーされます。
  • Run with admin privileges;
    • find /opt/glasswall/ -name "*.so*" -exec chmod 755 "{}" \;
    • これにより、すべてのGlasswallライブラリが検索され、それらの権限が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
    • これにより、Glasswallライブラリの場所へのパスを含む設定ファイル/etc/ld.so.conf.d/glasswall.confが作成されます。Javaを使用している場合は、Javaラッパーライブラリへのパスもglasswall.confに追加する必要があります。
  • Run with admin privileges;
    • ldconfig
    • これにより、インストール済みライブラリの一覧が更新され、Glasswall ライブラリを見つけられるようになります。
  • Run;
    • echo 'QT_PLUGIN_PATH=/opt/glasswall/libs/debian/x86-64/sdk_editor' > ~/.bashrc
    • これにより、Glasswall ライブラリの場所を指す QT_PLUGIN_PATH 環境変数が永続的に追加されます。
  • Run;
    • source ~/.bashrc
    • これにより、現在のシェルインスタンスが更新され、QT_PLUGIN_PATH環境変数が含まれるようになります。

Windows​

WindowsのセットアップはLinuxのセットアップと非常によく似ており、Glasswallライブラリを保存する場所を決め、その後、Glasswallライブラリを見つけられるように環境変数を設定する必要があります。この例では、リリースアーカイブの内容をC:\Program Files\Glasswallに保存しています。

  • Releaseアーカイブの内容を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
  • Java を使用している場合は、Java ラッパーライブラリを含む適切なパスを 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 と Visual C++ Redistributable​

Windows ユーザーは、OpenSSL と Visual C++ Redistributable パッケージもインストールする必要があります。Visual C++ Redistributable もあわせてインストールされるため、Chocolatey を使用した OpenSSL のインストールを推奨します。

  • Chocolatey のインストール手順はこちらで確認できます。
  • Chocolatey のインストール後、管理者権限でコマンド プロンプトまたは Windows Power Shell を開きます。
  • choco install openssl コマンドを入力し、指示に従ってインストールを完了してください。
  • 完了したら、更新された環境変数を適用するために、アプリケーションまたはコンソール セッションを再起動してください。
最終更新日: