ติดตั้งเอเจนต์ด้วยการใช้บรรทัดคำสั่ง

เอเจนต์เป็นกระบวนการขนาดเล็กที่ใช้ทรัพยากรเซิร์ฟเวอร์เพียงเล็กน้อย และส่งข้อมูลไปยังเซิร์ฟเวอร์ Resource Monitoring Tool (เซิร์ฟเวอร์ RMT) ติดตั้งเอเจนต์ Resource Monitoring Tool ในโหนด Tableau Server แต่ละโหนดของคุณ วิธีการติดตั้งและลงทะเบียนเอเจนต์ ให้ดาวน์โหลดไฟล์การกำหนดค่า Bootstrap ของเอเจนต์ แล้วบันทึกไว้ในตำแหน่งที่เข้าถึงได้จากโหนดเอเจนต์ Resource Monitoring Tool

หัวข้อนี้อธิบายขั้นตอนที่คุณสามารถใช้เพื่อติดตั้งเอเจนต์ Resource Monitoring Tool ด้วยการใช้บรรทัดคำสั่ง การติดตั้งบรรทัดคำสั่งรองรับในทั้งระบบปฏิบัติการ Windows และ Linux

เพื่อความสอดคล้องกับค่านิยมความเท่าเทียมของบริษัทของเรา เราได้เปลี่ยนการใช้คำศัพท์ที่ไม่แบ่งแยกเท่าที่เป็นไปได้ เนื่องจากการเปลี่ยนแปลงคำศัพท์บางคำในตำแหน่งต่าง ๆ อาจก่อให้เกิดการเปลี่ยนแปลงอย่างชัดเจน เราจึงใช้คำศัพท์เดิม ดังนั้นคุณจึงอาจเห็นคำศัพท์เหล่านั้นในคำสั่งและตัวเลือก CLI, โฟลเดอร์การติดตั้ง, ไฟล์การกำหนดค่า และอินสแตนซ์อื่น ๆ ต่อไป หากต้องการข้อมูลเพิ่มเติม โปรดดู เกี่ยวกับความช่วยเหลือของ Tableau(ลิงก์จะเปิดในหน้าต่างใหม่)

ก่อนติดตั้ง

  • ดาวน์โหลดไฟล์บูตสแตรปและบันทึกไว้ในตำแหน่งที่โหนดที่คุณจะติดตั้ง RMT Agent สามารถเข้าถึงได้ ไฟล์ Bootstrap มีอายุเพียง 24 ชั่วโมงหลังจากการดาวน์โหลด คุณจะต้องสร้างไฟล์ Bootstrap ใหม่อีกครั้งหากไฟล์ที่คุณจะใช้มีอายุเกิน 24 ชั่วโมง
  • ตั้งแต่เวอร์ชัน 2021.3 เป็นต้นไป การลงทะเบียนเอเจนต์จะต้องสื่อสารผ่านทั้งปลายทาง https และ RabbitMQ เพื่อลงทะเบียนเอเจนต์ให้เสร็จสิ้น ตรวจสอบว่าพอร์ต 443 และ 5672 เปิดอยู่ทั้งคู่สำหรับการสื่อสารเหล่านี้

