tsm maintenance


U kunt gebruikmaken van de tsm maintenance-opdrachten om serveronderhoudsjobs te beheren, zoals het maken van back-ups of Tableau Server herstellen met behulp van een eerder gemaakte back-up.

tsm maintenance backup

Maakt een back-up van de data die worden beheerd door Tableau Server. Deze data omvatten de Tableau PostgreSQL-database (de opslagplaats) die metadata van werkmappen en gebruikers bevat, en extractbestanden (.tde of .hyper). Deze data omvatten geen configuratiedata. Zie Een volledige back-up maken van Tableau Server en Tableau Server herstellen.

Opmerking: Gebruik deze opdracht niet bij Tableau Server-installaties met extern bestandsarchief. Zie Back-up maken en terugzetten met extern bestandsarchief.

Optimaliseren met topologieconfiguraties:

  • Wanneer Bestandsarchief en de Beheercontroller op hetzelfde knooppunt worden geplaatst, kan dit de tijd verkorten die nodig is om een back-up te maken van Tableau Server, doordat de noodzaak om data over te dragen tussen knooppunten tijdens het back-upproces wordt verminderd of geëlimineerd. Dit geldt vooral als uw organisatie veel extracten gebruikt.
  • Het plaatsen van de opslagplaats (pgsql) op het Beheercontroller-knooppunt kan ook helpen de back-uptijd te verkorten, maar de tijdsbesparing is minder groot dan bij het Bestandsarchief.

De Beheercontroller bevindt zich doorgaans op het eerste knooppunt, tenzij er een uitval van het eerste knooppunt heeft plaatsgevonden en u de controller naar een ander knooppunt hebt verplaatst.

Het back-upbestand wordt op een tijdelijke locatie in de datadirectory samengesteld en vervolgens naar de directory geschreven die in de TSM-variabele basefilepath.backuprestore is gedefinieerd:

/var/opt/tableau/tableau_server/data/tabsvc/files/backups/<filename>.tsbak

Zie tsm-bestandspaden voor meer informatie over de locatie waar back-upbestanden worden opgeslagen en hoe u deze locatie kunt wijzigen. Opmerking: zelfs wanneer u de back-uplocatie wijzigt, gebruikt het back-upproces een tijdelijke locatie in de datadirectory om het back-upbestand samen te stellen.

Overzicht

tsm maintenance backup --file <backup_file> [options] [global options]

Opties

-f, --file <backup_file>

Vereist.

Zie Back-up maken van Tableau Server-data voor meer informatie over het maken van een back-up van de data uit de opslagplaats.

-d, --append-date

Optioneel.

Voeg de huidige datum toe aan het einde van de naam van het back-upbestand.

Opmerking: Back-ups die met behulp van een planning zijn gemaakt, bevatten automatisch een datum/tijd aan het begin van de naam van het back-upbestand. Als u ook gebruik maakt van de -d-optie zal uw bestandsnaam de datum tweemaal bevatten. Zie voor meer informatie over het plannen van back-ups Back-ups plannen en beheren.

-i, --description <string>

Optioneel.

Voeg de opgegeven beschrijving van het back-upbestand toe.

--ignore-prompt

Optioneel. Toegevoegd in versie 2020.2.

Maak een back-up zonder prompt, zelfs als het bestandsarchief zich niet op hetzelfde knooppunt bevindt als de beheercontroller (meestal het initiële knooppunt). Gebruik deze prompt als u back-ups automatiseert (bijvoorbeeld met scripts).

-k, --skip-verification

Optioneel.

Controleer de integriteit van de databaseback-up niet.

--multithreaded

Optioneel. Toegevoegd in versie 2021.1

Standaard wordt één reeks gebruikt bij het maken van een Tableau Server-back-up. Wanneer deze optie is opgegeven, wordt er een back-up gemaakt met behulp van meerdere reeksen. Als deze optie is opgegeven, worden er standaard twee reeksen gebruikt. U kunt het aantal gebruikte reeksen wijzigen door de backup.zstd.thread_count-configuratiesleutel in te stellen.

--override-disk-space-check

Optioneel.

Probeer een back-up te maken, zelfs als er een waarschuwing voor weinig schijfruimte wordt weergegeven.

-po, --pg-only

Optioneel.

Genereert alleen de back-up van de opslagplaats.

--request-timeout <timeout in seconds>

Optioneel.

Aantal seconden dat moet worden gewacht totdat de opdracht is voltooid. De standaardwaarde is 86400 (1440 minuten).

-sd, --schedule-days <day[,day]>

Optioneel. Toegevoegd in versie 2020.4.

Dagen waarop de planning moet worden uitgevoerd. Gebruik 1-7 voor een weekplanning (1 voor maandag, 7 voor zondag), 1-31 een voor maandplanning (als een maand de opgegeven dag niet bevat, wordt de laatste dag van de maand gebruikt). Scheid meerdere waarden met komma's.

-si, --schedule-id <ID>

Optioneel. Toegevoegd in versie 2020.4.

Geef de ID op van een bestaande planning die u wilt bijwerken.

--skip-compression

Optioneel.

Maak een back-up zonder compressie te gebruiken. Dit resulteert in een groter back-upbestand, maar kan de hoeveelheid tijd die nodig is om de back-up te voltooien, verkorten. Als u dit gebruikt in een installatie met meerdere knooppunten, raden we u ten zeerste aan een bestandsarchief-instantie te configureren op uw initiële knooppunt.

-sn, --schedule-name <name>

Optioneel. Toegevoegd in versie 2020.4.

Geef de naam op voor een planning die u maakt of bijwerkt.

-sr, --schedule-recurrence <frequency>

Optioneel. Toegevoegd in versie 2020.4.

Frequentie van herhaling van de planning. Geldige opties zijn 'dagelijks', 'wekelijks' of 'maandelijks'.

-st, --schedule-time <HH:MM>

Optioneel. Toegevoegd in versie 2020.4.

De tijd waarop een planning moet worden uitgevoerd, in 24-uursnotatie: HH:MM.

Voorbeelden

In dit voorbeeld wordt een back-up gemaakt met de naam ts_backup-<yyyy-mm-dd>.tsbak in de /var/opt/tableau/tableau_server/data/tabsvc/files/backups/-directory:

tsm maintenance backup -f ts_backup -d

In dit voorbeeld wordt een herhalende wekelijkse back-upplanning gemaakt met de naam 'wekelijkse-zaterdag-back-up' die elke zaterdag om 12.00 uur wordt uitgevoerd en een back-up maakt met de naam <yyyy.mm.dd.hh.mm>-ts_saturday_backup.tsbak:

tsm maintenance backup -f ts_saturday_backup -sr weekly -st 12:00 -sd 6 -sn weekly-saturday-backup

Zie Back-ups plannen en beheren voor meer informatie over het beheren van geplande back-ups.

tsm maintenance cleanup

Standaard verwijdert de tsm maintenance cleanup-opdracht tijdelijke bestanden en logboekbestanden die ouder zijn dan één dag. Met opdrachtopties kunt u de bewaarlengte wijzigen en bepalen welke bestanden worden verwijderd.

De impact van deze opdracht is afhankelijk van of Tableau Server wordt uitgevoerd.

  • Als de server wordt uitgevoerd, kunnen de meeste oude bestanden en http_requests-tabelitems worden verwijderd, maar alle bestanden die in gebruik zijn (vergrendeld door het besturingssysteem) kunnen niet worden verwijderd, dus tijdelijke bestanden en actieve logboekbestanden worden niet verwijderd. Om tijdelijke bestanden en huidige logboekbestanden te verwijderen, moet u de server stoppen voordat u deze opdracht uitvoert. Om http_requests-tabelitems te verwijderen, gebruikt u de -q-optie.
  • Als de server is gestopt, kunnen http_requests-items niet worden verwijderd.

