Installer directives¶
The installer behavior can be changed with installer directives.
parameter | Purpose | Example |
---|---|---|
action | The installer can run in different action modes see Installer Actions | --set action=install (this is default) |
logLevel | The installer will log at different levels:
|
--set logLevel=FINEST |
--debug | This will enable debugging in the middle tier installer (Helm) | --debug |
--dry-run | This will parse and do values replacement in all k8s deployment files, but will not deploy them to the k8s cluster, just spool the result to stdout. This setting can be used in combination with --debug to get detailed logging in Helm. | --dry-run |
breakOnDBError | This parameter should only be used in pipelines, where rollback is possible. When set to true, the installer will stop on db deploy errors and not continue with import of data and middle tier installation. Default behavior is that db deploy errors only result in warnings. | --set breakOnDBError=true |
raiseNewCustomObjectInvalids | If parameter set to false, customer configuration invalids will not be raised as errors in _ERROR_install.log, but will still be listed in the _installtem.log. Configuration Items invalids | defaults to true --set raiseNewCustomObjectInvalids=false |
deliveryValidationEnabled | Deliveries created by the LE build process will contain a file named deliveryid.txt in the database folder. The file contain information about the delivery id as well as which delivery this actual delivery is based on. When executing the installation connection to the database will be performed and latest registered delivery will be matched against the information about which delivery actual delivery is based on. If not in sequence, error message will be shown and installation will stop. By adding parameter deliveryValidationEnabled as false, the validation will be skipped. If the installation to install is a merged delivery, all deliveryid.txt files has been merged into one file and the same validation as above will be performed against first delivery in chain. Additionally there will be a check that second delivery in chain must be based on the first delivery, the third delivery must be based on the second delivery, and so on. |
defaults to true --set deliveryValidationEnabled=false |
skipDryRun | This will skip the initial default dry-run | defaults to false --set skipDryRun=true |
dbInstaller.extLogging | Will generate verbose logging of DB deployment. | defaults to N --set dbInstaller.extLogging=Y |
logFileLocation | Path to where all logs will be placed The logFileLocation will be set to ../../../logs/ifscloudinstaller if that path exist. (Remote deployment option) |
defaults to %TEMP%/ifsinstaller_<namespace> --set logFileLocation=c:\logs |
--kubeconfig | path to the kubectl config file | --kubeconfig c:\ifs\config\config |
--context | a context in the kubectl file | --context mycluster |
--use-existing-helm-values | The installation will be carried out using the values that are already in the environment. The only action permitted is mtinstaller. The installation will deploy the charts pointed to by the charts location, but for some application containers which are not backward compatible across Service Updates (Maintenix container) specific image versions will be set. You can still override the values by supplying them using --set or supplying a values file. If nothing is supplied the installation will be carried out using the same set of values that is in the environment. Use --namespace to indicate the namespace against which the installation should be conducted. If this is not supplied default namespace will be used | --use-existing-helm-values --set action=mtinstaller --namespace xxx |