How to manually update the keytab file for Insights MSI ?
Issue Description: How to manually update the keytab file for Insights MSI? This article can also be used to set a custom crypto key for the keytab file.
Resolution:
The password should be changed via the installer but there may be some scenarios where this needs to be done manually.
Steps: These steps apply to the MSI version of Insights,
- Generate the key tab file
- Login to a windows machine
- Run the following command: ktpass /out <outputfile>/WINDOWS_AUTH_AD_KEYTAB /princ <serviceAccount>@<domain> /pass * /crypto all /ptype KRB5_NT_PRINCIPAL -setpass
- This will generate a file called WINDOWS_AUTH_AD_KEYTAB. This is the keytab file.
- Tansfer the keytab file to the looker machine. For 22.4+ This is a linux machine. For 21.10, it is the Windows machine that hosts Insights
- Locate the configuration directory for Insights
- For 21.10, its located at %userprofile%\_insights
- For 22.4+ its the directory where the installation was done.
- Backup up the old keytab file. This will be named WINDOWS_AUTH_AD_KEYTAB. Name the backup as required
- Transfer the new WINDOWS_AUTH_AD_KEYTAB to the configuration directory
- With the file in place, re-initalize the kerberose configuration:
- For 21.10
- Open an powershel console as admin.
- Run:
- docker exec -it looker-container /app/looker-init-job/scripts/configure-kerberos.sh
- For 22.4+
- Run: sudo docker exec -it looker-container /app/looker-init-job/scripts/configure-kerberos.sh
- For 21.10