Additional commands for core services installation

The following PowerShell commands are provided for reference and may be helpful while installing or uninstalling IMS core services:

  • IgnorePreValidation. Append this parameter to the command to skip the installation pre-validation check. By default, this checks for the required .NET Core version (installed or not), file path access, AMM port accessibility, Kafka port accessibility, DB port accessibility, and DMS port accessibility. For example:

    .\Deploy-CoreServices.ps1 -CoreJsonConfigFilePath .\IMS_Core_Config.json -ServiceAccountPwd xxxx -AMMPwd xxxx -JMSPwd xxxx -DBPwd xxxx -SOAPPwd xxxx -DMSPwd xxxx -MessageBrokerPwd xxxx -BasicTransportPwd xxxx -IgnorePreValidation

    Skipping this check is not recommended.

    Note: The pre-check validation will determine whether or not all required software is installed on the server. The validation includes verification of the following components: .Net Core 6.0, the JSON configuration file, and connectivity to the AMM, Kafka, DB, and IEE endpoints. The check is based on the services listed in the JSON configuration file.

  • IgnoreAutoStart. Append this parameter to the command to skip the automatic service start after installation. By default, the services start after installation. For example:

    .\Deploy-CoreServices.ps1 -CoreJsonConfigFilePath .\IMS_Core_Config.json -ServiceAccountPwd xxxx -AMMPwd xxxx -JMSPwd xxxx -DBPwd xxxx -SOAPPwd xxxx -DMSPwd xxxx -MessageBrokerPwd xxxx -BasicTransportPwd xxxx -IgnoreAutoStart

    Disabling the automatic service start is not recommended.

  • IgnoreServiceAccount. Append this parameter to the command to run the service under the system account user instead of the default service account user (Service Account). For example:

    .\Deploy-CoreServices.ps1 -CoreJsonConfigFilePath .\IMS_Core_Config.json -ServiceAccountPwd xxxx -AMMPwd xxxx -JMSPwd xxxx -DBPwd xxxx -SOAPPwd xxxx -DMSPwd xxxx -MessageBrokerPwd xxxx -BasicTransportPwd xxxx -IgnoreServiceAccount

    Running a service with the System Account is not recommended.

  • IgnoreConfigurationCopy. Append this parameter to the command to skip copying the configuration file from the installation package. This is useful when no change is required in the configuration file during a service upgrade. For example:

    .\Deploy-CoreServices.ps1 -CoreJsonConfigFilePath .\IMS_Core_Config.json -ServiceAccountPwd xxxx -AMMPwd xxxx -JMSPwd xxxx -DBPwd xxxx -SOAPPwd xxxx -DMSPwd xxxx -MessageBrokerPwd xxxx -BasicTransportPwd xxxx -IgnoreConfigurationCopy

    This is applicable to IMS core services deployments only (see also Core services JSON configuration file).

  • Uninstall. Append this parameter to the command to uninstall a service. For example:

    .\Deploy-CoreServices.ps1 -CoreJsonConfigFilePath .\IMS_Core_Config.json -ServiceAccountPwd xxxx -AMMPwd xxxx -JMSPwd xxxx -DBPwd xxxx -SOAPPwd xxxx -DMSPwd xxxx -MessageBrokerPwd xxxx -BasicTransportPwd xxxx -Uninstall

    See also Uninstalling core services.