อัปเกรดเกตเวย์อิสระของ Tableau Server

หัวข้อนี้จะอธิบายกระบวนการของการอัปเกรดเกตเวย์อิสระของ Tableau Server กระบวนการที่อธิบายไว้ในหัวข้อนี้จะเป็นกระบวนการเดียวกันกับการอัปเกรดเวอร์ชันทั้งหมด ซึ่งหมายความว่าคุณสามารถใช้กระบวนการนี้สำหรับการอัปเกรดเวอร์ชันหลัก (เช่น 2022.1 ถึง 2023.1) และเวอร์ชันบำรุงรักษา (2022.1.1 ถึง 2023.1.1) ได้

คุณต้องใช้โปรแกรมติดตั้งสำหรับเกตเวย์อิสระของ Tableau Server ที่มีเวอร์ชันหลักตรงกับเวอร์ชันของ Tableau Server เราขอแนะนำให้เวอร์ชันบำรุงรักษา (เช่น 2022.1.1 or 2022.1.2) ตรงกันด้วย แต่ไม่ได้เป็นข้อบังคับ หาก "ชุดเนื้อหาคงที่" เปลี่ยนแปลงระหว่างเวอร์ชัน และเลขเวอร์ชันไม่ตรงกัน คุณอาจเห็นผลกระทบที่ไม่คาดคิดต่ออิมเมจ ตัวอย่างเช่น แผนที่อาจไม่เป็นข้อมูลปัจจุบันหากเกตเวย์อิสระเป็นเวอร์ชันเก่ากว่า Tableau Server-

ภาพรวม

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

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

ขั้นตอนโดยละเอียดในหัวข้อนี้สรุปไว้ที่นี่:

  1. คัดลอกไฟล์ที่มีอยู่บางส่วนเพื่อใช้ในระหว่างการอัปเกรด
  2. เรียกใช้สคริปต์การลบล้างเพื่อลบเกตเวย์อิสระ
  3. ติดตั้งเวอร์ชันใหม่ของเกตเวย์อิสระ
  4. ไม่บังคับ: เขียนทับไฟล์ tsighk-auth ด้วยสำเนาต้นฉบับ
  5. อัปเดตการตั้งค่า TLS
  6. ไม่บังคับ: อัปเดต Tableau Server แบ็คเอนด์
  7. รีสตาร์ทบริการเกตเวย์อิสระ

ขั้นตอนที่ 1: คัดลอกไฟล์เพื่อใช้อ้างอิง

คุณอาจต้องอ้างอิงการตั้งค่าการกำหนดค่าที่จัดเก็บไว้ในไฟล์ต่อไปนี้ ให้คัดลอกไฟล์เหล่านี้ไปยังตำแหน่งที่ปลอดภัยและเข้าถึงได้ (พาธของไฟล์คือตำแหน่งเริ่มต้น):

  • /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf
  • /var/opt/tableau/tableau_tsig/config/httpd.conf.stub
  • /etc/opt/tableau/tableau_tsig/environment.bash

ขั้นตอนที่ 2: ลบล้างเกตเวย์อิสระ

หากต้องการลบเกตเวย์อิสระออกจากเซิร์ฟเวอร์ ให้เรียกใช้สคริปต์ tableau-tsig-obliterate:

  1. ในโหนดเริ่มต้น ให้เปิดเซสชันเทอร์มินัล

  2. เรียกใช้สคริปต์ tableau-tsig-obliterate :

    sudo /opt/tableau/tableau_tsig/packages/scripts.<version_code>/tableau-tsig-obliterate -y -y -y

  3. รีสตาร์ทคอมพิวเตอร์

ขั้นตอนที่ 3: ติดตั้งเกตเวย์อิสระใน

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

คุณจะต้องระบุการตั้งค่าการเตรียมใช้งานเป็นส่วนหนึ่งของการตั้งค่า เช่นเดียวกับที่ทำกับการติดตั้งแรก หากต้องการใช้ค่าเดียวกัน ให้อ้างอิงไฟล์ enviornment.bash ที่คุณคัดลอกในขั้นตอนที่ 1 อย่าเขียนทับไฟล์ชุดใหม่ด้วยต้นฉบับ

ขั้นตอนที่ 4: (ไม่บังคับ) เขียนทับไฟล์ tsighk-auth ด้วยสำเนาต้นฉบับ

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

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

เพื่อรักษา authsecret ดั้งเดิม ให้เขียนทับไฟล์ tsighk-auth.conf (อยู่ที่ /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf ) ด้วยสำเนาที่คุณบันทึกไว้ในขั้นตอนที่ 1

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

ขั้นตอนที่ 5: อัปเดตการตั้งค่า TLS การดูแลความเรียบร้อย

หากคุณไม่ได้กำหนดค่า TLS สำหรับการสื่อสารด้านการดูแลความเรียบร้อย (HK) ระหว่างอินสแตนซ์เกตเวย์อิสระและการปรับใช้ Tableau Server แบ็คเอนด์ คุณสามารถข้ามขั้นตอนนี้ได้

หากคุณกำหนดค่า HK TLS คุณต้องคัดลอกการกำหนดค่าจากไฟล์ต้นฉบับ httpd.conf.stub ลงในไฟล์ที่อยู่ที่ /var/opt/tableau/tableau_tsig/config/httpd.conf.stub) อย่าเขียนทับไฟล์ใหม่ด้วยไฟล์ต้นฉบับ เนื่องจากไฟล์ที่ใหม่กว่าอาจมีการตั้งค่าอื่นๆ อยู่ด้วย

  1. อัปเดตการตั้งค่าการกำหนดค่า TLS ที่เกี่ยวข้องในบล็อกต่อไปนี้:

    <VirtualHost *:${TSIG_HK_PORT}>
    SSLEngine on
    #TLS# SSLHonorCipherOrder on
    #TLS# SSLCompression off
    SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
    SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
    SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>

    หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าเหล่านี้ โปรดดู กำหนดค่า TLS ในเกตเวย์อิสระ

  2. เมื่อคุณอัปเดต httpd.conf.stub เสร็จแล้ว ให้บันทึกไว้

  3. คัดลอก httpd.conf.stub แล้วบันทึกเพื่อเขียนทับ httpd.conf ในไดเรกทอรีเดิม

ขั้นตอนที่ 6: (ไม่บังคับ) อัปเดตการปรับใช้ Tableau Server แบ็คเอนด์

หากคุณคัดลอกไฟล์ authsecret ต้นฉบับ (tsighk-auth.conf ) ไปยังอินสแตนซ์ใหม่ของเกตเวย์อิสระตามที่อธิบายไว้ในขั้นตอนที่ 4 คุณจะสามารถข้ามขั้นตอนนี้ได้

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

tsm stop
tsm topology external-services gateway update -c tsig.json
tsm start

ขั้นตอนที่ 7: รีสตาร์ทบริการ tsig-httpd

เมื่อคุณกำหนดค่าเสร็จแล้ว ให้รีสตาร์ทบริการ tsig-httpd

sudo su - tableau-tsig
systemctl --user restart tsig-httpd
exit