Konfigurera Gateway för dataflytt
Att konfigurera Gateway för dataflytt inbegriper procedurer som måste utföras både i Administration och på Gateway för dataflytt-servern.
- Alla CLI-kommandon måste köras på Gateway för dataflytt-servern.
- Installations- (RPM) och tjänstkommandon måste köras som sudo eller som root.
-
Gateway för dataflytt-procedurer som måste utföras i Administration kräver behörighet som klientorganisationsadministratör.
Se även: Överväganden när du associerar datagatewayen med ett utrymme
Om du vill använda knowledge marts, se Ställa in Qlik Data Gateway – dataflytt för kunskapsmarter.
Steg ett: Hämta Gateway för dataflytt
-
För att komma åt datagateways väljer du Administration från Start-menyn (
) och sedan Datagateways.
Alla befintliga datagateways listas i en tabell som visar grundläggande information om varje gateway.
-
Klicka på knappen Distribuera i verktygsfältet.
-
Välj Data Gateway - Dataflytt, godkänn Qlik-kundavtalet och klicka på Hämta.
Gateway för dataflytt RPM (qlik-data-gateway-data-movement.rpm) hämtas till din maskin.
Steg två: Installera och konfigurera Gateway för dataflytt
Detta steg inbegriper att installera Gateway för dataflytt, ställa in Qlik Cloud-URL:en och generera en registreringsnyckel. Du måste kopiera nyckeln till Gateway för dataflytt-inställningarna i Administration (i steg tre nedan). Nyckeln används för att upprätta en autentiserad koppling mellan Gateway för dataflytt och Qlik Cloud-klientorganisationen.
-
När hämtningen är klar kopierar du RPM-filen till den Linux-maskin där du vill installera Gateway för dataflytt. Se till att maskinen är bakom din brandvägg och kan kommunicera med dina datakällor och Qlik Cloud.
-
Öppna en kommandotolk och ändra arbetskatalogen till den katalog som innehåller RPM-filen:
Exempel:
/qlik/GatewayRPM/
-
Kör följande kommando för att installera Gateway för dataflytt.
Syntax:
QLIK_CUSTOMER_AGREEMENT_ACCEPT=yes rpm -ivh gateway-rpm
Exempel:
sudo QLIK_CUSTOMER_AGREEMENT_ACCEPT=yes rpm -ivh qlik-data-gateway-data-movement.rpm
Du kan läsa Qlik-kundavtalet här: https://www.qlik.com/us/-/media/files/legal/license-agreements/qlik/qlik-customer-agreement-english.pdf (endast på engelska)
-
När installationen är klar ändrar du arbetskatalogen till:
/opt/qlik/gateway/movement/bin
Kör sedan följande kommandon:
Ställa in Qlik Cloud-klientorganisationen och en proxyserver
Anteckning om informationOm du behöver ansluta till ditt molndatalager eller din lagring via en proxy, se till att relevanta alternativ är aktiverade i inställningarna för mellanlagring:
- Använd proxy för att ansluta till molndatalager
- Använd proxy för att ansluta till lagring
Om inget av dessa alternativ är aktiverat kommer proxykopplingen endast att vara till Qlik Cloud.
För mer information om dessa alternativ, se Mellanlagring av data från datakällor.
Kör följande kommando för att ställa in URL:en för Qlik Cloud-klientorganisationen och, valfritt, URL:en för din proxyserver:
Kommando för att ställa in URL:en för Qlik Cloud-klientorganisationen utan en proxyserver:
Syntax:
./agentctl qcs set_config --tenant_url URL
Exempel:
./agentctl qcs set_config --tenant_url mytenant.us.qlikcloud.com
Kommando för att ställa in URL:en för Qlik Cloud-klientorganisationen och URL:en för proxyservern:
Syntax:
./agentctl qcs set_config --tenant_url your-qlik-cloud-tenant-url --proxy_url https|http://host:port --proxy_username username --proxy_password password
Exempel:
./agentctl qcs set_config --tenant_url mytenant.us.qlikcloud.com --proxy_url https://myproxy:1212 --proxy_username admin --proxy_password f56weqs@
Se även: Hantera Gateway för dataflytt-servern
Ställa in CA-paketet
CA-paketet autentiserar identiteten för Qlik Cloud-klienten och säkerställer därmed en pålitlig koppling.
Vem behöver konfigurera CA-paketet?
CA-paketet behöver bara konfigureras om du är:
- En Qlik Cloud Government-kund
- En kommersiell Qlik Cloud-kund som använder en säkerhetsanordning som fungerar som en proxy, vilken ersätter certifikatinformationen som tas emot från internet med sina egna CA-rotcertifikat
Vilket paket ska jag använda?
Kunder bör antingen använda Qlik CA-paketet eller ta med sitt eget CA-paket, enligt följande:
-
Qlik tillhandahåller CA-paketet: Bör användas av Qlik Cloud Government-kunder med en standardmiljö. En standardmiljö är en miljö som inte har en säkerhetsanordning som fungerar som en proxy, vilken ersätter certifikatinformationen som tas emot från internet med sina egna CA-rotcertifikat.
Anteckning om informationDu kan ändra namn på CA-paketfilen men se till att namnet har ett .pem-tillägg (exempelvis qlikcerts.pem). Kör därefter de kommandon som beskrivs nedan. - Kunder tar med sitt eget CA-paket: Bör användas om kundens miljö använder en säkerhetsanordning som fungerar som en proxy, vilken ersätter certifikatinformationen som tas emot från internet med sina egna CA-rotcertifikat Om dessa certifikat är självsignerade måste du, utöver att köra kommandot som konfigurerar CA -paketet, också köra kommandot för att tillåta CA-paketet. Båda dessa kommandon beskrivs nedan. Detta gäller både för Qlik Cloud Government-kunder och kommersiella Qlik Cloud-kunder.
Kommando för att konfigurera CA-paketet
Kör följande kommando för att konfigurera CA-certifikatpaketet:
Syntax:
./agentctl qcs set_config --ca_bundle_path path-to-ca-bundle-file
Exempel:
./agentctl qcs set_config --ca_bundle_path /etc/ssl/certs/cacerts.pem
Kommando för att tillåta CA-paketet.
Vissa miljöer använder en säkerhetsanordning som fungerar som en proxy, vilken ersätter certifikatinformationen som tas emot från internet med sina egna CA-rotcertifikat. Detta kommando behöver bara köras om säkerhetsanordningen själv använder ett självsignerat certifikat. I ett sådant fall kanske CA-paketet inte är pålitligt om du inte kör följande kommando:
./agentctl qcs set_config --ca_bundle_allow_invalid_certs true
Anteckning om informationOm du inte är säker på om din miljö använder en sådan säkerhetsanordning, kontaktar du din IT-administratör.Generera och visa registreringsnyckeln
Nyckeln används för att upprätta en autentiserad koppling mellan Data Movement gateway och Qlik Cloud-klientorganisationen.
Kör följande kommando för att generera och visa nyckeln:
./agentctl qcs get_registration
Nyckeln visas:
-
Kopiera hela nyckeln som visas i exemplet ovan. Du måste klistra in den i Administration i nästa steg.
Steg tre: Återgå till Administration och registrera Gateway för dataflytt
-
För att komma åt datagateways väljer du Administration från Start-menyn (
) och sedan Datagateways.
Alla befintliga datagateways listas i en tabell som visar grundläggande information om varje gateway.
-
Klicka på Skapa.
Dialogrutan Skapa datagateway öppnas.
-
Ange ett namn för Gateway för dataflytt.
-
Ange valfritt en beskrivning för Gateway för dataflytt.
-
Från rullgardinsmenyn Gatewaytyp väljer du Data Movement.
-
Från rullgardinsmenyn Associerat utrymme väljer du ett utrymme. Se även Överväganden när du associerar datagatewayen med ett utrymme.
-
Klistra in registreringsnyckeln som du genererade tidigare i fältet Nyckel.
-
Klicka på Skapa.
Gateway för dataflytt läggs till aktiverad i listan Datagateways.
Steg fyra: Starta Gateway för dataflytt-tjänsten på Gateway för dataflytt-servern
-
Kör följande kommando:
sudo systemctl start repagent
-
Kontrollera att tjänsten har startat genom att köra följande kommando:
sudo systemctl status repagent
Statusen ska vara enligt följande:
Active: active (running) since <timestamp> ago
Steg fem: Använd Gateway för dataflytt-datakällor i dina dataprojekt
-
För att komma åt datagateways väljer du Administration från Start-menyn (
) och sedan Datagateways.
Alla befintliga datagateways listas i en tabell som visar grundläggande information om varje gateway.
-
Uppdatera din webbläsare för att se till att tabellen Datagateways är uppdaterad.
-
Leta upp din gateway i tabellen Datagateways och verifiera att dess Status är "Ansluten".
När du har verifierat i Administration att Gateway för dataflytt är "Ansluten" kan du använda den för att komma åt dina datakällor och stödda mål.
För mer information, se Konfigurera kopplingar till datakällor och Konfigurera kopplingar till mål.
Arbeta med Gateway för dataflytt
När du arbetar med Qlik Data Gateway – dataflytt bör flödet vara följande:
- Konfigurera Gateway för dataflytt på minst en maskin (beroende på ditt användningsfall) och konfigurera anslutningen till din Qlik Cloud-klientorganisation, enligt beskrivningen ovan.
- Installera den drivrutin som krävs för din datakälla och uppfyll eventuella andra förutsättningar, enligt beskrivningen i Konfigurera kopplingar till datakällor. Drivrutinen kan behöva installeras på en Gateway för dataflytt-server som distribuerats nära din källa, beroende på ditt användningsfall.
- Installera den drivrutin som krävs för din målplattform och uppfyll eventuella andra förutsättningar, enligt beskrivningen i Konfigurera kopplingar till mål. Drivrutinen kan också behöva installeras på en Gateway för dataflytt-server som distribuerats nära ditt mål, beroende på ditt användningsfall.
- Konfigurera kopplingen för din datakälla, enligt beskrivningen i Konfigurera kopplingar till datakällor.
- Konfigurera kopplingen för din målplattform, enligt beskrivningen i Konfigurera kopplingar till mål.
- Skapa ett projekt och kör de nödvändiga uppgifterna, enligt beskrivningen i Skapa ett dataprojekt för en pipeline.
Överväganden när du associerar datagatewayen med ett utrymme
När du associerar Data Movement gateway med ett utrymme (se steg 3 ovan), var medveten om följande:
- Datagateways kan endast skapas i datautrymmen.
- För att skapa en koppling i ett utrymme som använder en datagateway från ett annat utrymme måste du ha rollen Kan konsumera data i datagatewayutrymmet.
-
För att skapa en datagateway måste du vara utrymmesägare eller ha rollen Kan hantera. För användarbaserade prenumerationer behöver du också en Professional-rättighet. För mer information, se Hantera användarrättigheter.
- Datagateways kan endast associeras med ett enda utrymme.