Als u Tableau Server op een gedistribueerde implementatie gebruikt, voert u deze opdracht uit op het knooppunt waarop de beheercontrollerproces wordt uitgevoerd (ook wel de TSM-controller). Standaard en in de meeste gevallen bevindt de controller zich op het initiële knooppunt in het cluster.

Opmerking: Deze opdracht is toegevoegd in Tableau Server versie 10.5.1 en enkele opties zijn toegevoegd in versie 2018.1.

Overzicht

tsm maintenance cleanup [options] [global options]

Opties

-a, --all

Optioneel.

Voer alle opschoonwerkzaamheden uit met standaard bewaarwaarden. Gelijk aan het uitvoeren van de cleanup-opdracht met de volgende opties: -l -t -r -q -ic.

--http-requests-table-retention <# of days>

Optioneel.

Standaard: 7 dagen

Geef het aantal dagen op gedurende welke de http_requests-tabelitems moeten worden bewaard. Gebruik deze optie met de -q-optie om het aantal dagen op te geven gedurende welke tabelitems moeten worden bewaard, waarbij de standaardwaarde van 7 dagen wordt overschreven. Deze optie specificeert de bewaartermijn voor tabelitems, maar activeert niet de daadwerkelijke verwijdering van tabelitems. Gebruik deze samen met de -q-optie, die het verwijderen van items triggert.

-ic, --sheet-image-cache

Optioneel. Toegevoegd in versie 2019.4.

Wis de afbeeldingscache. Deze cache kan afbeeldingen bevatten voor offline previews, momentopnamen voor abonnementsmailberichten en abonnements-pdf's, evenals alle afbeeldingen die zijn aangevraagd bij het publicatie-rest-API-eindpunt (zie rest_api_ref.htm(Link wordt in een nieuw venster geopend) voor meer informatie).

-l, --log-files

Optioneel.

Verwijder logboekbestanden die ouder zijn dan 1 dag. Bestanden in de submappen onder data/tabsvc/logs zullen worden verwijderd.

--log-files-retention <# of days>

Optioneel.

Standaard: 1 (24 uur)

Verwijder logboeken die ouder zijn dan dit aantal dagen. Gebruik dit om de standaard bewaartermijn van 1 dag te overschrijven. Deze opdracht is niet van toepassing op tijdelijke bestanden.

-q, --http-requests-table

Optioneel.

Verwijder oude http_requests-tabelitems. Tableau Server moet worden uitgevoerd om tabelitems te kunnen verwijderen. Deze optie wordt genegeerd als Tableau Server wordt gestopt. Deze optie kan alleen worden gebruikt om de verwijdering van items op te geven die ouder zijn dan de standaardbewaarperiode (7 dagen), of samen met --http-requests-table-retention om een niet-standaardbewaarperiode op te geven.

Opmerking: Het verwijderen van http_requests-tabelitems verwijdert permanent data die beschikbaar zijn voor aangepaste administratieve weergaven. Zorg ervoor dat het verwijderen van deze data geen invloed heeft op de aangepaste weergaven die u nodig hebt.

-r, --redis-cache

Optioneel.

Wis de Redis-cache.

--request-timeout <timeout in seconds>

Optioneel.

Standaard: 3.600

Wacht de opgegeven tijd totdat de opdracht is voltooid.

-t, --temp-files

Optioneel.

Verwijder alle bestanden en subdirectory's in de volgende directory's:

  • /var/opt/tableau/tableau_server/data/tabsvc/temp: alleen directory's waarin bestanden worden opgeslagen voor verlopen (niet actieve) sessies worden verwijderd.

  • /var/opt/tableau/tableau_server/data/tabsvc/httpd/temp

  • /var/opt/tableau/tableau_server/temp

Voorbeelden

In dit voorbeeld worden alle logboekbestanden opgeschoond die ouder zijn dan 2 dagen:

tsm maintenance cleanup -l --log-files-retention 2

tsm maintenance jmx disable

Versie: opdracht toegevoegd in versie 2022.1.

Gebruik de tsm maintenance jmx disable-opdracht om JMX op Tableau Server uit te schakelen.

Voor het uitvoeren van deze opdracht moet Tableau Server opnieuw worden gestart, inclusief TSM-services.

Overzicht

tsm maintenance jmx disable [options] [global options]

Opties

--ignore-prompt

Optioneel.

Schakel JMX uit zonder prompt.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance jmx enable

Versie: opdracht toegevoegd in versie 2022.1.

Gebruik de tsm maintenance jmx enable-opdracht om JMX op Tableau Server in te schakelen.

Deze opdracht is interactief en vraagt u om toepasselijke opties als u deze niet opgeeft als opdrachtregelparameters.

Voor deze opdracht moet Tableau Server opnieuw worden gestart, inclusief TSM-services.

Overzicht

tsm maintenance jmx enable

Opties

--access <readonly | readwrite>

Optioneel.

Schakel JMX in met readonly- of readwritetoegang. Standaard is readonly.

--ignore-prompt

Optioneel.

Schakel JMX in zonder prompt voor extra beveiligingsopties. Dit schakelt JMX in met SSL en start Tableau Server opnieuw op als u geen andere opdrachtopties opneemt. Bijvoorbeeld:

tsm maintenance jmx enable --ignore-prompt

--no-ssl

Optioneel.

Schakel JMX zonder SSL in.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

--ssl-client-auth

Optioneel.

Schakel JMX in waarvoor clientverificatie voor SSL vereist is.

--unsecured

Optioneel.

Schakel JMX in zonder dat er beveiligingsfuncties zijn ingeschakeld (dit wordt niet aanbevolen). Dit is het equivalent van het instellen van de service.jmx_enabled-configuratiesleutel op true in versies vóór 2022.1.

tsm maintenance metadata-services disable

Versie: opdracht toegevoegd in versie 2019.3.

Gebruik de tsm maintenance metadata-services disable-opdracht om de Tableau-metadata-API uit te schakelen.

Als u de metadata-API uitschakelt, wordt de doorlopende opname en indexering van informatie over de inhoud op Tableau Server gestopt, wordt de index verwijderd van informatie over de inhoud die op Tableau Server is gepubliceerd en de assets die aan die inhoud zijn gekoppeld, en wordt de mogelijkheid uitgeschakeld om de metadata-API te doorzoeken en toegang te krijgen tot Tableau Catalog.

Het uitvoeren van deze opdracht stopt en start enkele services die worden gebruikt door Tableau Server, waardoor bepaalde functies, zoals Aanbevelingen, tijdelijk niet beschikbaar zijn voor uw gebruikers.

Overzicht

tsm maintenance metadata-services disable

Optie

--ignore-prompt

Optioneel.

Negeer de bevestigingsprompt bij het uitschakelen van de metadata-API.

tsm maintenance metadata-services enable

Versie: opdracht toegevoegd in versie 2019.3.

Gebruik de tsm maintenance metadata-services enable-opdracht om de Tableau-metadata-API voor Tableau Server in te schakelen.

Als Tableau Server een licentie heeft voor de Databeheer, wordt Tableau Catalog ingeschakeld als u de metadata-API inschakelt.

Bij het inschakelen van de metadata-API wordt informatie over de inhoud op Tableau Server opgenomen en vervolgens geïndexeerd naar het metadata-API-archief. De metadata-API kan worden gebruikt om in planningen, herkomst en door de gebruiker beheerde metadata te zoeken naar de gepubliceerde inhoud op Tableau Server. Nadat de metadata-API is ingeschakeld, worden metadata continu opgenomen en geïndexeerd totdat de metadata-API wordt uitgeschakeld.

Houd bij het uitvoeren van deze opdracht rekening met het volgende:

  • Deze opdracht stopt en start enkele services die worden gebruikt door Tableau Server, waardoor bepaalde functies, zoals Aanbevelingen, tijdelijk niet beschikbaar zijn voor uw gebruikers.
  • Er wordt een nieuwe index van metadata gemaakt die de vorige index vervangt telkens wanneer deze opdracht wordt gebruikt.

Zie Over Tableau Catalog voor meer informatie over de Tableau Catalog.

Overzicht

tsm maintenance metadata-services enable

Optie

--ignore-prompt

Optioneel.

Negeer de bevestigingsprompt bij het inschakelen van de metadata-API.

tsm maintenance metadata-services get-status

Versie: opdracht toegevoegd in versie 2019.3.

Gebruik de tsm maintenance metadata-services get-status-opdracht om statusinformatie over metadataservices op te halen.

De status van metadataservices geeft aan of het metadata-API-archief is geïnitialiseerd en of de Tableau-metadata-API wordt uitgevoerd of niet.

Overzicht

tsm maintenance metadata-services get-status

tsm maintenance reindex-search

Gebruik de tsm maintenance reindex-search-opdracht om de zoekindex opnieuw op te bouwen.

Overzicht

tsm maintenance reindex-search [options] [global options]

Optie

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance reset-searchserver

Versie: Deze opdracht is in 2023.3.0 buiten gebruik gesteld (verwijderd) toen Zoeken en bladeren (ook wel Zoekserver genoemd) buiten gebruik werd gesteld. Zoeken en bladeren is vervangen door Indexerings- en zoekserver.

Opmerking: Het uitvoeren van deze opdracht op versie 2023.3.0 of hoger zal niets doen.

Stelt de zoekserver opnieuw in naar een schone staat, verwijdert zoekinformatie en bouwt de zoekindex opnieuw op.

Overzicht

tsm maintenance reset-searchserver [options] [global options]

Optie

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance restore

Herstel Tableau Server met behulp van het opgegeven back-upbestand. Als u een back-upbestand herstelt, worden er geen configuratiedata hersteld. Zie Een volledige back-up maken van Tableau Server en Tableau Server herstellen.

U kunt alleen herstellen vanaf een back-up die hetzelfde type identiteitenarchief heeft als de actieve server. Een back-up van een server die lokale verificatie gebruikt, kan bijvoorbeeld worden hersteld naar een Tableau Server die is geïnitialiseerd met lokale verificatie, maar een back-up van een server die Active Directory-verificatie gebruikt, kan niet worden hersteld naar een server die is geïnitialiseerd met lokale verificatie.

Vanaf versie 2022.3 worden back-ups gemaakt met tabadmin ('pre-TSM-back-ups') niet ondersteund. U kunt een back-up van vóór TSM niet herstellen naar Tableau Server-versie 2022.3 of hoger.

Overzicht

tsm maintenance restore --file <file_name> [--restart-server] [global options]

Opties

-f, --file <file_name>

Vereist.

Specificeert het back-upbestand waarmee u wilt herstellen.

De restore -opdracht verwacht een back-upbestand in de directory die is gedefinieerd in de variabele basefilepath.backuprestore in TSM. Standaard:

/var/opt/tableau/tableau_server/data/tabsvc/files/backups/

Zie tsm-bestandspaden voor meer informatie over bestandspaden en hoe u deze kunt wijzigen.

-ak, --asset-key-file <file_name>

Optioneel. Verouderd in versie 2021.4.0.

Geef deze optie alleen op als u herstelt vanuit assets die zijn gemaakt door tabadmin op Tableau Server (versies 2018.1 en eerder).

Naam van het assetsleutelbestand waarmee u wilt herstellen. Het assetsleutelbestand wordt gemaakt door middel van de tabadmin assetkeys-opdracht. Het bestand moet zich op de vooraf gedefinieerde back-up-/herstellocatie op de server bevinden.

