Getting Started - Reconfigure an existing instance
Given that you want reconfigure the identifycli
instance, you can save this database connection configuration file to a database_connection.json file and run the following commands on your favorite terminal:
- To change an existing user's password
1 |
ICC --action Reconfigure --name "identifycli" --change-user-password --username "admin" --password "OhCQd0GRD72LjMUw2pIh" --configuration-file "C:\identify-configuration\database_connection.json" |
- To change the instance's signing certificate using a certificate from the server's Windows Certificate store (Local Machine\Personal)
1 |
ICC --action Reconfigure --name "identifycli" --change-signing-certificate --thumbprint "3C1FD735A4035E3B78D33444DE5327C393AA282E" --configuration-file "C:\identify-configuration\database_connection.json" |
- To change the instance's signing certificate using a certificate from Azure Key Vault that uses the Certificate mode for the Key vault mode setting:
1 |
ICC --action Reconfigure --name "identifycli" --change-signing-certificate --use-azure-key-vault --key-vault-mode "Certificate" --azure-tenant-id "ea8f8esp-0476-50ca-88fd-l40cx0a1e345" --application-client-id "694c7ezx-2e2a-4d29-925q-0d84agg610a4" --application-client-secret "5I~T1n85a=FLQoTeax?Z=Rp3U[I5sB:." --azure-key-vault-url "https://safewherekeyvault.vault.azure.net/" --certificate-name "IdentifySigningCertificate" --configuration-file "C:\identify-configuration\database_connection.json" |
- To change the instance's signing certificate using a certificate from Azure Key Vault that uses the Key mode for the Key vault mode setting
1 |
ICC --action Reconfigure --name "identifycli" --change-signing-certificate --use-azure-key-vault --key-vault-mode "Key" --azure-tenant-id "ea8f8esp-0476-50ca-88fd-l40cx0a1e345" --application-client-id "694c7ezx-2e2a-4d29-925q-0d84agg610a4" --application-client-secret "5I~T1n85a=FLQoTeax?Z=Rp3U[I5sB:." --azure-key-vault-url "https://safewherekeyvault.vault.azure.net/" --key-name "IdentifySigningCertificate" --base64-encoded-certificate "<BASE64_ENCODED_CERTIFICATE>" --configuration-file "C:\identify-configuration\database_connection.json" |
- To deploy the Safewhere Admin
1 |
ICC --action Reconfigure --name "identifycli" --deploy-safewhere-admin --configuration-file "C:\identify-configuration\database_connection.json" |
- To enable multi-subnet failover
1 |
ICC --action Reconfigure --name "identifycli" --enable-multi-subnet-failover --configuration-file "C:\identify-configuration\database_connection.json" |
_Note: The identifycli
instance must exist on the database server which you configured in the databaseconnection.json file.
References
- Reconfigure command.
- The
--configuration-file
parameter uses Database configuration JSON schema to connect to database.