Automatische installatie van Tableau Server
U kunt SilentInstaller.py, een Python-script dat door de gemeenschap wordt ondersteund(Link wordt in een nieuw venster geopend) (in het Engels), gebruiken om een nieuwe installatie van Tableau Server te automatiseren. U kunt het script downloaden en gebruiken zoals geschreven, of het aanpassen aan uw specifieke behoeften.
Voordelen van het automatische installatieprogramma
Met één enkele opdracht kunt u een werkende instantie van Tableau Server installeren, configureren en uitvoeren.
Het
SilentInstaller.py-script kan worden uitgevoerd zonder gebruikersinvoer, waardoor het geschikt is voor automatisering.De configuratie kan eenmalig worden ingesteld en voor al uw installaties worden gebruikt, waardoor dit een herhaalbaar proces is.
Wanneer u het automatische installatieprogramma niet moet gebruiken
Als u Tableau Server voor het eerst installeert, raden we u aan uw installatie handmatig te testen voordat u het proces automatiseert. Eventuele problemen die de installatie blokkeren, zijn eenvoudiger interactief op te lossen. Nadat u deze problemen hebt opgelost, kunt u een automatische installatie van Tableau Server uitvoeren met behulp van het
SilentInstaller.py-script.Als u nieuwe configuratieparameters zoals verificatiemethoden test of uitprobeert, raden wij u aan de installatie eerst handmatig uit te voeren. Tableau Services Manager (TSM) valideert configuratie-entiteiten en weigert configuratieparameters die niet geldig zijn. Zodra u de juiste parameters hebt geïdentificeerd, kunt u het automatische installatieprogramma gebruiken.
Als u geen wachtwoorden in het geheimenbestand kunt of wilt invoeren, is het gebruik van het automatische installatieprogramma wellicht geen optie voor u.
Voordat u begint
Bekijk Voor de installatie... om er zeker van te zijn dat u Microsoft Windows Server hebt geïnstalleerd op een computer die voldoet aan de besturingssysteemvereisten en de minimale hardwarevereisten voor Tableau Server.
Opmerking: Als u Tableau Server aan het installeren bent in een productieomgeving, bekijk dan de minimale hardware-aanbevelingen. De aanbevelingen vertegenwoordigen de minimale hardwareconfiguratie die u moet gebruiken voor een productie-installatie van Tableau Server.
Om een geautomatiseerde installatie uit te voeren, gebruikt u het SilentInstaller.py-script, dat gebaseerd is op het Tableau Server-installatiepakket als invoer. Voordat u begint, raden wij u aan de volgende pakketten te downloaden:
Download Python 3.5(Link wordt in een nieuw venster geopend) (in het Engels) of later en installeer het op de computer waarop u Tableau Server wilt installeren.
Download zowel het
SilentInstaller.py-script als het Tableau Server-installatiepakket:Download het
SilentInstaller.py-script van GitHub(Link wordt in een nieuw venster geopend) (in het Engels), samen met config.template.json, Registration.template.json, secrets.template.json en de drie bootstrap-sjablonen (bootstrap.template.json, topologyBootstrap.template.json en workerBootstrap.template.json).Selecteer en download het juiste Tableau Server-installatiepakket van de pagina Tableau Server-productdownloads(Link wordt in een nieuw venster geopend). Welke u kiest, hangt af van de versie van Microsoft Windows Server die u wilt gebruiken.
Kopieer de pakketten en sjablonen naar een locatie op of toegankelijk vanaf de computer waarop u Tableau Server gaat installeren.
Het SilentInstaller.py-script gebruiken
Het SilentInstaller.py-script installeert het Tableau Server-installatiepakket, maakt de directory's aan, stelt de machtigingen in die nodig zijn om Tableau Server te draaien en start de configuratie van Tableau Services Manager (TSM). Nadat de TSM-configuratie is voltooid, voert het SilentInstaller.py-script tsm-opdrachten uit om Tableau Server te installeren, configureren en starten. Standaard activeert het SilentInstaller.py-script een proeflicentie tijdens de installatie. Als u over een werkelijke productcode beschikt, kunt u de productcode op de opdrachtregel opgeven of de productcode activeren nadat u het SilentInstaller.py-script hebt uitgevoerd. De meeste opdrachtregelopties in het automatische installatieprogramma zijn dezelfde als de opties die worden gebruikt door de opdracht tsm initialize.
U kunt het SilentInstaller.py-script in drie modi uitvoeren: installeer het initiële knooppunt, installeer extra knooppunten en update de clustertopologie. Wanneer u een installatie uitvoert voor een gedistribueerd cluster, voert u SilentInstaller.py uit met de opties om het initiële knooppunt op het initiële knooppunt te installeren. U voert SilentInstaller.py uit met de opties om extra knooppunten op elk extra knooppunt te installeren. Ten slotte voert u SilentInstaller.py uit met de opties om de clustertopologie op het initiële knooppunt bij te werken.
Het SilentInstaller.py-script is bedoeld om te worden uitgevoerd zonder gebruikersinteractie, dus u moet alle parameters invoeren in de vereiste argumenten die worden doorgegeven aan het SilentInstaller.py-script. Als alternatief kunt u de vereiste argumenten ook in het bootstrapbestand zetten. U kunt de geleverde Sjablonen voor configuratie-, registratie- en geheimenbestanden gebruiken.
Gebruik de volgende stappen om een installatie zonder toezicht uit te voeren:
Stap 1: Het automatische installatieprogramma installeren
Meld u op de computer aan als gebruiker met beheerderstoegang.
Download en installeer het
SilentInstaller.py-script, sjablonen en bootstrap-bestanden.
Stap 2: Bestanden maken om aanvullende configuratie-informatie op te geven die nodig is om de automatische installatie uit te voeren
Aangezien het SilentInstaller.py-script bedoeld is om te worden uitgevoerd zonder gebruikersinteractie, moet u de volgende aanvullende informatie opgeven:
Kopieer de sjablonen config.template.json, registration.template.json, en secrets.template.json naar een andere directory, zoals uw home-directory. We raden u niet aan de sjabloonbestanden rechtstreeks te bewerken.
Bewerk het config.sjabloon.json-bestand en geef de configuratie-instellingen van het initiële knooppunt op. U moet identiteitenarchiefinstellingen opgeven voor de Tableau Server-computer. Afhankelijk van uw netwerkvereisten moet u mogelijk ook de gateway-instellingen opgeven. De caching-optie is ingesteld om data zo lang mogelijk in de cache op te slaan en opnieuw te gebruiken. Er worden standaard voorbeeldwerkmappen geïnstalleerd. Het sjabloon bevat de minimaal vereiste informatie, dus het sjabloon is een startpunt. Zie Initiële knooppuntinstellingen configureren voor meer informatie over configuratie-instellingen.
Bewerk het registratie.sjabloon.json-bestand en geef de informatie op die nodig is om Tableau Server te registreren. Zie Tableau Server activeren en registreren voor meer informatie.
Bewerk het geheimen.sjabloon.json-bestand en geef de gebruikersnaam en het wachtwoord op voor de TSM-beheerder en beheerdersaccounts van Tableau Server.
Het TSM-beheerdersaccount moet dezelfde gebruiker zijn als de Windows-beheerder die het script uitvoert.
Het Tableau Server-beheerdersaccount is het initiële account dat door het installatieprogramma wordt gemaakt en wordt gebruikt voor beheer van Tableau Server.
Stap 3: De automatische installatie uitvoeren
Meld u op de computer aan als gebruiker met beheerderstoegang.
Het initiële knooppunt installeren
Het
SilentInstaller.py-script voert de juiste opdrachten uit om Tableau Services Manager te installeren, te activeren, te configureren en te starten. VoerSilentInstaller.py -henSilentInstaller.py install –huit om de volledige lijst met opties en hun standaardwaarden te bekijken.Het initiële knooppunt installeren:
Typ op het initiële knooppunt, bij een Python-prompt:
SilentInstaller.py install --secretsFile secrets.json --configFile myconfig.json --registrationFile registration.json TableauServer-64bit-<version>.exeOf anders:
SilentInstaller.py --bootstrapFile <bootstrap file path>Scriptoptie
Beschrijving
Vereiste switches --configFile <file path>
Het relatieve of absolute pad naar het JSON-bestand voor serverconfiguratie.
--secretsFile <file path>
Het relatieve of absolute pad naar het geheimenbestand waarin de inloggegevens staan van het Windows-account dat moet worden geverifieerd bij Tableau Services Manager (TSM), en de gebruikersnaam/het wachtwoord van de initiële beheerdergebruiker voor Tableau Server. Het geheimenbestand bevat ook de productcode die u wilt gebruiken om Tableau Server te activeren. Standaard bevat de sjabloon van het geheimenbestand een proeflicentie.
Opmerking: Het opgeven van het wachtwoord in het geheimenbestand is optioneel. Als er echter geen wachtwoorden in het geheimenbestand worden gevonden, wordt u tijdens de installatie gevraagd deze op te geven.
Het pakket voor automatische installatie bevat de sjabloon voor het geheimenbestand.
--registrationFile <file path>
Het relatieve of absolute pad naar het bestand voor serverregistratie met de registratiedata van Tableau Server.
Het pakket voor automatische installatie bevat de sjabloon voor het registratiebestand.
<installer executable file path>
Het relatieve of absolute pad naar het installatieprogramma van Tableau Services Manager (TSM).
Optionele switches --installDir <file path>
De directory voor Tableau Server-installatie. Als u geen pad opgeeft, wordt de standaarddirectory C:\Program Files\Tableau\Tableau Server gebruikt.
--dataDir <file path>
De locatie waar de Tableau Server-softwareconfiguratie en -data worden opgeslagen. Als u geen pad opgeeft, wordt de standaarddirectory C:\ProgramData\Tableau gebruikt voor de configuratie- en databestanden.
--installerLog <file path>
De bestaande directory waar de logboekbestanden van het installatieprogramma worden geschreven. Als u geen pad opgeeft, worden de logboekbestanden naar uw TEMP-directory geschreven.
--controllerPort <port number>
De poort waarop de Tableau Services Manager (TSM)-controller moet draaien.
--coordinationserviceClientPort <port number>
De ZooKeeper-clientpoort.
--coordinationservicePeerPort <port number>
De ZooKeeper-peerpoort.
--coordinationserviceLeaderPort <port number>
De ZooKeeper-leaderpoort.
--start
Of de server moet worden gestart wanneer de installatie is voltooid.
Extra knooppunten installeren
Het
SilentInstaller.py-script voert de juiste opdrachten uit om Tableau Services Manager (TSM) op het extra knooppunt te installeren. VoerSilentInstaller.py installWorker –huit om de volledige lijst met opties en de bijbehorende standaardwaarden te bekijken.Extra knooppunten installeren:
Typ op elk extra knooppunt, bij een Python-prompt:
SilentInstaller.py workerInstall --secretsFile secrets.json --nodeConfigurationFile nodeConfiguration.json TableauServer-64bit-<version>.exeOptie
Beschrijving
--secretsFile <file path>
Vereist. Het relatieve of absolute pad naar het geheimenbestand waarin de inloggegevens staan van het Windows-account dat moet worden geverifieerd bij Tableau Services Manager (TSM), en de gebruikersnaam/het wachtwoord van de initiële beheerdergebruiker voor Tableau Server. Het geheimenbestand bevat ook de productcode die u wilt gebruiken om Tableau Server te activeren. Standaard bevat de sjabloon van het geheimenbestand een proeflicentie.
Opmerking: Het opgeven van het wachtwoord in het geheimenbestand is optioneel. Als er echter geen wachtwoorden in het geheimenbestand worden gevonden, wordt u tijdens de installatie gevraagd deze op te geven.
Het pakket voor automatische installatie bevat de sjabloon voor het geheimenbestand.
--nodeConfigurationFile <file path>
Vereist. Pad naar het knooppuntconfiguratiebestand voor het installeren van het extra knooppunt.
(installer executable) <file path>
Vereist. Het laatste argument voor het script is eenvoudigweg het pad, absoluut of relatief, naar het uitvoerbare bestand van het Tableau Services Manager-installatieprogramma, verkregen via de gebruikelijke kanalen, zoals een download van de Tableau-website. Dit script wordt alleen ondersteund voor gebruik met Tableau Services Manager.
--installDir <file path>
Optioneel. De directory voor Tableau Server-installatie. Als dit leeg is, wordt de standaarddirectory C:\Program Files\Tableau\Tableau Server gebruikt.
--dataDir <file path>
Optioneel. De locatie waar de Tableau Server-softwareconfiguratie en -data worden opgeslagen. Als dit leeg is, wordt de standaardmap C:\ProgramData\Tableau gebruikt voor de configuratie- en databestanden.
--installerLog <file path>
Optioneel. De bestaande directory waar de logboekbestanden van het installatieprogramma worden geschreven. Als dit leeg is, worden de logboekbestanden naar de TEMP-directory van de gebruiker geschreven.
Opmerking: Het knooppuntconfiguratiebestand wordt automatisch opgeslagen na installatie van het initiële knooppunt met behulp van
SilentInstaller.py. U kunt deze vinden onder de werkende directory van het script.Clustertopologie updaten
Het
SilentInstaller.py-script voert de juiste opdrachten uit om de clustertopologie naar wens bij te werken voor Tableau Services Manager (TSM). VoerSilentInstaller.py updateTopology –huit om de volledige lijst met opties en de bijbehorende standaardwaarden te bekijken.Clustertopologie bijwerken:
Typ op het initiële knooppunt, bij een Python-prompt:
SilentInstaller.py updateTopology --secretsFile secrets.json --configFile myconfig.jsonOptie
Beschrijving
--secretsFile <file path>
Vereist. Het relatieve of absolute pad naar het geheimenbestand waarin de inloggegevens staan van het Windows-account dat moet worden geverifieerd bij Tableau Services Manager (TSM), en de gebruikersnaam/het wachtwoord van de initiële beheerdergebruiker voor Tableau Server. Het geheimenbestand bevat ook de productcode die u wilt gebruiken om Tableau Server te activeren. Standaard bevat de sjabloon van het geheimenbestand een proeflicentie.
Opmerking: Het opgeven van het wachtwoord in het geheimenbestand is optioneel. Als er echter geen wachtwoorden in het geheimenbestand worden gevonden, wordt u tijdens de installatie gevraagd deze op te geven.
Het pakket voor automatische installatie bevat de sjabloon voor het geheimenbestand.
--configFile <file path>
Vereist. Het relatieve of absolute pad naar het bestand Server-topologie waarin de bij te werken Tableau Server-topologie wordt beschreven. Alleen het topologyVersion-gedeelte van het bestand wordt toegepast, andere configuraties worden genegeerd.
Sjablonen voor configuratie-, registratie- en geheimenbestanden
U kunt de volgende voorbeeldsjablonen gebruiken om data te communiceren aan het SilentInstaller.py-script.
Voorbeeldsjabloon voor een geheimenbestand
{
"local_admin_user":"",
"local_admin_pass":"",
"content_admin_user":"",
"content_admin_pass":"",
"product_keys":["trial"]
}De local_admin_user is het Windows-account dat moet worden geverifieerd bij Tableau Services Manager.
De content_admin_user is de initiële beheerdergebruiker, die optreedt als supergebruiker voor heel Tableau Server wat betreft het maken en beheren van gebruikers, sites, enz.
Bij het installeren van extra knooppunten of het bijwerken van de clustertopologie worden deze referenties genegeerd omdat de initiële beheerder al was gemaakt toen het initiële knooppunt werd geïnstalleerd.
De product_keys is de code die wordt gebruikt om Tableau Services Manager te activeren. Als er meerdere codes zijn opgegeven, worden deze één voor één geactiveerd. In het geval van de niet-installatiemodus worden deze codes genegeerd omdat de licenties al zijn geactiveerd.
Voorbeeldsjabloon voor een Server-configuratiebestand
{
"configEntities":{
"runAsUser":{
"_type":"runAsUserType",
"name":"NT AUTHORITY\\NetworkService"
},
"gatewaySettings":{
"_type":"gatewaySettingsType",
"port":80,
"firewallOpeningEnabled":true,
"sslRedirectEnabled":true,
"publicHost":"****replace me****",
"publicPort":80,
"sslEnabled":false,
"sslPort":443
},
"identityStore":{
"_type":"identityStoreType",
"type":"local",
"domain":"****Domain Name Here****",
"nickname":"****Domain Nickname Here****"
}
},
"topologyVersion":{
"nodes":{
"****insert nodeId (lowercase) here****": {
"services": {
"filestore": {
"instances":[
{
"instanceId":"0"
}
]
},
"tabadmincontroller": {
"instances":[
{
"instanceId":"0"
}
]
},
"clientfileservice": {
"instances":[
{
"instanceId":"0"
}
]
},
"dataserver": {
"instances":[
{
"instanceId":"0"
},
{
"instanceId":"1"
}
]
},
"cacheserver": {
"instances":[
{
"instanceId":"0"
},
{
"instanceId":"1"
}
]
},
"vizqlserver": {
"instances":[
{
"instanceId":"0"
},
{
"instanceId":"1"
}
]
},
"backgrounder": {
"instances":[
{
"instanceId":"0"
},
{
"instanceId":"1"
}
]
},
"appzookeeper": {
"instances":[
{
"instanceId":"0"
}
]
},
"pgsql": {
"instances":[
{
"instanceId":"0"
}
]
},
"dataengine": {
"instances":[
{
"instanceId":"0"
}
]
},
"licenseservice": {
"instances":[
{
"instanceId":"0"
}
]
},
"searchserver": {
"instances":[
{
"instanceId":"0"
}
]
},
"clustercontroller": {
"instances":[
{
"instanceId":"0"
}
]
},
"tabsvc": {
"instances":[
{
"instanceId":"0"
}
]
},
"vizportal": {
"instances":[
{
"instanceId":"0"
}
]
},
"tabadminagent": {
"instances":[
{
"instanceId":"0"
}
]
},
"clientfileservice": {
"instances":[
{
"instanceId":"0"
}
]
},
"gateway": {
"instances":[
{
"instanceId":"0"
}
]
}
}
}
}
}
}
Voorbeeldsjabloon voor een Server-registratiebestand
{
"first_name" : "Andrew",
"last_name" : "Smith",
"phone" : "311-555-2368",
"email" : "andrew.smith@mycompany.com",
"company" : "My Company",
"industry" : "Finance",
"company_employees" : "500",
"department" : "Engineering",
"title" : "Senior Manager",
"city" : "Kirkland",
"state" : "WA",
"zip" : "98034",
"country" : "United States",
"opt_in" : "true",
"eula" : "true"
}