Updating a Digital Event Persistence Service Using Composite Templates
You can update a
Digital Event Persistence service with the same template you use to create the service. For more information about how to create a
Digital Event Persistence service with composite templates, see
Creating a
Digital Event Persistence
Service Using Composite Templates.
Before updating a Digital Event Persistence service, see the "Updating a Provisioned Environment Using the Same Composite Template" section in Software AG Command Central Help.
Update the Digital Event Persistence Service Details
Make the necessary changes to the configuration section of the same template you use to create Digital Event Persistence services. Use a local copy instead of modifying the template in Software AG_directory \profiles\CCE\data\templates\composite.
Import the Updated Template
When you import an updated template you should use the overwrite={true | false} argument to specify whether you want to create a new version of the original template or whether you want to replace it. Use the following command to update the composite template from the example:
sagcc exec templates composite import -i evp-configuration.yaml overwrite=true
Retrieve Encrypted Password
Before applying the template again, you can obtain the encrypted password for the Apache Hadoop 5.3.0 server, and replace the clear text password in the template definition. This step is optional.
To retrieve the password you use in the composite template example, use the following command:
cc get configuration data local OSGI-IS_default-DigitalEventServices LocalPersistence -f json
When you are using a custom properties file to store the value of the hiveServerPassword parameter, you must replace the original value with the updated encrypted password.
Applying the Updated Composite Template
You can apply the updated composite template with the following command:
sagcc exec templates composite apply evp-configuration
If you have not specified a value for hiveServerPassword in the template definition run the command as follows:
With an input argument:
sagcc exec templates composite apply evp-configuration my.password=my.secret
where my.secret is the password of the Apache Hadoop Server user.
With an input properties file:
sagcc exec templates composite apply -i evp-configuration sample.properties
where sample.properties is the name of the custom properties file that contains the value for hiveServerPassword.
Verifying the Template Execution
Verify that the template execution is successful in the following ways:
Check the
Jobs view in the Command Central web user interface while applying the template.
After applying the template, check in
Command Central if the service is updated with the correct configuration settings in
Environments > Instances > All > local-is > Digital Event Services > Configuration > Event Persistence.