ติดตั้ง อัปเดต และถอน Agent

#ใช้ทำอะไร

Agent คือโปรแกรมเล็กๆ ที่ต้องเปิดทำงานอยู่ตลอดบนเครื่องคอมพิวเตอร์ในออฟฟิศ หน้าที่ของมันคือรับเวลาสแกนจากเครื่องสแกนแล้วส่งเข้าระบบ ยกตัวอย่างร้านที่มีพีซีเครื่องเก่าวางไว้ในห้องบัญชี ฝ่ายไอทีติดตั้ง Agent บนพีซีเครื่องนั้นครั้งเดียว หลังจากนั้นมันเปิดมาพร้อมเครื่องและทำงานเองเงียบๆ

หน้าติดตั้งไม่ได้แยกเป็นหน้าต่างหาก คำสั่งติดตั้ง อัปเดต และถอนอยู่ในหน้า ตั้งค่าอุปกรณ์ › การเชื่อมต่อ ใต้แถบ ตั้งค่า ติดตั้ง และบำรุงรักษา Agent ขั้นตอนบนเครื่องต้องใช้สิทธิ์ผู้ดูแลเครื่อง เลยแนะนำให้ฝ่ายไอทีหรือคนที่ดูแลคอมพิวเตอร์ของออฟฟิศเป็นคนทำ

#ก่อนเริ่ม

• ต้องบันทึกการตั้งค่า Agent ก่อน ถ้ายังไม่เคยบันทึก ช่องคำสั่งจะเขียนบอกให้บันทึก Agent ก่อน ไม่มีคำสั่งให้คัดลอก ดูขั้นตอนบันทึกที่ เชื่อมต่อเครื่องสแกนกับระบบ
• ต้องเป็นเจ้าขององค์กรหรือผู้ดูแลองค์กร คนอื่นไม่เห็นคำสั่งติดตั้ง (ช่องเขียนให้บันทึก Agent ก่อน เหมือนยังไม่เคยตั้ง) และกดอัปเดตหรือลบ Agent ไม่ได้
• เครื่องที่จะติดตั้ง ต้องเปิดทิ้งไว้ตลอด ต่ออินเทอร์เน็ตได้ และเครื่องสแกนต้องต่อเข้ามาหาเครื่องนี้ได้ สคริปต์ตรวจก่อนว่าเครื่องนี้เข้าถึงระบบได้ไหม ถ้าไม่ได้จะหยุดและบอก
• ถ้าเป็น Linux ต้องมี bash curl systemctl (systemd) และ file รันด้วยสิทธิ์ root และเป็นเครื่อง 64 บิต (แบบ x86 หรือ ARM)
• ถ้าเป็น Windows ต้องมี Windows PowerShell 5.1 ขึ้นไป และเปิดแบบ Run as administrator เป็นเครื่อง 64 บิต (แบบ x86 หรือ ARM)
• ถ้าใช้โหมด ADMS พอร์ตที่ตั้งไว้ (ปกติ 8081) ต้องไม่มีโปรแกรมอื่นใช้อยู่บนเครื่องนั้น

#ขั้นตอน

#ติดตั้งบน Linux

1. เปิดหน้า ตั้งค่าอุปกรณ์ › การเชื่อมต่อ เลื่อนลงไปกดแถบ ตั้งค่า ติดตั้ง และบำรุงรักษา Agent ให้เปิดออก แล้วเลื่อนไปที่การ์ด คำสั่งติดตั้ง

2. หัวข้อ Linux (systemd) บอกว่ารองรับเครื่อง Linux ที่มี bash และ systemd กดปุ่ม คัดลอก ข้างหัวข้อ จะขึ้นข้อความ คัดลอกคำสั่งติดตั้งแล้ว คำสั่งหน้าตาเป็นบรรทัดเดียว ขึ้นต้นด้วย curl ลงท้ายด้วย | bash

3. บนเครื่องที่จะติดตั้ง เปิดเทอร์มินัลด้วยสิทธิ์ root วางคำสั่งนั้นแล้วกด Enter ถ้าไม่ได้รันด้วย root สคริปต์จะหยุดและบอกให้ใช้ sudo

4. สคริปต์ทำงานทีละขั้น และพิมพ์ผลเป็น [OK] หรือ [FAIL] ขั้นที่ทำมีดังนี้

   • เช็กว่ามีเครื่องมือที่ต้องใช้ครบ
   • ลองต่อเข้าระบบ
   • ดาวน์โหลด Agent รุ่นล่าสุดจากระบบเอง แล้วเช็กว่าไฟล์เป็นโปรแกรมจริง
   • เขียนไฟล์ตั้งค่า ตั้งให้อ่านได้เฉพาะ root
   • สร้าง service ที่เริ่มเองทุกครั้งที่เปิดเครื่อง และล้มแล้วเริ่มใหม่เอง แล้วเริ่มทำงานทันที ถ้ามี service เดิมอยู่ จะหยุดก่อนแล้วติดตั้งทับ

