Eseguire l’upgrade di Tableau Server con repository esterno per una nuova versione principale di PostgreSQL

Quando viene apportata una modifica al requisito per la versione principale di PostgreSQL per Tableau Server, è necessario seguire alcune istruzioni specifiche per assicurarsi che l’upgrade di Tableau Server abbia esito positivo. Ad esempio, Tableau Server 2020.4 richiede che il repository utilizzi PostgreSQL versione 12. Si tratta di una modifica della versione principale di PostgreSQL rispetto alla versione 9.x utilizzata nelle versioni di Tableau Server precedenti alla 2020.4. Pertanto, se esegui l’upgrade da una versione precedente di Tableau Server alla versione 2020.4 o successiva, dovrai eseguire le procedure descritte nelle sezioni seguenti per completare l’upgrade.

Questo argomento inoltre include informazioni sulla compatibilità del prodotto tra PostgreSQL e Tableau Server.

Prima di effettuare l’upgrade

Non puoi eseguire un upgrade sul posto per aggiornare la versione di PostgreSQL sull’istanza del database PostgreSQL esistente in Amazon RDS o nel database di Azure per PostgreSQL. È invece necessario creare una nuova istanza e puntare Tableau Server alla nuova istanza durante l’upgrade. Utilizza le informazioni seguenti per creare una nuova istanza e preparare l’upgrade:

  1. Crea una nuova istanza del database PostgreSQL:
    1. Creare un’istanza database PostgreSQL su AWS Relational Database Service (RDS)
    2. Creare un’istanza PostgreSQL del database di Azure in Azure
    3. Creare un’istanza PostgreSQL su Google Cloud
    4. Creare un database PostgreSQL come installazione autonoma
  2. Le connessioni SSL non sono necessarie ma consigliate. Se desideri configurare le connessioni SSL per le comunicazioni tra Tableau Server e il repository esterno, procedi come segue:
  3. Crea un file di configurazione per la nuova istanza creata nella fase 1.

    Crea un file json con le seguenti impostazioni di configurazione:

    {
     "flavor":"<flavor name>",
     "masterUsername":"<admin user name>",
     "masterPassword":"<password>", 
     "host":"<instance host name>",
     "port":5432
    }
    
    • flavor: indica il tipo di servizio esterno che intendi utilizzare per il repository di Tableau Server.

      • Amazon RDS: utilizza "rds"
      • Database di Azure: utilizza "azure"
      • Google Cloud Database: utilizza "gcp"
      • Database PostgreSQL autonomo: utilizza "generic"
    • masterUsername:

      • Amazon RDS: utilizza "rails" come nome utente. Si tratta dell’utente che hai specificato durante la creazione dell’istanza RDS.

        È necessario utilizzare "rails" per il parametro masterUsername. Questo è un requisito necessario affinché il repository esterno funzioni correttamente con Tableau Server.

      • Database di Azure, istanza di Google Cloud o istanza autonoma di PostgreSQL: scegli un nome utente che soddisfi i requisiti. È consigliabile utilizzare postgres come nome utente dell’amministratore. Se scegli di utilizzare un nome utente diverso, assicurati che non inizi con pg o azure. Il nome utente inoltre non può essere rails, tblwgadmin, tableau, readonly o tbladminviews.
    • masterPassword: si tratta della password specificata al momento della creazione dell’istanza del database PostgreSQL.

    • host: endpoint dell’istanza del database PostgreSQL.

    • port: porta del database specificata al momento della creazione dell’istanza del database PostgreSQL. La porta predefinita per PostgreSQL è 5432.

Upgrade di Tableau Server

Nota: se utilizzi il repository esterno di Tableau Server, devi eseguire l’upgrade di Tableau Server utilizzando l’opzione della riga di comando.

Di seguito è descritta la procedura generale per specificare i parametri del repository esterno durante l’esecuzione dello script di upgrade.

Per una descrizione completa del processo di upgrade di Tableau Server, consulta Upgrade dalle versioni precedenti

  1. In Tableau Server, apri un prompt dei comandi come amministratore.

    Nota: è necessario aprire una nuova finestra di comando perché il programma di installazione aggiorna il percorso per la nuova installazione.

  2. Passa alla cartella degli script per la nuova installazione.

    Per impostazione predefinita:

    /opt/tableau/tableau_server/packages/scripts.<version_code>/

  3. Esegui lo script di upgrade e specifica il file di configurazione e il certificato SSL:

    upgrade-tsm --external-repository-config-file=<json config file> --external-repository-cert-file=<SSL certificate file>

Compatibilità dei prodotti

Nella tabella seguente è elencata la versione di PostgreSQL supportata con Tableau Server. Utilizza questa tabella per determinare la versione di PostgreSQL da installare per il repository esterno.


Supporto di Amazon RDS: un repository esterno che utilizza Amazon RDS è supportato con Tableau Server versione 2019.3 e successive.
Supporto di Database di Azure: un repository esterno con un’istanza di Database di Azure è supportato con Tableau Server versione 2020.4 e successive.

Supporto di Google Cloud: un repository esterno che utilizza un’istanza di Google Cloud SQL è supportato con Tableau Server versione 2021.4 e successive.
Supporto di un’istanza autonoma di PostgreSQL: il repository esterno che utilizza un’installazione autonoma del database PostgreSQL è supportato con Tableau Server versione 2021.2 e successive.

Supporto di Google Cloud Platform: il repository esterno che utilizza un’istanza PostgreSQL su Google Cloud Platform è supportato con Tableau Server versione 2021.4 e successive.

Versioni di Tableau ServerVersioni minime compatibili con PostgreSQL
2021.2.3 - 2021.2.8

2021.3.0 - 2021.3.7

2021.4.0 - 2021.4.3

12.6
2021.2.10 - 2021.2.14

2021.3.8 - 2021.3.13

2021.4.4 - 2021.4.8

12.8
2021.2.15 - 2021.2.16

2021.3.14 - 2021.3.15

2021.4.9 - 2021.4.10

12.10
2021.2.17 - 2021.2.18

2021.3.16 - 2021.3.17

2021.4.11 - 2021.4.12

12.11
2021.3.26

2021.4.23

12.15
2022.1.013.3
2022.1.1 - 2022.1.313.4
2022.1.4 - 2022.1.613.6
2022.1.7 - 2022.1.16

2022.3.0 - 2022.3.7

2023.1.0 - 2023.1.4

13.7
2022.1.17 - 2022.1.19

2022.3.8 - 2022.3.11

2023.1.5 - 2023.1.7

2023.3.0 - 2023.3.3

13.11
2024,0 - 2024.x15.6
Compatibilità delle versioni legacy

La tabella seguente include due colonne:

  1. La versione di PostgreSQL fornita con Tableau Server, ovvero la versione installata con Tableau Server per i repository locali.
  2. Tutte le versioni di PostgreSQL supportate per il repository esterno.

Note:
- Per le versioni PostgreSQL precedenti alla versione 10, le prime due cifre indicano la versione principale e la versione secondaria è rappresentata dall’ultima cifra. Ad esempio, nella versione 9.4.1, 9.4 indica la versione principale e .1 indica la versione secondaria.
- Per PostgreSQL versione 10 o successive, la prima cifra indica la versione principale e la versione secondaria è rappresentata dall’ultima cifra. Ad esempio, nella versione 11.1, 11 è la versione principale e .1 è la versione secondaria.
- Una versione di PostgreSQL con la stessa versione principale e una versione secondaria maggiore della versione di PostgreSQL fornita con Tableau Server è sempre accettabile per l’utilizzo con il repository esterno, insieme a tutte le versioni precedenti esplicitamente consentite.

Versione di Tableau ServerVersione di PostgreSQL (fornita con Tableau Server)Versioni di PostgreSQL alternative supportate per il repository esterno
2019.3 - 2019.3.39.6.11

9.6.x, dove x è maggiore di 11

2019.3.4 - 2019.3.109.6.159.6.x, dove x è maggiore di 15
2019.3.11 - 2019.3.149.6.179.6.15 o 9.6.x, dove x maggiore di 17
2019.4 - 2019.4.19.6.149.6.x, dove x è maggiore di 14
2019.4.2 - 2019.4.69.6.159.6.x, dove x è maggiore di 15
2019.4.7 - 2019.4.139.6.179.6.15 o 9.6.x, dove x è maggiore di 17
2020.1 - 2020.1.69.6.159.6.x, dove x è maggiore di 15
2020.1.7 - 2020.3.29.6.179.6.15 o 9.6.x, dove x è maggiore di 17
2020.4 - 2021.412.8

12.8 o 12.x, dove x è maggiore di 8

2022.1 e successive.13.313.3 o 13.x, dove x è maggiore di 3

Chi può farlo

Gli amministratori di Tableau Server possono eseguire l’upgrade e configurare Tableau Server.

Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!