-k, --skip-identity-store-verification

Optioneel. Geef deze optie alleen op als u herstelt vanuit een back-upbestand dat is gemaakt door tabadmin op Tableau Server (versies 2018.1 en eerder).

Gebruik deze sleutel niet in een poging het identiteitenarchieftype te wijzigen van Tableau Server dat het originele back-upbestand heeft gemaakt. Zie Het identiteitenarchief wijzigen om het identiteitenarchief te wijzigen.

-po, --pg-only

Optioneel.

Herstelt alleen de opslagplaats.

-r, --restart-server

Optioneel.

Start de server opnieuw op na het herstel.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance send-logs

Upload het opgegeven bestand naar Tableau en koppel het aan een ondersteuningscase. Om bestanden succesvol naar Tableau te kunnen uploaden, moet Tableau Server kunnen communiceren met de verzendlogboekenserver op https://report-issue.tableau.com.

Overzicht

tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]

Opties

-c,--case <case_number>

Vereist.

Nummer van ondersteuningscase.

-e,--email <contact_email>

Vereist.

E-mailadres voor contact.

-f, --file <path/to/file>

Vereist.

Specificeert de locatie en naam van het logboekbestandsarchief dat moet worden verzonden.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance snapshot-backup complete

Versie: opdracht toegevoegd in versie 2020.1 en alleen beschikbaar wanneer Tableau Server is geconfigureerd voor een externe bestandsarchief.

Voltooi het momentopnameback-upproces op Tableau Server. Voer dit uit nadat u een momentopnameback-up van uw externe opslag hebt gemaakt.

De opdrachten tsm maintenance snapshot-backup prepare en de tsm maintenace snapshot-backup complete worden gebruikt om een back-up te maken van Tableau Server-data voor Tableau Server-installaties die zijn geconfigureerd met een extern bestandsarchief. Zie Back-up maken en terugzetten met extern bestandsarchief

Overzicht

tsm maintenance snapshot-backup complete [options] [global options]

Opties

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance snapshot-backup prepare

Versie: opdracht toegevoegd in versie 2020.1 en alleen beschikbaar wanneer Tableau Server is geconfigureerd voor een externe bestandsarchief.

Bereidt het maken van een momentopnameback-up voor. Zodra de voorbereidingsstap is voltooid, kunt u een momentopnameback-up van uw netwerkopslag maken.

De opdrachten tsm maintenance snapshot-backup prepare en tsm maintenace snapshot-backup complete worden gebruikt om een back-up te maken van Tableau Server-data voor Tableau Server-installaties die zijn geconfigureerd met een extern bestandsarchief. Zie Back-up maken en terugzetten met extern bestandsarchief

Overzicht

tsm maintenance snapshot-backup prepare [options] [global options]

Opties

--include-pg-backup

Optioneel. Toegevoegd in versie 2021.1. Eerdere versies bevatten altijd een back-up van de externe opslagplaats.

Optioneel.

Er wordt een back-up van de opslagplaats gemaakt en naar de netwerkshare gekopieerd. Dit is alleen van toepassing op implementaties waarbij zowel de externe opslagplaats als het externe bestandsarchief zijn geconfigureerd. Zie Back-up maken en terugzetten met extern bestandsarchief voor meer informatie.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance snapshot-backup restore

Versie: opdracht toegevoegd in versie 2020.1 en alleen beschikbaar wanneer Tableau Server is geconfigureerd voor een externe bestandsarchief.

Herstelt de back-up van de opslagplaats van de opslag-momentopname op Tableau Server.

Zie Back-up maken en terugzetten met extern bestandsarchief.

Overzicht

tsm maintenance snapshot-backup restore [options] [global options]

Opties

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance validate-backup-basefilepath

Versie: opdracht toegevoegd in versie 2022.1.

