주요 콘텐츠로 건너뛰기

설치

Glasswall 배포판은 단일 아카이브 내에서 시작하는 데 필요한 모든 라이브러리, 래퍼, 도구, config 및 테스트 파일로 구성됩니다. 아카이브를 추출하고 프로젝트에 관련 아티팩트를 포함해야 합니다. 아래 예제에서 사용된 디렉터리 구조는 버전 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 라이브러리를 찾을 수 있도록 하려면 다음 환경 변수를 설정해야 합니다:

QT_PLUGIN_PATH=...: 여기서 ...는 Editor 및 Editor camera 라이브러리가 포함된 디렉터리의 전체 경로입니다.

지원되는 문서임에도 처리되는 문서가 없는 문제가 발생하는 경우, 이 환경 변수가 올바르게 설정되어 있는지 다시 확인하세요.

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 파일에 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 wrapper 디렉터리의 경로도 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 wrapper 라이브러리에 대해서도 이 작업을 수행해야 합니다.
  • Run with admin privileges;
    • ldconfig
    • 이렇게 하면 설치된 라이브러리 목록이 업데이트되어 Glasswall 라이브러리를 찾을 수 있게 됩니다.
  • Run;
    • echo 'QT_PLUGIN_PATH=/usr/lib/' > ~/.bashrc
    • 이렇게 하면 QT_PLUGIN_PATH 환경 변수가 Glasswall 라이브러리 위치를 가리키도록 영구적으로 추가됩니다.
  • Run;
    • source ~/.bashrc
    • 이렇게 하면 현재 셸이 업데이트되어 QT_PLUGIN_PATH 환경 변수가 포함됩니다.

예제 3 - /opt/glasswall에 설치​

압축 해제된 아카이브의 내용을 /opt/glasswall와 같은 위치에 복사하고, 시스템에 Glasswall 라이브러리를 찾을 위치를 알려주는 config 파일을 /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 라이브러리 위치의 경로가 포함된 configuration 파일 /etc/ld.so.conf.d/glasswall.conf를 생성합니다. Java를 사용하는 경우 Java wrapper 라이브러리의 경로도 glasswall.conf에 추가해야 합니다.
  • Run with admin privileges;
    • ldconfig
    • 이렇게 하면 설치된 라이브러리 목록이 업데이트되어 Glasswall 라이브러리를 찾을 수 있게 됩니다.
  • Run;
    • echo 'QT_PLUGIN_PATH=/opt/glasswall/libs/debian/x86-64/sdk_editor' > ~/.bashrc
    • 이렇게 하면 QT_PLUGIN_PATH 환경 변수가 Glasswall 라이브러리 위치를 가리키도록 영구적으로 추가됩니다.
  • Run;
    • source ~/.bashrc
    • 이 명령은 현재 셸 인스턴스를 업데이트하여 QT_PLUGIN_PATH environment variable을 포함하도록 합니다.

Windows​

Windows 설정은 Linux 설정과 매우 유사합니다. Glasswall 라이브러리를 저장할 위치를 정한 다음, Glasswall 라이브러리를 찾을 수 있도록 environment variable을 설정해야 합니다. 이 예시에서는 릴리스 아카이브의 내용을 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 wrapper libraries가 포함된 적절한 경로를 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가 설치되면 관리자 권한으로 command prompt 또는 Windows Power Shell을 엽니다.
  • choco install openssl 명령을 입력하고 안내에 따라 설치를 완료합니다.
  • 완료되면 업데이트된 환경 변수를 적용하기 위해 모든 애플리케이션 또는 콘솔 세션을 다시 시작합니다.
마지막 업데이트: