मुख्य सामग्री पर जाएँ

इंस्टॉलेशन

Glasswall distribution में एक ही archive के भीतर शुरू करने के लिए आवश्यक सभी libraries, wrappers, tools, config और test files शामिल हैं। आपको archive को extract करना होगा और अपने project में संबंधित artifacts शामिल करने होंगे। नीचे दिए गए उदाहरणों में उपयोग की गई directory structure version 16.4.0 onwards के लिए सही है; engine के पिछले versions के लिए आपको दिखाए गए file system paths को समायोजित करना होगा।

Glasswall लाइब्रेरीज़ समर्थित Operating System और architecture के अनुसार विभाजित हैं:

  • /libs/debian/x86-64 - Linux x86-64 OS लाइब्रेरीज़
  • /libs/debian/arm64 - Linux arm64 OS लाइब्रेरीज़
  • /libs/windows/x86-64 - Windows x86-64 OS लाइब्रेरीज़

भाषा-विशिष्ट wrappers /libs/OS/ARCHITECTURE/sdk_editor_wrappers और /libs/OS/ARCHITECTURE/sdk_word_search_wrappers में मिल सकते हैं। ये उपयोगकर्ताओं को अपने उन applications के लिए programming languages की अधिक विस्तृत range का उपयोग करने की अनुमति देते हैं जो Glasswall engine का उपयोग करते हैं। Wrappers इनके लिए उपलब्ध हैं:

  • Java (8, 11 और 18)
  • .NET (8 या उससे उच्च)
  • Python (3.6 या उससे उच्च)

सामान्य आवश्यकताएँ​

सामान्य आवश्यकताएँ इस प्रकार हैं:

  • Glasswall लाइब्रेरीज़: Windows OS के लिए glasswall_core2.dll और Linux के लिए libglasswall_core2.so। इन लाइब्रेरीज़ में Glasswall engine शामिल है।
  • Glasswall camera लाइब्रेरीज़: Windows OS के लिए *_camera.dll और Linux तथा Alpine OS के लिए *_camera.so। ये वे लाइब्रेरीज़ हैं जिनका उपयोग Glasswall engine विशिष्ट filetypes को process करने के लिए करता है।
  • Content management policies जो processing behaviour को संशोधित करती हैं। उदाहरण /configs में मिल सकते हैं।
  • Glasswall engine को execute करने का एक तरीका। यह प्रदान किए गए language wrappers में से किसी एक का उपयोग करके लिखा गया application हो सकता है, या ऐसा application जो सीधे Glasswall library के साथ interact करता हो।
  • Content management policy settings जिन्हें CDR processing behaviour बदलने के लिए लागू किया जा सकता है। उदाहरण configs directory में मिल सकते हैं।

स्थापना​

Environment variables​

Editor को Glasswall camera libraries खोजने के लिए निम्न environment variable सेट करना होगा:

QT_PLUGIN_PATH=...: जहाँ ... उस directory का पूरा path है जिसमें Editor और Editor camera libraries मौजूद हैं।

यदि supported होने के बावजूद कोई documents process नहीं हो रहे हैं, तो दोबारा जाँच लें कि यह environment variable सही तरीके से सेट किया गया है।

Linux में Environment variables​

export QT_PLUGIN_PATH=... चलाकर एक temporary environment variable बनाया जा सकता है। इससे environment variable बन जाएगा, लेकिन केवल current shell और उसके child processes के लिए। Shell बंद होने के बाद यह variable उपलब्ध नहीं रहेगा।

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 में environment variables​

आपकी Docker file में ENV QT_PLUGIN_PATH=... जोड़कर एक स्थायी environment variable बनाया जा सकता है।

Windows में environment variables​

set QT_PLUGIN_PATH=... चलाकर एक अस्थायी environment variable बनाया जा सकता है। इससे environment variable बन जाएगा, लेकिन केवल वर्तमान shell और उसकी child processes के लिए। shell बंद होने के बाद यह variable उपलब्ध नहीं रहेगा।

setx QT_PLUGIN_PATH=... चलाकर एक स्थायी environment variable बनाया जा सकता है। नया shell instance बनने पर यह environment variable बन जाएगा। यह पंक्ति जोड़ने के बाद आप वर्तमान shell के लिए इस variable को उपलब्ध कराने हेतु set QT_PLUGIN_PATH=... चला सकते हैं।

चेतावनी: यदि आपका environment variable 1024 characters से अधिक है, तो ऊपर दिए गए commands उसे truncate कर देंगे। इस स्थिति में environment variable बनाने के लिए आपको कोई अन्य तरीका, जैसे graphical interface का उपयोग, करना होगा।

Linux​

Linux पर Glasswall libraries को install करने के कुछ अलग-अलग तरीके हैं। यहाँ हम एक अस्थायी और कुछ स्थायी solutions दिखाते हैं। प्रत्येक उदाहरण में release package को /home/Glasswall में extract किया गया है। आपको अपने environment के अनुसार filepaths को अनुकूलित करना पड़ सकता है।

