การแก้ไขข้อผิดพลาดหลังจากอัปเกรด

ส่วนต่อไปนี้จะแสดงรายละเอียดของปัญหาที่มักระบุโดยการตรวจสอบหลังการอัปเกรด หรือสังเกตได้ทันทีหลังการอัปเกรด

หากต้องการข้อมูลเกี่ยวกับการตรวจสอบก่อนการอัปเกรดและหลังการอัปเกรด โปรดดูส่วนการอ้างอิงการอัปเกรด

บริการไม่ทํางาน

ไม่สามารถเข้าถึงอินเทอร์เฟซผู้ใช้เว็บ RMT ได้ และคําสั่ง rmtadmin status ระบุว่าบริการที่จําเป็นหยุดทํางานแล้ว

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #1, #2, #16

หากต้องการแก้ไขปัญหานี้ ให้ใช้ขั้นตอนต่อไปนี้

สำหรับ Linux ให้ใช้คำสั่งดังต่อไปนี้:

sudo -u tabrmt-master XDG_RUNTIME_DIR=/run/user/$(id -u tabrmt-master) systemctl --user start tabrmt-master

สำหรับ Windows ให้ใช้คำสั่งดังต่อไปนี้:

Start-Service TableauResourceMonitoringTool

ตรวจสอบบันทึกการบริการในไดเรกทอรีบันทึกเพื่อดูข้อผิดพลาดในการเริ่มต้น

PostgreSQL ไม่ยอมรับการเชื่อมต่อ

เมื่อ Web UI แสดงข้อผิดพลาดของฐานข้อมูลและข้อมูลไม่ได้ถูกจัดเก็บ

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #5c, #6

หากต้องการแก้ไขปัญหานี้ ให้ตรวจสอบสิ่งต่อไปนี้

• ตรวจสอบว่าบริการ PostgreSQL กําลังทํางานอยู่หรือไม่

• ตรวจสอบบันทึก PostgreSQL ในไดเรกทอรีข้อมูลเพื่อหาข้อผิดพลาดในการเริ่มต้น

• ตรวจสอบให้แน่ใจว่าพอร์ตฐานข้อมูล (ค่าเริ่มต้น 5555) ไม่ได้โดนกระบวนการอื่นบล็อกอยู่

RabbitMQ ไม่ตอบสนอง

เมื่อเอเจนต์แสดงว่าตัดการเชื่อมต่อแล้วและไม่มีข้อมูลการตรวจสอบใหม่ปรากฏขึ้น

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #5b, #7, #9

หากต้องการแก้ไขปัญหานี้ ให้ตรวจสอบสิ่งต่อไปนี้

• RabbitMQ อาจใช้เวลา 30-60 วินาทีในการเริ่มต้นอย่างสมบูรณ์หลังจากอัปเกรด — รอและตรวจสอบอีกครั้ง

• ตรวจสอบว่ากระบวนการ Erlang/beam กําลังทํางานอยู่

• ตรวจสอบการแจ้งเตือนทรัพยากร RabbitMQ (พื้นที่ดิสก์บล็อกการเผยแพร่ข้อความ < 10 GB)

• ตรวจสอบว่ามีไฟล์คุกกี้ Erlang และมีสิทธิ์ที่ถูกต้อง

รายการตกค้างคิวข้อความ

ข้อมูลแสดงล่าช้าใน UI ของเว็บ RMT และแดชบอร์ดแสดงเมตริกเก่า

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #8

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

• ตรวจสอบด้วย “rmtadmin status” — รายการตกค้างควรเคลียร์ไปภายใน 15-30 นาที

• หากรายการตกค้างยังคงอยู่ ให้ตรวจสอบว่าบริการเอเจนต์ทั้งหมดทํางานและเชื่อมต่ออยู่หรือไม่

ตัวดำเนินการเซิร์ฟเวอร์ RMT ไม่ได้ทำการประมวลผลข้อมูล (ข้อมูลไม่ได้นําเข้าหลังจากอัปเกรด)