5. ตอนท้าย สคริปต์พิมพ์ตำแหน่งไฟล์โปรแกรม ไฟล์ตั้งค่า ชื่อ service และคำสั่งดูสถานะกับดู log ให้ จดไว้ให้ฝ่ายไอที

6. กลับมาที่หน้าเว็บ รอสักครู่ ส่วน สถานะ Agent ควรเปลี่ยนเป็น Agent ออนไลน์ ถ้ายังเป็นออฟไลน์ กด ตรวจใหม่

#ติดตั้งบน Windows

7. ในการ์ด คำสั่งติดตั้ง เลื่อนไปที่หัวข้อ Windows (PowerShell) ใต้หัวข้อเขียนว่า ติดตั้งเป็น Windows Service และบอกให้เปิด PowerShell แบบ Run as administrator ถ้าอยู่ในโหมด ADMS จะมีข้อความต่อท้ายว่า เปิดพอร์ต 8081 ใน Windows Firewall ให้อัตโนมัติ กด คัดลอก ข้างหัวข้อ คัดลอกมาทั้งบรรทัด คำสั่งเริ่มด้วยการตั้ง TLS 1.2 แล้วตามด้วย irm … | iex ส่วนต้นที่ตั้ง TLS ไว้เพราะ Windows PowerShell รุ่นเก่าบางรุ่นดาวน์โหลดสคริปต์ไม่ได้ถ้าไม่ตั้ง

8. บนเครื่อง Windows กดปุ่ม Start พิมพ์ PowerShell คลิกขวาที่ Windows PowerShell แล้วเลือก Run as administrator วางคำสั่งแล้วกด Enter ถ้าไม่ได้เปิดแบบ administrator สคริปต์จะหยุดและบอกว่า ต้องรันด้วยสิทธิ์ Administrator

9. สคริปต์ทำงานทีละขั้น ขั้นที่ทำมีดังนี้

   • เช็กว่ารันเป็น administrator และ PowerShell รุ่นพอ
   • ลองต่อเข้าระบบ
   • ถ้าเป็นโหมด ADMS เช็กว่าพอร์ตว่าง ถ้ามีโปรแกรมอื่นใช้อยู่ สคริปต์หยุดและบอกชื่อโปรแกรมนั้น ให้กลับไปเปลี่ยน ADMS Port ในหน้าเว็บ บันทึกใหม่ แล้วคัดลอกคำสั่งใหม่
   • ถ้ามี service เดิมอยู่ จะหยุดและลบก่อน
   • ดาวน์โหลด Agent รุ่นล่าสุด และเช็กว่าไฟล์เป็นโปรแกรม Windows จริง
   • เขียนไฟล์ตั้งค่า ตั้งให้อ่านได้เฉพาะระบบกับผู้ดูแลเครื่อง
   • ถ้าเป็นโหมด ADMS เปิดพอร์ตใน Windows Firewall ให้ เฉพาะโปรแกรม Agent และทุกประเภทเครือข่าย (ถ้าเครือข่ายออฟฟิศถูกจัดเป็นสาธารณะก็ใช้ได้)
   • สร้าง Windows Service ให้เริ่มเองอัตโนมัติ และเริ่มใหม่เองห้าวินาทีถ้าล้ม แล้วเริ่มทำงานทันที

10. ถ้าเป็นโหมด ADMS ตอนท้าย สคริปต์พิมพ์ข้อความ Point the scanner here ตามด้วยที่อยู่ IP ของเครื่องกับเลขพอร์ต นี่คือค่าที่ต้องไปใส่ในเครื่องสแกน (เมนู COMM › Cloud Server Settings) จดไว้ แล้วทำต่อที่ เชื่อมต่อเครื่องสแกนกับระบบ

11. กลับมาที่หน้าเว็บ ดูว่า สถานะ Agent เป็น Agent ออนไลน์

#ติดตั้งซ้ำหรือเปลี่ยนค่า

12. รันคำสั่งติดตั้งซ้ำบนเครื่องเดิมได้ สคริปต์หยุด service เดิม เขียนไฟล์ตั้งค่าใหม่ แล้วเริ่มใหม่ ถ้าเปลี่ยนโหมดหรือพอร์ตในหน้าเว็บ ให้บันทึกก่อน แล้วรันคำสั่งติดตั้งซ้ำ ไฟล์ตั้งค่าบนเครื่องจะได้ตรงกับหน้าเว็บ ถ้าเปลี่ยนพอร์ต อย่าลืมแก้ที่อยู่บนเครื่องสแกนให้ตรงด้วย