उदाहरण 1 - अस्थायी समाधान​

एक अस्थायी सेटअप आर्काइव को किसी डायरेक्टरी में एक्सट्रैक्ट करके और फिर environment variable LD_LIBRARY_PATH=... को उन डायरेक्टरीज़ की ओर पॉइंट करने के लिए सेट करके बनाया जा सकता है जहाँ Glasswall लाइब्रेरीज़ स्थित हैं।

  • Run;
    • export QT_PLUGIN_PATH=/home/Glasswall/libs/debian/x86-64/sdk_editor.
    • यह QT_PLUGIN_PATH को Glasswall camera लाइब्रेरीज़ वाली डायरेक्टरी की ओर पॉइंट करने के लिए सेट करेगा।
  • 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 का उपयोग कर रहे हैं, तो आपको LD_LIBRARY_PATH में Java wrapper डायरेक्टरीज़ के paths भी जोड़ने होंगे।

उदाहरण 2 - /usr/lib में इंस्टॉलेशन​

एक स्थायी सेटअप सभी लाइब्रेरीज़ को /usr/lib/ या linker द्वारा खोजी जाने वाली किसी अन्य डायरेक्टरी में कॉपी करके, और फिर इंस्टॉल की गई लाइब्रेरीज़ की सूची अपडेट करने के लिए 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 डायरेक्टरी में कॉपी करेगा और permissions को 755 पर सेट करेगा। यदि आप Java का उपयोग कर रहे हैं, तो आपको Java wrapper लाइब्रेरीज़ के लिए भी यही करना होगा।
  • Run with admin privileges;
    • ldconfig
    • यह इंस्टॉल की गई लाइब्रेरीज़ की सूची अपडेट करेगा ताकि Glasswall लाइब्रेरीज़ मिल सकें।
  • Run;
    • echo 'QT_PLUGIN_PATH=/usr/lib/' > ~/.bashrc
    • यह Glasswall लाइब्रेरीज़ के स्थान की ओर पॉइंट करने के लिए QT_PLUGIN_PATH environment variable को स्थायी रूप से जोड़ देगा।
  • Run;
    • source ~/.bashrc
    • यह वर्तमान shell को QT_PLUGIN_PATH environment variable शामिल करने के लिए अपडेट करेगा।

उदाहरण 3 - /opt/glasswall में इंस्टॉलेशन​

निकाले गए archive की सामग्री को /opt/glasswall जैसी किसी जगह पर कॉपी करके, और /etc/ld.so.d/ में एक config file बनाकर जो सिस्टम को बताए कि Glasswall libraries कहाँ मिलेंगी, एक अन्य स्थायी setup बनाया जा सकता है।

  • Run with admin privileges;
    • mkdir -p /opt/glasswall
    • यह उस directory को बनाएगा जहाँ release package की सामग्री संग्रहीत की जाएगी।
  • Run with admin privileges;
    • cp -r /home/Glasswall/* /opt/glasswall/
    • यह release package की निकाली गई सामग्री को /opt/glasswall/ directory में कॉपी करेगा।
  • Run with admin privileges;
    • find /opt/glasswall/ -name "*.so*" -exec chmod 755 "{}" \;
    • यह सभी Glasswall libraries को ढूँढेगा और उनकी permissions को 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
    • यह /etc/ld.so.conf.d/glasswall.conf configuration file बनाएगा, जिसमें Glasswall libraries के स्थानों के paths होंगे। यदि आप Java का उपयोग कर रहे हैं, तो आपको Java wrapper libraries के paths भी 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 environment variable को स्थायी रूप से जोड़ देगा।
  • Run;
    • source ~/.bashrc
    • यह वर्तमान shell instance को अपडेट करेगा ताकि उसमें QT_PLUGIN_PATH environment variable शामिल हो।

Windows​

Windows के लिए setup, Linux के setup से बहुत मिलता-जुलता है, जहाँ आपको Glasswall libraries को संग्रहीत करने के लिए एक स्थान चुनना होता है, और फिर environment variables सेट करने होते हैं ताकि Glasswall libraries मिल सकें। हमारे उदाहरण में हम release archive की सामग्री को C:\Program Files\Glasswall में संग्रहीत कर रहे हैं।

  • Release archive की सामग्री को C:\Program Files\Glasswall में extract करें
  • 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 वाले उपयुक्त paths को PATH environment variable में जोड़ें।
  • 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 packages भी install करने होंगे। OpenSSL का Chocolatey installation अनुशंसित है, जो Visual C++ Redistributable भी install करेगा।

  • Chocolatey install करने के निर्देश यहाँ मिल सकते हैं।
  • Chocolatey install हो जाने के बाद, administrative permissions के साथ command prompt या Windows Power Shell खोलें।
  • choco install openssl command टाइप करें और installation पूरा करने के लिए निर्देशों का पालन करें।
  • पूरा होने के बाद, updated environment variables लागू करने के लिए किसी भी applications या console sessions को restart करें।
अंतिम बार अपडेट किया गया को