รายงานบริการ RMT ทั้งหมด ทํางาน การตรวจสอบหลังการอัปเกรดจะส่งผ่านบริการ/พอร์ต/การเชื่อมต่อ แต่ UI เว็บไม่แสดงข้อมูลใหม่ และเอเจนต์แสดงเป็น “ปัญหาการเชื่อมต่อ” “rmtadmin status” แสดงคิวอย่างน้อยหนึ่งคิวที่มีข้อความสะสมแต่มีจํานวนผู้ใช้บริการ **0**

โดยเหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ปฏิบัติงานเบื้องหลังของเซิร์ฟเวอร์ RMT เริ่มทํางานแต่ไม่สามารถผูกช่องทาง RabbitMQ สําหรับผู้บริโภคอีกครั้งได้หลังจากการอัปเกรดที่มีมาแทน เอเจนต์เผยแพร่สําเร็จ ข้อความกองพะเนินเทินทึกใน RabbitMQ และไม่มีอะไรมาอยู่ในฐานข้อมูล

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #8a

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• รีสตาร์ทมาสเตอร์: `rmtadmin restart”

• รอประมาณ 60 วินาที จากนั้นเรียกใช้คำสั่ง “rmtadmin status”— อีกครั้ง คิวที่ค้างอยู่ควรแสดงเป็น “ผู้บริโภค = 1” และรายการตกค้างควรระบายออกภายในไม่กี่นาที

• หากคิวยังคงแสดง “ผู้บริโภค = 0” หลังจากรีสตาร์ท ให้ตรวจสอบบันทึกเบื้องหลังเพื่อหาข้อยกเว้นที่มีผลผูกพันผู้บริโภค:

• Windows: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\background\*.log`

• Linux: `/var/opt/tableau/tabrmt/master/logs/background/*.log`

• ค้นหาบันทึก`exception`, `channel`หรือ `binding failed`

โหมด FIPS ไม่ตรงกัน

เมื่อบริการไม่สามารถเริ่มต้นจากข้อผิดพลาดของการเข้ารหัสหรือ TLS

ตรวจพบโดยการตรวจสอบหลังการอัพเกรด #11

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• ตรวจสอบให้แน่ใจว่าการตั้งค่า FIPS ระดับ OS ตรงกับการกําหนดค่า RMT (“isFIPSEnabled” ใน setup.json)

• Linux: ตรวจสอบ `/proc/sys/crypto/fips_enabled`

• Windows: ตรวจสอบ `HKLM:\SYSTEM\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy\Enabled`

ความเสียหายไฟล์การกำหนดค่า

บริการไม่สามารถเริ่มต้นด้วยข้อผิดพลาดในการแยกวิเคราะห์ JSON

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #3

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• ตรวจสอบไฟล์การกำหนดค่า: `python3 -c "import json; json.load(open('config.json'))"`

• กู้คืนจากการสํารองข้อมูลก่อนการอัปเกรด (แนะนําให้ใช้ก่อนการอัปเกรดทุกครั้ง)

ใบรับรอง SSL หมดอายุหรือกำลังจะหมดอายุ

เมื่อเว็บเบราว์เซอร์แสดงคําเตือนใบรับรองและเอเจนต์ไม่สามารถเชื่อมต่อกับข้อผิดพลาด TLS ได้

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #10, #13

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• ต่ออายุใบรับรอง HTTPS และอัปเดตโดยใช้ `rmtadmin set-ssl-certificate`

• สําหรับใบรับรอง RabbitMQ ให้แทนที่ไฟล์ PEM ในไดเรกทอรีใบรับรองและเริ่มบริการใหม่

พื้นที่ดิสก์เต็ม

เมื่อบริการหยุดทํางานหรือไม่สามารถเขียนข้อมูลและข้อผิดพลาดของฐานข้อมูลในบันทึก

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #14, การตรวจสอบก่อนอัปเกรด #2, #2b

หากต้องการแก้ไขปัญหา ให้ดำเนินการดังต่อไปนี้

• เพิ่มพื้นที่ว่างในดิสก์หรือขยายปริมาณ

• เรียกใช้การล้างฐานข้อมูล: ตรวจสอบให้แน่ใจว่า "db:cleanup:type" ถูกตั้งค่าเป็น “ล้าง” (ไม่ใช่ “ไม่มี”) ใน config.json

• เก็บถาวรหรือลบไฟล์บันทึกเก่า

ข้อผิดพลาด FATAL หรือ CRITICAL ในบันทึก

ลักษณะการทํางานที่ไม่คาดคิดหรือความไม่เสถียรของบริการหลังจากการอัปเกรด

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #15

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• ข้อผิดพลาด “ไม่สามารถเข้าถึงโบรกเกอร์ได้” ทันทีหลังจากอัปเกรดมักจะเกิดขึ้นชั่วคราว ตรวจสอบว่า RabbitMQ กําลังทํางานอยู่หรือไม่

• สําหรับข้อผิดพลาดร้ายแรงอื่นๆ ให้ตรวจสอบรายการบันทึกแบบเต็มและติดต่อฝ่ายสนับสนุนของ Tableau เพื่อแจ้งไฟล์บันทึก

การตัดการเชื่อมต่อเอเจนต์หลังจากอัปเกรดเซิร์ฟเวอร์ RMT

เอเจนต์แสดงว่าถูกตัดการเชื่อมต่อใน UI เว็บของ RMT ไม่มีข้อมูลการตรวจสอบจากโหนด Tableau Server ที่เจาะจง

ตรวจพบโดยการตรวจสอบก่อนการอัปเกรด #36b, #36c #36d

เอเจนต์จะเชื่อมต่ออีกครั้งโดยอัตโนมัติหลังจากการอัปเกรด RMT Server เสร็จสิ้น โปรดรอ 5-10 นาทีเพื่อแก้ไขปัญหานี้ หรือให้ตรวจสอบสิ่งต่อไปนี้

• ตรวจสอบว่าบริการเอเจนต์กําลังทํางานอยู่บนโฮสต์เอเจนต์แต่ละโฮสต์หรือไม่

• หากเอเจนต์ใช้เวอร์ชันเก่ากว่ามาก ให้อัปเกรดให้ตรงกับเวอร์ชันของเซิร์ฟเวอร์ RMT

• ตรวจสอบการเชื่อมต่อเครือข่าย (AMQP พอร์ต 5672) ระหว่างเอเจนต์และโฮสต์เซิร์ฟเวอร์ RMT

การถดถอยของเวอร์ชันที่ไม่ดี

เมื่อฟังก์ชันบางอย่างใช้งานไม่ได้เนื่องจากข้อบกพร่องที่ทราบในเวอร์ชันที่ติดตั้งไว้

ตรวจพบโดย #36a ตรวจสอบก่อนอัปเกรด

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• อัปเกรดเป็นแพตช์รุ่นถัดไป (เช่น จาก 2025.3.0 เป็น 2025.3.1+)

• ติดต่อฝ่ายสนับสนุนของ Tableau สําหรับแพตช์เฉพาะเวอร์ชัน

การล้างข้อมูล Hangfire ล้มเหลว (W-19380780)

ฐานข้อมูลเติบโตอย่างต่อเนื่องและสคีมา hangfire มีขนาดใหญ่ผิดปกติ (>1 GB)

ตรวจพบโดยการตรวจสอบก่อนการอัปเกรด #21d, #21g

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• การอัปเกรดเป็นเวอร์ชันคงที่จะแก้ไขความผันผวนของฟังก์ชัน delete_hash()

• แถวข้อมูลที่ไม่มีเจ้าของในสคีมา Hangfire อาจต้องล้างข้อมูลด้วยตนเอง ติดต่อฝ่ายสนับสนุน Tableau

ปิดใช้งานการล้างฐานข้อมูลแล้ว

ขนาดฐานข้อมูลจะเพิ่มขึ้นเมื่อเวลาผ่านไปโดยไม่มีข้อผูกมัด และการอัปเกรดจะช้า

ตรวจพบโดย #21c ตรวจสอบก่อนอัปเกรด

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• ตั้งค่า db:cleanup:type เป็น Purge ใน config.json

• ลด db:cleanup:afterDays เหลือ 30–90 วัน (ค่าเริ่มต้นคือ 14)

• รีสตาร์ทบริการ RMT Director เพื่อให้การเปลี่ยนแปลงมีผล