#อัปเดต Agent

13. เปิดแถบ ตั้งค่า ติดตั้ง และบำรุงรักษา Agent ดูที่การ์ด ข้อมูลเครื่องปลายทาง ส่วนหัวของการ์ดบอกเวอร์ชันปัจจุบัน ถ้า Agent ออนไลน์และระบบอ่านเวอร์ชันได้ จะมีแถบสถานะใต้หัว

• Agent เป็นเวอร์ชันล่าสุด (แถบสีเขียว) ไม่ต้องทำอะไร
• มีเวอร์ชันใหม่ (แถบสีเหลือง) ตามด้วย เวอร์ชันปัจจุบัน: … → ล่าสุด: … และปุ่ม อัปเดต

14. กด อัปเดต Agent โหลดตัวใหม่จากระบบแล้วรีสตาร์ทเอง ขึ้นข้อความ อัปเดต Agent สำเร็จ — กำลังรีสตาร์ท ระหว่างนั้น Agent หลุดจากระบบช่วงสั้นๆ รอสักครู่ หน้าจะโหลดสถานะใหม่เอง ถ้าไม่สำเร็จ จะขึ้น อัปเดตล้มเหลว ตามด้วยสาเหตุ หรือ อัปเดต Agent ไม่สำเร็จ ถ้าติดต่อ Agent ไม่ได้ตอนกด

15. อยากดูรายละเอียดของเครื่องที่ Agent ทำงานอยู่ กดหัวการ์ด ข้อมูลเครื่องปลายทาง จะกางออก เห็นชื่อเครื่อง ระบบปฏิบัติการ จำนวน CPU หน่วยความจำ เวอร์ชัน Agent เวลาที่เริ่มทำงาน สถานะ service และตำแหน่งไฟล์ ข้อมูลนี้ไว้ให้ฝ่ายไอทีดู ถ้า Agent ออฟไลน์จะขึ้นว่าดึงข้อมูลเครื่องไม่ได้

#ถอนการติดตั้ง Agent

มีสองทาง ทางแรกสั่งจากหน้าเว็บ ทางที่สองรันคำสั่งบนเครื่องเอง

16. ทางที่หนึ่ง สั่งจากหน้าเว็บ ในการ์ด การตั้งค่าการเชื่อมต่อ กดปุ่มสีแดง ลบ Agent (ปุ่มนี้ขึ้นเฉพาะบริษัทที่มีการตั้งค่า Agent แล้ว) กล่อง ถอนการติดตั้ง Agent ถามยืนยัน กด ถอนการติดตั้ง ผลขึ้นอยู่กับว่า Agent ออนไลน์อยู่หรือเปล่า

17. ปุ่ม ลบ Agent ถอนโปรแกรมออกจากเครื่อง แต่เก็บการตั้งค่าการเชื่อมต่อในหน้าเว็บไว้ ใช้ติดตั้งใหม่ได้ เวลาสแกนที่เข้าระบบแล้วไม่หาย ส่วนประวัติออนไลน์/ออฟไลน์ของ Agent ที่ขึ้นในหน้า ดู Logs เมื่อเครื่องสแกนมีปัญหา จะถูกล้าง ถ้าถอนตอน Agent ออนไลน์ รหัสในคำสั่งติดตั้งจะเปลี่ยนเป็นรหัสใหม่ คำสั่งติดตั้งเก่าใช้ไม่ได้อีก ให้ใช้คำสั่งที่หน้าจอแสดงอยู่ตอนนี้

18. ทางที่สอง รันคำสั่งเอง เลื่อนไปที่การ์ดสีแดง คำสั่งถอนการติดตั้ง มีสองช่อง Linux (systemd) ลบ Agent, service และไฟล์ตั้งค่าทั้งหมด Windows (PowerShell) หยุดและลบ Windows Service พร้อมไฟล์ทั้งหมด ต้องรันแบบ Run as administrator เหมือนตอนติดตั้ง กด คัดลอก แล้ววางบนเครื่องที่ติดตั้ง Agent ไว้ สคริปต์ถอนบน Windows ลบกฎ Firewall ที่ติดตั้งสร้างไว้ให้ด้วย ถ้าถอนด้วยวิธีนี้ หน้าเว็บจะรู้ว่า Agent หลุด (ออฟไลน์) แต่ไม่ได้เปลี่ยนการตั้งค่าอะไร

#ข้อควรรู้