วิธีการติดตั้งและกำหนดค่าเอเจนต์:

  1. ดาวน์โหลดไฟล์ Bootstrap ไปยังตำแหน่งที่เข้าถึงได้จากโหนด Tableau Server

    rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>

  2. เรียกใช้โปรแกรมติดตั้งเอเจนต์:
    1. ดาวน์โหลดตัวติดตั้งเอเจนต์แล้วบันทึกไว้ในตำแหน่งที่คุณสามารถเข้าถึงได้จากเครื่อง Tableau Server

    2. เปิดข้อความแจ้งคำสั่งในฐานะผู้ดูแลระบบ
    3. ไปยังตำแหน่งของตัวติดตั้งเอเจนต์แล้วเรียกใช้ไฟล์ exe ด้วยการใช้คำสั่งต่อไปนี้

      Tabrmt-Agent-64bit-<version>.exe /silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password>

      ตั้งแต่รุ่น 2021.4 เป็นต้นไป คุณจะต้องระบุบัญชีผู้ใช้ที่จะ "เรียกใช้งานในฐานะผู้ใช้" สำหรับเอเจนต์ บัญชีนี้ใช้สำหรับเข้าถึง Tableau Serve เพื่อรวบรวมข้อมูลการตรวจสอบ

      สำหรับบัญชี “เรียกใช้งานในฐานะผู้ใช้” ให้ระบุบัญชีเดียวกันกับที่คุณใช้ในปัจจุบันเป็นบัญชีผู้ใช้ Tableau Server หากข้อมูลบัญชีที่คุณให้ไว้ไม่ตรงกับใน Tableau Server เอเจนต์จะไม่สามารถรวบรวมข้อมูลการตรวจในโหนดดังกล่าวได้

      • ใช้ RUN_AS_NETWORK_SERVICE=1 หาก Tableau Server ของคุณกำหนดค่าให้ใช้บัญชีบริการเครือข่ายเป็นบัญชี “เรียกใช้งานในฐานะผู้ใช้”
      • ใช้ RUN_AS_USER_CUSTOM=1 หาก Tableau Server ของคุณกำหนดค่าให้ใช้ผู้ใช้แบบกำหนดเอง ใช้ข้อมูลเข้าสู่ระบบบัญชีเดียวกันกับที่ระบุสำหรับ Tableau Server

      โฟลเดอร์การติดตั้งที่เป็นค่าเริ่มต้นมักเป็นดังนี้ : C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent หากต้องการระบุตำแหน่งการติดตั้งที่แตกต่างออกไป ให้เรียกใช้คำสั่งดังนี้:

      Tabrmt-Agent-64bit-<version>.exe/silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password> InstallFolder="D:\Tableau Resource Monitoring Tool\agent"

      หมายเหตุ: ใช้สวิตช์ /silent หรือ /quiet เพื่อเรียกใช้การตั้งค่าโดยไม่ต้องควบคุมเอง และโดยไม่ต้องแสดง UI หรือข้อความแจ้งใด ๆ

  3. ลงทะเบียนเอเจนต์:
    1. เรียกใช้คำสั่งต่อไปนี้เพื่อลงทะเบียนเอเจนต์:

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username <name of the RMT admin user> --password <password for the user account>

      รายการตารางต่อไปนี้เป็นตัวเลือกการกำหนดค่าที่ใช้สำหรับการลงทะเบียนเอเจนต์:

      ตัวเลือกจำเป็นหรือไม่

      ค่าเริ่มต้น

      คำอธิบาย
      --bootstrap fileใช่<none>ตำแหน่งของไฟล์ Bootstrap
      --usernameใช่<none>ปกติแล้วหมายถึงผู้ใช้ที่เป็นผู้ดูแลระบบที่คุณสร้างในระหว่างการติดตั้งเซิร์ฟเวอร์ RMT
      --passwordใช่<none>รหัสผ่านสำหรับบัญชีผู้ใช้
      --password-file

      ไม่

      สามารถระบุรหัสผ่านในบรรทัดคำสั่งหรือไฟล์ที่มีรหัสผ่าน หากไม่มีทั้งคู่ ระบบจะแจ้งให้คุณกรอกรหัสผ่าน

      <none>เส้นทางจะระบุชื่อไฟล์ที่เก็บรหัสผ่านไว้
      --server-nameไม่ชื่อโฮสต์ของเครื่องชื่อคอมพิวเตอร์ที่ติดตั้งเอเจนต์ไว้ หากไม่ได้ระบุตัวเลือกใด ฟิลด์นี้จะป้อนค่าเริ่มต้นเป็นชื่อโฮสต์ของเครื่อง
      --server-descriptionไม่<none>คำอธิบายของคอมพิวเตอร์ที่ติดตั้งเอเจนต์ไว้ หากไม่ได้ระบุตัวเลือกใด ฟิลด์นี้จะเว้นว่างไว้

      สวิตช์และพร็อพเพอร์ตี้การติดตั้งของ Windows

      สวิตช์:

      สลับคำอธิบายความคิดเห็น
      /passiveเรียกใช้การติดตั้งด้วย UI น้อยที่สุดและไม่ต้องมีข้อความแจ้งเลย 
      /quiet | /silentเรียกใช้การติดตั้งแบบไม่ต้องควบคุมเอง อยู่ในโหมดเงียบอย่างสมบูรณ์ ไม่มีการแสดงอินเทอร์เฟซเว็บหรือข้อความแจ้งให้ใช้ /quiet หรือ /silent อย่างใดอย่างหนึ่ง ห้ามใช้ทั้งสองอย่างร่วมกัน

      พร็อพเพอร์ตี้:

      พร็อพเพอร์ตี้คำอธิบายความคิดเห็น
      InstallFolder=<path\to\installation\directory>ติดตั้งไปยังตำแหน่งการติดตั้งที่ไม่ใช่ค่าเริ่มต้นที่ระบุไว้

      ระบุตำแหน่งที่จะติดตั้ง RMT หากไม่ได้ใช้งาน RMT จะติดตั้งไปยัง C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master

      ตัวอย่าง: <Setup file> /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"

      ACCEPTEULA=1|0ยอมรับข้อตกลงสิทธิ์การใช้งานของผู้ใช้ (EULA) จำเป็นสำหรับการติดตั้งแบบไร้เสียง เงียบ และพาสซีฟในทั้งโหนดตั้งต้นและโหนดเพิ่มเติม 1 = true หมายถึงยอมรับ EULA, 0 = false หมายถึงไม่ยอมรับ EULAหากไม่ได้รวมไว้ขณะใช้ /passive, /silent หรือ /quiet การติดตั้งจะล้มเหลวโดยไม่ส่งเสียง หากรวมไว้แต่กำหนดไว้เป็น 0 การติดตั้งจะล้มเหลว

       

วิธีการติดตั้งและกำหนดค่าเอเจนต์:

  1. ติดตั้ง:
    1. ดาวน์โหลดตัวติดตั้งเอเจนต์ .rpm หรือ .deb และบันทึกไว้ในตำแหน่งที่คุณสามารถเข้าถึงได้จากเครื่องที่คุณวางแผนจะติดตั้งเอเจนต์

    2. เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งเอเจนต์เมื่อกำหนดรูปแบบ <version> ให้เป็น major-minor-maintenance:

      สำหรับการกระจายแบบ RHEL รวมถึง CentOS:

      sudo yum install Tabrmt-Agent-x86_64-<version>.rpm

      สำหรับ Ubuntu:

      sudo apt install Tabrmt-Agent-amd64-<version>.deb

  2. เริ่มต้น RMT Agent:

    คุณต้องยอมรับข้อตกลงสิทธิ์การใช้งานของผู้ใช้ (EULA) อย่างชัดเจนเมื่อคุณเริ่มต้น RMT Agent คุณยังมีตัวเลือกในการระบุการกำหนดค่าที่ไม่ใช่ค่าเริ่มต้น หากต้องการเริ่มต้น RMT Agent ด้วยการกำหนดค่าเริ่มต้น ให้เรียกใช้คำสั่งนี้:

    sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula

    คุณจะพบ EULA ในโฟลเดอร์ /opt/tableau/tabrmt/agent/docs

    ตั้งแต่เวอร์ชัน 2023.1 คุณสามารถระบุบัญชี Run As แบบกำหนดเองที่จะใช้โดย RMT รวมถึงตัวเลือกการกำหนดค่าอื่นๆ โดยค่าเริ่มต้น RMT จะสร้างและใช้บัญชีที่เรียกว่า rmt-agent เพื่อเรียกใช้ หากต้องการระบุบัญชี Run As แบบกำหนดเองที่จะใช้โดย RMT Agent ให้รวมตัวเลือก --unprivileged-user เมื่อคุณเรียกใช้สคริปต์การเริ่มต้น หากต้องการข้อมูลเกี่ยวกับสวิตช์ที่มีอยู่ทั้งหมดสำหรับสคริปต์ initialize-rmt-agent โปรดดูตัวเลือกสคริปต์การเริ่มต้น RMT Agent

  3. ลงทะเบียน:
    1. ออกจากระบบและเข้าสู่ระบบเป็นผู้ใช้ tabrmt-agent เพื่อให้คุณสามารถเรียกใช้คำสั่ง rtmadmin ที่กำหนดให้คุณเรียกใช้งานในฐานะผู้ใช้ tabrmt-agent เสมอ และเมื่อคุณเข้าสู่ระบบอีกครั้ง คุณจะสร้างเซสชันใหม่ที่การเปลี่ยนแปลงการเป็นสมาชิกกลุ่มจะมีผลกระทบ

      sudo su --login tabrmt-agent

    2. เรียกใช้คำสั่งต่อไปนี้และระบุเส้นทางของไฟล์ Bootstrap ระบุชื่อที่เข้าใจง่ายและคำอธิบายของโหนดที่ติดตั้งเอเจนต์อยู่

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --agent-description=<server description> --username=<name of the RMT admin user>

      ระบบจะแสดงข้อความแจ้งให้กรอกรหัสผ่านของผู้ใช้ที่เป็นผู้ดูแล RMT

      หมายเหตุ: ผู้ใช้ tabrmt-agent กำหนดค่าเริ่มต้นให้เรียกใช้คำสั่งจากไดเรกทอรีการทำงานพื้นฐาน: /var/opt/tableau/tabrmt/agent คุณจึงต้องระบุเส้นทางไฟล์เต็มรูปแบบที่สอดคล้องกัน ตัวอย่างเช่น หากคุณเก็บไฟล์ Bootstrap ไว้ในโฟลเดอร์ /var/opt/tableau/tabrmt/agent/bootstrap/ ตามที่แนะนำไว้ เส้นทางไฟล์จะเป็น /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.json

      รายการตารางต่อไปนี้เป็นตัวเลือกการกำหนดค่าที่ใช้สำหรับการลงทะเบียนเอเจนต์:

      ตัวเลือกจำเป็นหรือไม่ค่าเริ่มต้นคำอธิบาย
      --bootstrap fileใช่<none>ตำแหน่งของไฟล์ Bootstrap
      --usernameใช่<none>ปกติแล้วหมายถึงผู้ใช้ที่เป็นผู้ดูแลระบบที่คุณสร้างในระหว่างการติดตั้งเซิร์ฟเวอร์ RMT
      --passwordใช่<none>รหัสผ่านสำหรับบัญชีผู้ใช้
       

      ไม่

      สามารถระบุรหัสผ่านในบรรทัดคำสั่งหรือไฟล์ที่มีรหัสผ่าน หากไม่มีทั้งคู่ ระบบจะแจ้งให้คุณกรอกรหัสผ่าน

      <none>เส้นทางจะระบุชื่อไฟล์ที่เก็บรหัสผ่านไว้
      --server-nameไม่ชื่อโฮสต์ของเครื่องชื่อคอมพิวเตอร์ที่ติดตั้งเอเจนต์ไว้ หากไม่ได้ระบุตัวเลือกใด ฟิลด์นี้จะป้อนค่าเริ่มต้นเป็นชื่อโฮสต์ของเครื่อง
      --server-descriptionไม่<none>คำอธิบายของคอมพิวเตอร์ที่ติดตั้งเอเจนต์ไว้ หากไม่ได้ระบุตัวเลือกใด ฟิลด์นี้จะเว้นว่างไว้

การติดตั้งเอเจนต์ใน Tableau Server แบบหลายโหนด

เรียกใช้ขั้นตอนตามที่อธิบายไว้ข้างต้นในแต่ละโหนดของ Tableau Server ในอินเทอร์เฟซเว็บของ RMT Server คุณควรจะเห็นโหนดทั้งหมดที่ติดตั้งเอเจนต์

ใครสามารถดำเนินการนี้ได้บ้าง

ในการติดตั้ง Resource Monitoring Tool คุณจะต้องมีทุกสิ่งต่อไปนี้

Windows:

  • สิทธิ์ของผู้ดูแลในเครื่องที่คุณกำลังติดตั้ง Resource Monitoring Tool
  • บทบาทในไซต์เป็นผู้ดูแลระบบ Tableau Server

Linux:

  • การเข้าถึงเทียมแบบเต็มของบัญชีผู้ใช้ที่ใช้ติดตั้งเอเจนต์

ขั้นตอนถัดไป

กำหนดค่า Resource Monitoring Tool ของ Tableau

ขอบคุณสำหรับข้อเสนอแนะของคุณส่งข้อเสนอแนะของคุณเรียบร้อยแล้ว ขอขอบคุณ