ข้อมูลอ้างอิงบรรทัดคำสั่ง tsm
หัวข้อในส่วนนี้มีเนื้อหาอ้างอิงสำหรับอินเทอร์เฟซบรรทัดคำสั่ง (CLI) Tableau Services Manager (TSM) เพื่อสนับสนุน Tableau Server
โดยจะใช้ TSM เพื่อจัดการการติดตั้งและการกำหนดค่า Tableau Server หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับ TSM โปรดดูภาพรวมของ Tableau Services Manager
คุณสามารถเปลี่ยนงานติดตั้งและกำหนดค่าที่ TSM CLI รองรับให้เป็นระบบอัตโนมัติได้โดยใช้ TSM API หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับ TSM API ที่ยังไม่เปิดตัว (อัลฟ่า) โปรดดู Tableau Services Manager API
หากต้องการใช้คำสั่ง tsm สำหรับ Tableau Server บน Windows โปรดดูคำสั่ง tsm(ลิงก์จะเปิดในหน้าต่างใหม่)
การใช้ tsm CLI
คุณสามารถเรียกใช้คำสั่ง tsm บนโหนดเริ่มต้น (โหนดที่ติดตั้ง TSM) หรือบนโหนดเพิ่มเติมในคลัสเตอร์
หากต้องการเรียกใช้คำสั่ง tsm คุณต้องเปิดข้อความแจ้งคำสั่ง
เปิดข้อความแจ้งคำสั่งโดยใช้บัญชีที่เป็นสมาชิกของกลุ่ม
tsmadminบนโหนดในคลัสเตอร์เรียกใช้คำสั่งที่ต้องการ หากคุณกำลังเรียกใช้คำสั่งจากโหนดที่ไม่ใช่โหนดเริ่มต้น ให้ใส่ตัวเลือก
-sเพื่อระบุ URL ของโหนดเริ่มต้นด้วยชื่อ (ไม่ใช่ที่อยู่ IP) และระบุพอร์ต TSM 8850หากต้องการดูเวอร์ชันของ TSM และ Tableau Server จากโหนดเริ่มต้น:
tsm versionหากต้องการดูเวอร์ชันของ TSM และ Tableau Server จากโหนดเพิ่มเติม:
tsm version -s https://<inital_node_name>:8850ตัวอย่าง:
tsm version -s https://myTableauHost:8850
การตรวจสอบสิทธิ์ด้วย tsm CLI
ตั้งแต่รุ่น 2019.2 ของ Tableau Server การเรียกใช้คำสั่ง tsm จะไม่กำหนดให้คุณต้องป้อนรหัสผ่านหากสิ่งต่อไปนี้เป็นจริง:
- บัญชีที่คุณกำลังเรียกใช้คำสั่งเป็นสมาชิกของกลุ่มที่ TSM ให้สิทธิ์ ซึ่งโดยค่าเริ่มต้นแล้วจะเป็นกลุ่ม
tsmadminผู้ใช้ที่ไม่ได้รับสิทธิ์จาก Tableau (โดยค่าเริ่มต้นแล้วจะเป็นผู้ใช้tableau) และบัญชีรากก็จะสามารถเรียกใช้คำสั่ง TSM ได้ด้วย - คุณกำลังเรียกใช้คำสั่งในเครื่องของ Tableau Server ที่บริการตัวควบคุมการดูแลระบบ Tableau Server ทำงานอยู่ โดยค่าเริ่มต้นแล้ว บริการตัวควบคุมการดูแลระบบ Tableau Server จะติดตั้งและกำหนดค่าไว้ในโหนดตั้งต้นในการปรับใช้แบบกระจาย
การเข้าสู่ระบบ tsm CLI ในเครื่อง
หากคุณกำลังเรียกใช้คำสั่ง tsm บนเครื่องคอมพิวเตอร์ที่มีบัญชีผู้ใช้ซึ่งเป็นสมาชิกกลุ่มที่ TSM ให้สิทธิ์ คุณจะไม่ต้องระบุรหัสผ่าน ตัวอย่างเช่น ในกรณีนี้ ให้เรียกใช้คำสั่งเท่านั้น:
tsm version
การเข้าสู่ระบบ tsm CLI จากระยะไกล
หากคุณกำลังเรียกใช้คำสั่ง TSM จากโหนดในคลัสเตอร์ที่บริการตัวควบคุมการดูแลระบบ Tableau Server ไม่ได้ทำงานอยู่ คุณจะต้องตรวจสอบสิทธิ์เซสชั่นด้วยบริการตัวควบคุมการดูแลระบบ Tableau Server บนคอมพิวเตอร์ทางไกลก่อนที่จะเรียกใช้คำสั่งได้ ตัวอย่างเช่น ให้เรียกใช้คำสั่งดังต่อไปนี้:
tsm login -s <server_name> -u <account_name>
โดยให้ <server_name> เป็นชื่อของโหนดที่บริการตัวควบคุมการดูแลระบบ Tableau Server ทำงานอยู่ และ <account_name> เป็นบัญชีที่เป็นสมาชิกของกลุ่มที่ TSM ให้สิทธิ์
หลังจากเรียกใช้คำสั่งนี้ ระบบจะแจ้งให้คุณกรอกรหัสผ่าน หลังจากตรวจสอบสิทธิ์บัญชีแล้ว คุณจะสามารถเรียกใช้คำสั่ง TSM ได้
ตามแนวทางปฏิบัติที่ดีที่สุดด้านความปลอดภัย อย่าเปิดเผยพอร์ต TSM (โดยค่าเริ่มต้น 8850) ในอินเตอร์เน็ต
การดูและการเพิ่มบัญชีไปยังกลุ่มที่ TSM ให้สิทธิ์
กลุ่มที่ TSM ให้สิทธิ์จะสร้างขึ้นระหว่างการติดตั้งเซิร์ฟเวอร์ ตามค่าเริ่มต้นแล้วจะเป็นกลุ่มที่ TSM ให้สิทธิ์ที่ชื่อ tsmadmin หากคุณสร้างตัวเลือกกลุ่มที่ TSM ให้สิทธิ์ในระหว่างการติดตั้ง ให้แทนที่ชื่อกลุ่มด้วย tsmadmin ในตัวอย่างโค้ดต่อไปนี้
หากต้องการดูบัญชีผู้ใช้ในกลุ่ม tsmadmin ให้เรียกใช้คำสั่งต่อไปนี้:
grep tsmadmin /etc/group
หากต้องการเพิ่มบัญชีผู้ใช้ไปยังกลุ่ม tsmadmin:
sudo usermod -G tsmadmin -a <username>
การสร้างสคริปต์และการใช้ระบบอัตโนมัติด้วย tsm CLI
วิธีการเรียกใช้งานระบบอัตโนมัติบน Tableau Server โดยไม่ต้องใช้รหัสผ่านในไฟล์สคริปต์ ให้เรียกใช้สคริปต์ในโหนดตั้งต้นและด้วยบัญชีจากกลุ่มที่ TSM ให้สิทธิ์ที่ถูกต้อง โปรดดูข้อมูลเพิ่มเติมในส่วน “การตรวจสอบสิทธิ์” ที่ด้านบน
การดูเนื้อหาความช่วยเหลือในเชลล์
หากต้องการดูเนื้อหาความช่วยเหลือสั้นๆ จากบรรทัดคำสั่ง ให้ใช้หมวดหมู่ tsm help
สรุป
tsm help [category] [command]
คำสั่ง
tsm helpความช่วยเหลือสำหรับคำสั่ง tsm ทั้งหมด
tsm help <category>แสดงความช่วยเหลือสำหรับหมวดหมู่คำสั่งเฉพาะ ตัวอย่างเช่น
tsm help authenticationtsm help <category> <command>แสดงความช่วยเหลือสำหรับคำสั่งเฉพาะ ตัวอย่างเช่น
tsm help authentication open-idtsm help commandsแสดงรายการคำสั่งหรือหมวดหมู่ระดับบนสุดทั้งหมด