การติดตั้ง

ชุดแจกจ่ายของ Glasswall ประกอบด้วยไลบรารีทั้งหมด ตัวห่อหุ้ม เครื่องมือ ไฟล์ config และไฟล์ทดสอบที่จำเป็นสำหรับการเริ่มต้นใช้งานภายในไฟล์เก็บถาวรเดียว คุณจะต้องแตกไฟล์เก็บถาวรและรวมอาร์ติแฟกต์ที่เกี่ยวข้องไว้ในโปรเจกต์ของคุณ โครงสร้างไดเรกทอรีที่ใช้ในตัวอย่างด้านล่างถูกต้องสำหรับเวอร์ชัน 16.4.0 เป็นต้นไป สำหรับเวอร์ชันก่อนหน้าของเอนจิน คุณจะต้องปรับพาธระบบไฟล์ที่แสดงไว้

ไลบรารีของ Glasswall ถูกแยกตามระบบปฏิบัติการและสถาปัตยกรรมที่รองรับดังนี้:

• /libs/debian/x86-64 - ไลบรารีระบบปฏิบัติการ Linux x86-64
• /libs/debian/arm64 - ไลบรารีระบบปฏิบัติการ Linux arm64
• /libs/windows/x86-64 - ไลบรารีระบบปฏิบัติการ Windows x86-64

สามารถพบ wrapper เฉพาะภาษาต่าง ๆ ได้ใน /libs/OS/ARCHITECTURE/sdk_editor_wrappers และ /libs/OS/ARCHITECTURE/sdk_word_search_wrappers โดยสิ่งเหล่านี้ช่วยให้ผู้ใช้สามารถใช้ภาษาโปรแกรมได้หลากหลายมากขึ้นสำหรับแอปพลิเคชันของตนเองที่ใช้เอนจินของ Glasswall โดยมี wrapper สำหรับ:

• Java (8, 11 และ 18)
• .NET (8 หรือสูงกว่า)
• Python (3.6 หรือสูงกว่า)

ข้อกำหนดทั่วไป​

ข้อกำหนดทั่วไปมีดังนี้:

• ไลบรารีของ Glasswall: glasswall_core2.dll สำหรับระบบปฏิบัติการ Windows และ libglasswall_core2.so สำหรับ Linux ไลบรารีเหล่านี้ประกอบด้วยเอนจินของ Glasswall
• ไลบรารีกล้องของ Glasswall: *_camera.dll สำหรับระบบปฏิบัติการ Windows และ *_camera.so สำหรับ Linux และ Alpine OS ไลบรารีเหล่านี้ถูกใช้โดยเอนจินของ Glasswall เพื่อประมวลผลประเภทไฟล์เฉพาะ
• policy การจัดการเนื้อหาที่ปรับเปลี่ยนพฤติกรรมการประมวลผล สามารถดูตัวอย่างได้ใน /configs
• วิธีการหนึ่งในการเรียกใช้เอนจินของ Glasswall ซึ่งอาจเป็นแอปพลิเคชันที่เขียนโดยใช้ language wrapper ที่มีให้ หรือเป็นแอปพลิเคชันที่โต้ตอบกับไลบรารีของ Glasswall โดยตรง
• การตั้งค่า policy การจัดการเนื้อหาที่สามารถนำไปใช้เพื่อเปลี่ยนแปลงพฤติกรรมการประมวลผล CDR สามารถดูตัวอย่างได้ในไดเรกทอรี configs

การติดตั้ง​

ตัวแปรสภาพแวดล้อม​

ต้องตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้เพื่อให้ Editor สามารถค้นหาไลบรารีกล้องของ Glasswall ได้:

QT_PLUGIN_PATH=...: โดยที่ ... คือพาธแบบเต็มไปยังไดเรกทอรีที่มีไลบรารีของ Editor และกล้องของ Editor

หากคุณพบปัญหาที่ไม่มีเอกสารถูกประมวลผล แม้ว่าเอกสารเหล่านั้นจะรองรับก็ตาม ให้ตรวจสอบอีกครั้งว่าตั้งค่าตัวแปรสภาพแวดล้อมนี้ไว้อย่างถูกต้อง

ตัวแปรสภาพแวดล้อมใน Linux​

สามารถสร้างตัวแปรสภาพแวดล้อมแบบชั่วคราวได้โดยรัน export QT_PLUGIN_PATH=... การดำเนินการนี้จะสร้างตัวแปรสภาพแวดล้อม แต่จะมีผลเฉพาะกับ shell ปัจจุบันและโปรเซสลูกของมันเท่านั้น เมื่อปิด shell แล้ว ตัวแปรนี้จะไม่พร้อมใช้งานอีกต่อไป

สามารถสร้างตัวแปรสภาพแวดล้อมแบบถาวรได้โดยเพิ่ม export QT_PLUGIN_PATH=... ลงในไฟล์ ~/.bashrc วิธีนี้จะทำให้มีการตั้งค่าตัวแปรสภาพแวดล้อมทุกครั้งที่มีการสร้างอินสแตนซ์ของ shell หลังจากเพิ่มบรรทัดนี้แล้ว คุณสามารถเรียกใช้ source ~/.bashrc เพื่อให้ตัวแปรนี้มีผลกับ shell ปัจจุบันได้

ตัวแปรสภาพแวดล้อมใน Docker​

สามารถสร้างตัวแปรสภาพแวดล้อมแบบถาวรได้โดยเพิ่ม ENV QT_PLUGIN_PATH=... ลงในไฟล์ Docker ของคุณ

