ความช่วยเหลือ Tableau Server บน Windows

กระบวนการและบริการที่สร้างเป็นส่วนประกอบของ Tableau Services Manager (TSM) และ Tableau Server ใน Windows ใช้หลายพอร์ตเพื่อสื่อสาร ตามค่าเริ่มต้นนั้น พอร์ตเหล่านี้จะถูกกำหนด (แมป) แบบไดนามิกจากช่วงพอร์ตที่กำหนดไว้ล่วงหน้า การกำหนดพอร์ตเกิดขึ้นสำหรับบริการหรือกระบวนการแต่ละรายการหลังติดตั้งแล้ว คุณสามารถควบคุมว่าจะใช้พอร์ตใดได้หลากหลายรูปแบบ

มีกระบวนการรองจำนวนหนึ่งที่ไม่ใช้พอร์ตแบบไดนามิกในการแมป และทำงานแตกต่างออกไป หากต้องการข้อมูลเพิ่มเติม โปรดดู พอร์ตที่ไม่ได้แมปแบบไดนามิก ด้านล่าง

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

ความต้องการของไฟร์วอลล์

หากคุณใช้งานไฟร์วอลล์บนคอมพิวเตอร์ที่คุณจะติดตั้ง Tableau Server คุณจะต้องเปิดพอร์ตเริ่มต้นต่อไปนี้สำหรับปริมาณการใช้งาน Tableau Server จำนวนพอร์ตทั้งหมดยกเว้น 443 สามารถเปลี่ยนแปลงได้

การกำหนดพอร์ต

มีสองแนวทางที่คุณใช้ได้เพื่อกำหนดหรือแมปพอร์ตใน TSM

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

หากคุณเปลี่ยนการกำหนดพอร์ตและกำลังใช้งานไฟร์วอลล์ภายในอยู่ โปรดดู การกำหนดค่าไฟร์วอลล์ในเครื่อง

การกำหนดพอร์ตแบบไดนามิก

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

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

tsm topology list-ports

หากคุณมีคลัสเตอร์แบบหลายโหนด จะมีรายชื่อพอร์ตในทุกโหนดแสดงขึ้นมา

"configKeys": {
    "ports.range.min": "8300",
    "ports.range.max": "8600"
}

tsm configuration set -k ports.blocklist -v <port>[,<port>,<port>]

tsm configuration set -k ports.blocklist -v 8000,8088, 8090

การปิดใช้งานการกำหนดพอร์ตแบบไดนามิก

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

หากคุณปิดใช้งานการแมปพอร์ตแบบไดนามิก คุณต้องกำหนดค่าพอร์ตสำหรับแต่ละกระบวนการในแต่ละโหนดของการติดตั้ง

หากต้องการปิดใช้งานการแมปแบบไดนามิก ไฟล์การกำหนดค่าของคุณควรมีเอนทรีที่คล้ายกับเอนทรีต่อไปนี้

"configKeys": {
    "service.port_remapping.enabled": false
}

สำคัญ: เมื่อคุณปิดใช้งานการกำหนดค่าพอร์ตแบบไดนามิก ช่วงพอร์ตของบริการใบอนุญาตจะไม่รวมอยู่ด้วย ช่วงนี้ (27000-27009) ต้องเปิดบนโหนดที่ใช้บริการใบอนุญาต และเข้าถึงได้จากโหนดอื่นๆ ตามค่าเริ่มต้น โหนดเริ่มต้นจะเรียกใช้บริการใบอนุญาต

การกำหนดพอร์ตด้วยตนเอง

คุณสามารถปิดการกำหนดพอร์ตโดยอัตโนมัติทั้งหมดได้ และสามารถกำหนดพอร์ตให้แต่ละกระบวนการทีละรายการได้ หากคุณทำตามนี้ คุณต้องกำหนดพอร์ตให้ทุกกระบวนการในทุกโหนด คุณสามารถกำหนดพอร์ตได้ในไฟล์การกำหนดค่าเมื่อติดตั้งกระบวนการต่างๆ เป็นครั้งแรก หรือทำหลังจากการติดตั้งโดยใช้คำสั่ง TSM ก็ได้ เฉพาะพอร์ตที่กำหนดในการติดตั้งกระบวนการจะถูกเก็บรักษาไว้หากคุณส่งออกการตั้งค่า Tableau Server

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

การกำหนดค่าพอร์ตระหว่างการติดตั้ง

เราแนะนำให้กำหนดค่าการกำหนดพอร์ตในระหว่างกระบวนการติดตั้งตามวิธีที่อธิบายในที่นี้ การเปลี่ยนพอร์ตหลังจากการติดตั้งนั้นเป็นขั้นตอนที่มีความยุ่งยากกว่ามาก

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

หากต้องการระบุพอร์ตในขั้นตอนการติดตั้ง ให้เพิ่มข้อมูลลงในไฟล์การกำหนดค่าเพื่อระบุโหนด (workerN), กระบวนการ (servicename) และ ID อินสแตนซ์ (instanceid), ประเภทพอร์ต (porttype) และพอร์ตที่จะใช้ รูปแบบจะเป็นดังต่อไปนี้

workerN.{servicename}_{instanceid}.{porttype}.port:X

โดยที่