Valideer dat de locatie van het basisbestandspad voor back-up/herstel de juiste machtigingen heeft zodat de back-up- en herstelfuncties correct werken. Voer dit uit nadat u het basisbestandspad voor back-up en herstel hebt ingesteld. Zie De huidige bestandslocatie wijzigen voor meer informatie.

Overzicht

tsm maintenance validate-backup-basefilepath [options][global options]

Opties

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance validate-resources

Valideer werkmappen en databronnen voor een site. Gebruik deze opdracht voordat u een site migreert, om problemen met sitebronnen, zoals werkmappen en databronnen, op te sporen waardoor het importeren van een site kan mislukken. Sommige problemen met bronnen kunnen worden verholpen door opnieuw te publiceren vanuit lokale bronnen. Voor andere problemen is mogelijk hulp van Tableau-ondersteuning vereist.

Overzicht

tsm maintenance validate-resources --site-id <site ID> [global options]

Opties

-id,--site-id <site ID>

Vereist.

ID voor de site waarvan u de bronnen valideert.

-r,--repair

Optioneel.

Probeer ongeldige bronnen te repareren. De bronnen die niet kunnen worden gerepareerd, worden vermeld in de uitvoer.

--request-timeout <timeout in seconds>

Optioneel.

Wacht de opgegeven tijd totdat de opdracht is voltooid.

tsm maintenance ziplogs

Gebruik de opdracht ziplogs om een archief te maken van Tableau Server-logboekbestanden.

Opmerking: als u de ziplogs-opdracht niet succesvol kunt uitvoeren, kunt u de Tableau Server-logboeken handmatig zippen. Zie Problemen met Tableau Server op Linux oplossen voor meer informatie.

Overzicht

tsm maintenance ziplogs [options] [global options]

Opties

-a, --all

Optioneel.

Neem alle bestanden op, behalve PostgreSQL-data.

-d, --with-postgresql-data

Optioneel.

Voeg de PostgreSQL-datamap toe als Tableau Server wordt gestopt of PostgreSQL-dumpbestanden als Tableau Server wordt uitgevoerd. Deze vlag wordt genegeerd voor implementaties die worden uitgevoerd met een Externe opslagplaats Tableau Server.

--enddate "<mm/dd/yyyy H:mm>"

Optioneel. Tijdoptie (H:mm) toegevoegd in versie 2021.4.0.

De laatste datum van de logboekbestanden die moeten worden opgenomen. Deze optie moet worden gebruikt met --startdate en kan niet worden gebruikt met --minimumdate. Als deze optie niet is opgegeven, worden maximaal twee dagen aan logboeken opgenomen, beginnend om 00.00 uur GMT.

Als u de tijdoptie opneemt, moet u aanhalingstekens rond de datum en tijd gebruiken. De tijdoptie maakt gebruik van GMT, maar de resulterende logboekbestanden worden geschreven met behulp van de lokale tijdzone van de Tableau Server-machine.

Voorbeeld: Als de lokale tijdzone van de Tableau Server-machine PDT is en u wilt dat de logboekbestanden beginnen om 7.00 uur PDT en eindigen om 19.00 uur PDT op 28-07-2022, gebruik dan het volgende:

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

-f, --file <name>

Optioneel.

Geef een naam op voor het gecomprimeerde archiefbestand. Als er geen naam wordt opgegeven, wordt het archief gemaakt als logs.zip. Het bestand wordt geschreven naar de directory die is gedefinieerd in de variabele basefilepath.log_archive in TSM. Standaard:

/var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/

Zie tsm-bestandspaden voor meer informatie over bestandspaden en hoe u deze kunt wijzigen.

-i, --description <string>

Optioneel.

Voeg de opgegeven beschrijving van het archiefbestand toe.

-l, --with-latest-dump

Optioneel.

Wanneer een service crasht, genereert Tableau Server een dumpbestand. Stel deze optie in om het meest recente dumpbestand van de servicecrash op te nemen. Als u deze optie niet instelt, wordt er geen dumpbestand opgenomen in de resulterende ziplog.

-m, --minimumdate <mm/dd/yyyy>

Optioneel.

De vroegste datum van de logboekbestanden die moeten worden opgenomen. Indien niet gespecificeerd, worden er maximaal twee dagen aan logboekbestanden opgenomen. Het datumformaat moet zijn: 'mm/dd/yyyy'. Deze optie kan niet worden gebruikt met --startdate en --enddate of --all.

--nodes

Optioneel. Toegevoegd in versie 2020.3.

Geef de knooppunten op waarvoor u een ziplog-bestand wilt maken. Als dit niet is opgegeven, worden er ziplog-bestanden gemaakt voor alle knooppunten en opgeslagen op het oorspronkelijke knooppunt. Scheid knooppunten van elkaar met een komma. Om bijvoorbeeld logboeken te verzamelen voor knooppunten 2 en 4:

tsm maintenance ziplogs --nodes node2,node4

-o, --overwrite

Optioneel.

Voor het overschrijven van een bestaand ziplog-bestand. Als er al een bestand met dezelfde naam bestaat en deze optie niet wordt gebruikt, mislukt de ziplogs-opdracht.

Standaard wordt het bestand geschreven naar:

/var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/

Zie tsm-bestandspaden voor meer informatie over bestandspaden en hoe u deze kunt wijzigen.

--request-timeout <seconds>

Optioneel.

Aantal seconden dat moet worden gewacht totdat de opdracht is voltooid. De standaardwaarde is 7200 (120 minuten).

--startdate "<mm/dd/yyyy H:mm>"

Optioneel. Tijdoptie (H:mm) toegevoegd in versie 2021.4.0.

De laatste datum van de logboekbestanden die moeten worden opgenomen. Deze optie moet worden gebruikt met --enddate en kan niet worden gebruikt met --minimumdate. Als deze optie niet is opgegeven, worden maximaal twee dagen aan logboeken opgenomen, beginnend om 00.00 uur GMT.

Als u de tijdoptie opneemt, moet u aanhalingstekens rond de datum en tijd gebruiken. De tijdoptie maakt gebruik van GMT, maar de resulterende logboekbestanden worden geschreven met behulp van de lokale tijdzone van de Tableau Server-machine.

Voorbeeld: Als de lokale tijdzone van de Tableau Server-machine PDT is en u wilt dat de logboekbestanden beginnen om 7.00 uur PDT en eindigen om 19.00 uur PDT op 28-07-2022, gebruik dan het volgende:

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

 

Algemene opties

-h, --help

Optioneel.

Toon de opdracht help.

-p, --password <password>

Vereist, samen met -u of --username als er geen sessie wordt uitgevoerd.

Geef het wachtwoord op voor de gebruiker die wordt opgegeven in -u of --username.

Als het wachtwoord spaties of speciale tekens bevat, plaatst u deze tussen aanhalingstekens:

--password 'my password'

-s, --server https://<hostname>:8850

Optioneel.

Gebruik het opgegeven adres voor Tableau Services Manager. De URL moet beginnen met https. Voeg poort 8850 toe en gebruik de servernaam en niet het IP-adres. Bijvoorbeeld https://<tsm_hostname>:8850. Als er geen server is opgegeven, wordt uitgegaan van https://<localhost | dnsname>:8850.

--trust-admin-controller-cert

Optioneel.

Gebruik deze vlag om het zelfondertekende certificaat op de TSM-controller te vertrouwen. Zie TSM-clients verbinden voor meer informatie over certificaatvertrouwen en CLI-verbindingen.

-u, --username <user>

Vereist als er geen sessie wordt uitgevoerd, samen met -p of --password.

Geef een gebruikersaccount op. Als u deze optie niet opneemt, wordt de opdracht uitgevoerd met de referenties waarmee u zich hebt aangemeld.

 

Terug naar boven
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.