ตัวแปรสภาพแวดล้อมใน Windows​

สามารถสร้างตัวแปรสภาพแวดล้อมแบบชั่วคราวได้โดยรัน set QT_PLUGIN_PATH=... การดำเนินการนี้จะสร้างตัวแปรสภาพแวดล้อม แต่จะมีผลเฉพาะกับ shell ปัจจุบันและโปรเซสลูกของมันเท่านั้น เมื่อปิด shell แล้ว ตัวแปรนี้จะไม่พร้อมใช้งานอีกต่อไป

สามารถสร้างตัวแปรสภาพแวดล้อมแบบถาวรได้โดยรัน setx QT_PLUGIN_PATH=... การดำเนินการนี้จะสร้างตัวแปรสภาพแวดล้อมเมื่อมีการสร้างอินสแตนซ์ shell ใหม่ หลังจากเพิ่มบรรทัดนี้แล้ว คุณสามารถรัน set QT_PLUGIN_PATH=... เพื่อให้ตัวแปรนี้มีผลกับ shell ปัจจุบันได้

คำเตือน: คำสั่งข้างต้นจะตัดทอนตัวแปรสภาพแวดล้อมของคุณหากมีความยาวเกิน 1024 อักขระ ในกรณีนี้ คุณจะต้องใช้วิธีอื่น เช่น ใช้อินเทอร์เฟซแบบกราฟิก เพื่อสร้างตัวแปรสภาพแวดล้อม

Linux​

บน Linux มีหลายวิธีในการติดตั้งไลบรารีของ Glasswall ที่นี่เราจะแสดงวิธีแบบชั่วคราวและแบบถาวรบางวิธี สำหรับแต่ละตัวอย่าง แพ็กเกจรีลีสถูกแตกไฟล์ไว้ที่ /home/Glasswall คุณอาจต้องปรับพาธไฟล์ให้ตรงกับสภาพแวดล้อมของคุณ

ตัวอย่างที่ 1 - วิธีแก้ไขชั่วคราว​

สามารถสร้างการตั้งค่าชั่วคราวได้โดยแตกไฟล์ archive ไปยังไดเรกทอรี จากนั้นตั้งค่าตัวแปรสภาพแวดล้อม 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/ หรือไดเรกทอรีอื่นที่ 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 และตั้งค่าสิทธิ์เป็น 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
  • การดำเนินการนี้จะอัปเดต shell ปัจจุบันให้รวมตัวแปรสภาพแวดล้อม QT_PLUGIN_PATH ไว้

ตัวอย่างที่ 3 - การติดตั้งใน /opt/glasswall​

สามารถสร้างการตั้งค่าแบบถาวรอีกแบบหนึ่งได้โดยคัดลอกเนื้อหาของ archive ที่แตกไฟล์แล้วไปยังตำแหน่ง เช่น /opt/glasswall และสร้างไฟล์ config ใน /etc/ld.so.d/ เพื่อบอกระบบว่าจะค้นหาไลบรารีของ Glasswall ได้จากที่ใด

• Run with admin privileges;
  • mkdir -p /opt/glasswall
  • คำสั่งนี้จะสร้างไดเรกทอรีที่จะใช้จัดเก็บเนื้อหาของ release package
• Run with admin privileges;
  • cp -r /home/Glasswall/* /opt/glasswall/
  • คำสั่งนี้จะคัดลอกเนื้อหาที่แตกไฟล์แล้วของ release package ไปยังไดเรกทอรี /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
  • คำสั่งนี้จะสร้างไฟล์ configuration /etc/ld.so.conf.d/glasswall.conf ซึ่งมี path ไปยังตำแหน่งของไลบรารี Glasswall หากคุณใช้ Java คุณจะต้องเพิ่ม path ไปยังไลบรารี 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
  • คำสั่งนี้จะอัปเดต shell instance ปัจจุบันให้รวมตัวแปรสภาพแวดล้อม QT_PLUGIN_PATH ไว้ด้วย

Windows​

การตั้งค่าสำหรับ Windows มีความคล้ายกับการตั้งค่าสำหรับ Linux มาก โดยคุณต้องหาตำแหน่งสำหรับจัดเก็บไลบรารีของ Glasswall จากนั้นตั้งค่าตัวแปรสภาพแวดล้อมเพื่อให้สามารถค้นหาไลบรารีของ Glasswall ได้ ในตัวอย่างของเรา เราจัดเก็บเนื้อหาของ release archive ไว้ใน C:\Program Files\Glasswall

• แตกไฟล์เนื้อหาของ Release archive ไปยัง 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 ลงในตัวแปรสภาพแวดล้อม 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 ด้วยเช่นกัน โดยแนะนำให้ติดตั้ง OpenSSL ผ่าน Chocolatey ซึ่งจะติดตั้ง Visual C++ Redistributable ให้ด้วย

• คำแนะนำในการติดตั้ง Chocolatey สามารถดูได้ที่นี่
• เมื่อติดตั้ง Chocolatey แล้ว ให้เปิด command prompt หรือ Windows Power Shell ด้วยสิทธิ์ผู้ดูแลระบบ
• พิมพ์คำสั่ง choco install openssl และทำตามคำแนะนำเพื่อให้การติดตั้งเสร็จสมบูรณ์
• เมื่อเสร็จสิ้นแล้ว ให้รีสตาร์ตแอปพลิเคชันหรือเซสชันคอนโซลทั้งหมดเพื่อใช้ตัวแปรสภาพแวดล้อมที่อัปเดตแล้ว