• workerN  เป็นพารามิเตอร์ทางเลือก และระบุโหนดที่มีการใช้การแมปใหม่ หมายเลขโหนดจะเริ่มจากศูนย์ (0)
  เราแนะนำให้คุณไม่กำหนดพารามิเตอร์นี้ เว้นแต่คุณจำเป็นต้องแมปพอร์ตที่แตกต่างไปสำหรับบริการเดียวกันในโหนดอื่น หากคุณปิดพารามิเตอร์นี้ คุณสามารถแมปพอร์ตบริการในโหนดเริ่มต้นได้ หรือแมปพอร์ตบริการเดียวกันในหลายโหนดได้
• servicename คือชื่อกระบวนการหรือบริการที่จะใช้พอร์ต
• instanceid คืออินสแตนซ์ของกระบวนการ หากคุณต้องกำหนดค่าอินสแตนซ์หลายรายการของกระบวนการบนโหนดหนึ่งโหนด คุณควรเพิ่มค่านี้สำหรับแต่ละอินสแตนซ์ เริ่ม ID อินสแตนซ์จากศูนย์ (0) แล้วเพิ่มทีละหนึ่ง (1) สำหรับแต่ละอินสแตนซ์ของกระบวนการนั้น สำหรับบริการที่ติดตั้งเพียงอินสแตนซ์เดียวในโหนดใดก็ตาม ให้ปิดตัวเลือกนี้ด้วย
• porttype หากตั้งค่าพอร์ตหลัก อย่ากำหนดตัวเลือกนี้
• port คือพอร์ตที่กระบวนการหรือบริการควรใช้

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

"configKeys": {
    "filestore_0.port: "8500"
}

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

สำคัญ: เมื่อกำหนดการเปลี่ยนพอร์ตโดยใช้ไฟล์การกำหนดค่า คุณต้องใส่พารามิเตอร์ --force-keys ด้วยคำสั่ง นำเข้าการตั้งค่า TSM

การกำหนดค่าพอร์ตหลังการติดตั้ง

หากคุณจำเป็นต้องเปลี่ยนพอร์ตหลังจากที่ติดตั้ง Tableau Server ให้ใช้คำสั่ง tsm topology set-ports วิธีนี้ทำให้คุณสามารถกำหนดพอร์ตสำหรับกระบวนการใดกระบวนการหนึ่งได้หลังจากที่ติดตั้งกระบวนการนั้นแล้ว โดยมีข้อจำกัดดังต่อไปนี้

• คุณต้องตั้งค่าพอร์ตทีละรายการ ในแต่ละโหนด
• หลังจากที่คุณตั้งค่าแต่ละพอร์ตแล้ว คุณจะต้องเรียกใช้ tsm restart
• การกำหนดพอร์ตจะไม่ถูกเก็บรักษาไว้หากคุณจำเป็นต้องส่งออกการกำหนดค่า Tableau Server โดยใช้ tsm settings import
• ชื่อพอร์ตจะใช้ไวยากรณ์ที่แตกต่างไปสำหรับคำสั่ง TSM เมื่อเทียบกับไวยากรณ์ที่จำเป็นสำหรับ configKeys ตารางท้ายหัวข้อนี้ให้ข้อมูลอ้างอิงเรื่องไวยากรณ์

ตัวอย่างเช่น หากต้องการตั้งค่าอินสแตนซ์ที่สองของการจัดเก็บไฟล์ในโหนดเริ่มต้นให้ใช้พอร์ต 8500

tsm topology set-ports --node-name node1 --port-name filestore --port-value 8500 --instance 2

ตัวอย่างต่อไปนี้แสดงถึงวิธีใช้คำสั่งแบบย่อ เพื่อตั้งค่าพอร์ต JMX

tsm topology set-ports -n node1 --port-name vizqlserver:jmx.rmi -pv 9403 -i 1

tsm topology set-ports -n node1 --port-name vizqlserver:jmx -pv 9404 -i 2

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

หากคุณเพิ่ม portname:type ที่ไม่ถูกต้องกับพอร์ตที่ถูกต้อง คุณจะไม่สามารถลบรายการที่ไม่ถูกต้องได้ หากต้องการอัปเดตพอร์ต คุณต้องกำหนดพอร์ตที่ไม่ได้ใช้ใหม่เป็นค่านั้นเพื่อให้พอร์ตว่างอีกครั้ง

พอร์ตที่ไม่ได้แมปแบบไดนามิก

ที่เก็บของ Tableau Server ใช้พอร์ตสองพอร์ตที่ไม่ได้แมปแบบไดนามิก โดยแต่ละพอร์ตจะมีพอร์ตเริ่มต้นที่คุณสามารถเขียนทับได้ด้วยคำสั่ง tsm configuration set และพารามิเตอร์เฉพาะกระบวนการ

เนื่องจากพอร์ตเหล่านี้ไม่ได้ใช้ระบบการแมปพอร์ตแบบไดนามิก จึงไม่ได้แสดงขึ้นในเอาต์พุตของคำสั่ง tsm topology list-ports หากต้องการดูค่าของพอร์ตเหล่านี้ คุณต้องใช้คำสั่ง tsm configuration get -k <config.value> ตัวอย่าง:

tsm configuration get -k pgsql.port

พอร์ตที่แมปแบบไดนามิก

ตารางนี้แสดงรายการกระบวนการหรือบริการที่ใช้พอร์ตที่แมปแบบไดนามิก

บทความอื่นๆ ในส่วนนี้