• คำสั่งติดตั้งมีรหัสลับของบริษัท ลิงก์ในคำสั่งมีรหัสของ Agent บริษัทคุณ ใครมีคำสั่งนี้ก็ดาวน์โหลดสคริปต์ที่มีค่าเชื่อมต่อทั้งหมดได้ รวมถึงชื่อผู้ใช้และรหัสผ่านของ ZKBio หรือ ZKBioTime ถ้าตั้งไว้ ส่งให้เฉพาะคนที่ติดตั้งให้ และอย่าโพสต์ในกลุ่มแชตที่มีคนนอก ถ้าสงสัยว่ารั่ว ให้ถอนการติดตั้งตอน Agent ออนไลน์ รหัสจะถูกเปลี่ยนให้ แล้วติดตั้งใหม่ด้วยคำสั่งใหม่ที่หน้าจอแสดง
• หนึ่งบริษัทมี Agent ได้หนึ่งตัว ถ้าจะย้ายไปเครื่องอื่น ให้ถอนเครื่องเก่าก่อน แล้วติดตั้งบนเครื่องใหม่ด้วยคำสั่งที่หน้าจอแสดงอยู่
• Agent ต้องออนไลน์ถึงอัปเดตได้ ถ้า Agent ออฟไลน์ ระบบอ่านเวอร์ชันไม่ได้ แถบเวอร์ชันกับปุ่ม อัปเดต เลยไม่ขึ้น
• ไฟล์โปรแกรมโหลดจากระบบเอง สคริปต์ติดตั้งและตัว Agent ตอนอัปเดต ดาวน์โหลดโปรแกรมผ่านระบบนี้ ไม่ได้ไปโหลดจากเว็บอื่น เครื่องที่ติดตั้งเลยต้องออกไปหาระบบได้ ถ้าที่ออฟฟิศมี proxy หรือ Firewall ที่บล็อกการออกเน็ต ให้ฝ่ายไอทีเปิดให้
• ระบบปฏิบัติการที่รองรับ คำสั่งติดตั้งมีให้เฉพาะ Linux และ Windows ถ้ารันสคริปต์ของ Linux บนระบบอื่น สคริปต์จะหยุดและบอกว่ารองรับแค่ Linux ที่มี systemd

#คำถามที่พบบ่อย

สคริปต์ขึ้น Cannot reach … แล้วหยุด เครื่องที่ติดตั้งต่อเข้าระบบไม่ได้ ข้อความบอกให้เช็ก DNS, proxy และ Firewall ให้ฝ่ายไอทีเช็กว่าเครื่องนี้เปิดเว็บของระบบจากเบราว์เซอร์ได้ไหม

สคริปต์บน Windows ขึ้นว่าพอร์ตมีโปรแกรมอื่นใช้อยู่ โหมด ADMS ต้องใช้พอร์ตที่ตั้งไว้ ถ้ามีโปรแกรมอื่นจองอยู่ สคริปต์หยุดและบอกชื่อโปรแกรม ไปเปลี่ยน ADMS Port ในหน้า การเชื่อมต่อ แล้วกด บันทึกการตั้งค่า จากนั้นคัดลอกคำสั่งใหม่มารัน และแก้ที่อยู่บนเครื่องสแกนให้ตรงกับพอร์ตใหม่

ติดตั้งสำเร็จ แต่หน้าเว็บยังเป็น Agent ออฟไลน์ รอสักครู่แล้วกด ตรวจใหม่ ถ้ายังไม่ขึ้น ให้เช็กว่า service ทำงานอยู่ ด้วยคำสั่งดูสถานะที่สคริปต์พิมพ์ไว้ตอนท้าย และเปิดหน้า ดู Logs เมื่อเครื่องสแกนมีปัญหา ดูว่ามีแถวที่ Agent ต่อเข้าระบบไหม

ติดตั้งสำเร็จ Agent ออนไลน์ แต่เครื่องสแกนไม่ขึ้นในตาราง เครื่องสแกนยังต่อเข้ามาหาเครื่อง Agent ไม่ได้ เช็กที่อยู่ IP กับพอร์ตที่ตั้งบนเครื่องสแกน และเช็กว่า Firewall ของเครื่อง Agent ไม่ได้บล็อกพอร์ตนั้น ดูต่อที่ เชื่อมต่อเครื่องสแกนกับระบบ

ไม่เห็นคำสั่งติดตั้ง มีแต่ข้อความให้บันทึก Agent ก่อน ยังไม่เคยกด บันทึกการตั้งค่า หรือคุณไม่ได้เป็นเจ้าขององค์กรหรือผู้ดูแลองค์กร ให้คนที่เป็นสองระดับนี้ทำแทน