ปัญหาเกี่ยวกับสิทธิ์การเข้าถึงไฟล์

บริการล้มเหลวในการเริ่มต้นหรือไม่สามารถอ่านบันทึกการกําหนดค่า / การเขียน

ตรวจพบโดยการตรวจสอบหลังการอัปเกรด #4 การตรวจสอบก่อนการอัปเกรด #11–#16

หากต้องการแก้ไขปัญหานี้ ให้ตรวจสอบสิ่งต่อไปนี้

• Linux: ตรวจสอบความเป็นเจ้าของและการเป็นสมาชิกกลุ่มของไดเรกทอรีการกําหนดค่า บันทึก และข้อมูล

• Windows: ตรวจสอบว่าบัญชีบริการมีสิทธิ์อ่าน/เขียนไดเรกทอรีการติดตั้ง

• โปรดติดต่อฝ่ายสนับสนุนของ Tableau หากปัญหาสิทธิ์ยังคงอยู่หลังจากการติดตั้งใหม่

กระบวนการ RMT ที่ค้างอยู่หลังจากใช้ rmtadmin stop

หลังจากเรียกใช้ rmtadmin stop ตามขั้นตอนการอัปเกรดที่บันทึกไว้แล้ว อาจมีกระบวนการ tabrmt-master-background tabrmt-agent หรือ tabrmt-agent-background อย่างน้อยหนึ่ง tabrmt-master กระบวนการยังคงทํางานอยู่ หากการอัปเกรดดําเนินไปในสถานะนี้ ตัวติดตั้งอาจล้มเหลวระหว่างการทํางานโดยมีข้อผิดพลาดเกี่ยวกับไฟล์ที่ใช้งานอยู่

ตรวจพบโดย #38a ตรวจสอบก่อนอัปเกรด

หากต้องการแก้ไขปัญหานี้ ให้ดำเนินการดังต่อไปนี้

• รอประมาณ 30 วินาทีสําหรับการปิดเครื่องอย่างสง่างาม จากนั้นเรียกใช้การตรวจสอบก่อนการอัปเกรดอีกครั้ง

• หากกระบวนการยังคงอยู่

• Linux: "pkill -u tabrmt-master -f tabrmt-master ; pkill -u tabrmt-agent -f tabrmt-agent" (ข้ามรายการที่ไม่ใช้กับโหนดนี้)

• Windows: "Stop-Process -Name tabrmt-master,tabrmt-master-background,tabrmt-agent,tabrmt-agent-background -Force”

• เรียกใช้การตรวจสอบก่อนการอัปเกรดอีกครั้งเพื่อยืนยันสถานะการล้างก่อนเริ่มการอัปเกรด

เกิดความล้มเหลวที่ผิดพลาดระหว่างการอัปเกรดที่อยู่ร่วมกัน

หาก RMT Master และเอเจนต์ของคุณอยู่ร่วมกันบนเครื่องเดียวกัน การตรวจสอบก่อนการอัปเกรดของเอเจนต์ (โดยเฉพาะการตรวจสอบ #38a) อาจตรวจพบกระบวนการหลักอย่างไม่ถูกต้อง เนื่องจากสคริปต์จะสแกนหากระบวนการ tabrmt-* ทั้งหมดแทนที่จะกรองอย่างเข้มงวดสําหรับ tabrmt-agent-* จึงอาจทําให้เกิดสถานะ FAIL ที่ผิดพลาดได้

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

--skip-upgrade-checks

รายละเอียดทางเทคนิค

สาเหตุที่แท้จริง: ตรวจสอบว่า #38a ตรงกับชื่อกระบวนการที่กว้างเกินไป (tabrmt-*)

ขอบเขต: มีผลกับการอัปเกรดแบบแทนที่ซึ่งมาสเตอร์และเอเจนต์ใช้อินสแตนซ์ระบบปฏิบัติการเดียวกันเท่านั้น

ระดับความเสี่ยง: ต่ํา กระบวนการหลักอยู่นอกขอบเขตสําหรับการอัปเกรดเอเจนต์ ดังนั้นความล้มเหลวไม่ได้บ่งชี้ถึงความขัดแย้งของระบบที่แท้จริง