Upgrade action reference

ICC --action Upgrade reference

Name

Upgrade an existing instance:

The --help parameter can show more information about the command:

Synopsis

Options

  • -n|--name "<INSTANCE_NAME...>" - Specifies the name of an existing instance that you want to upgrade (you can enter multiple items separating by white space).
  • -f|--configuration-file "<FILE_PATH>" - Specifies the path of the configuration file used for database connection. For more information about the configuration file, see Database connection configuration JSON schema.
  • -b|--backup-database - Does database backup before upgrading to the new version.
  • --configure-security-settings - allows you to customize security settings for Identify and the new Admin. This parameter is used in conjunction with --identify-security-settings-xml-configuration and --safewhere-admin-security-settings-xml-configuration.
    • The value of the --identify-security-settings-xml-configuration parameter is a <system.webServer> XML block in Base64-encoded format. If you leave it empty, the default value will be used.
    • The value of the --safewhere-admin-security-settings-xml-configuration parameter is a <system.webServer> XML block in Base64-encoded format. If you leave it empty, the default value will be used.
  • -t|--safewhere-admin-idle-timeout - Specifies the number of minutes that an Safewhere Admin instance can remain idle before it shuts down (this setting is used when deploying the Safewhere Admin).
  • -h|--help - Prints out a short help for the command.

Examples

Upgrade an existing instance:

Upgrade an existing instance with custom security settings:

  • For the --identify-security-settings-xml-configuration parameter, you can use the default value, Base64-encode it and replace <BASE64_ENCODED_XML_CONFIGURATION> with the encoded value.
  • For the --safewhere-admin-security-settings-xml-configuration parameter, you can use the default value, Base64-encode it and replace <BASE64_ENCODED_XML_CONFIGURATION> with the encoded value.
  • You can use the tool at https://rcfed.com/Utilities/EncodeHash to do Base64 encoding.

Upgrade multi existing instances: