Skip to main content
Version: v4.9

Upgrade Procedures

If you have an existing sidecar running on v4.7, use the instructions on this page to successfully upgrade it to v4.9. If your sidecar is running on a previous version than v4.7, follow the v4.7 upgrade procedures before executing these instructions.

CloudFormation

In order to upgrade an existing sidecar, re-download its template from the control plane and select the desired log integration. The template can be re-downloaded by selecting an existing sidecar, clicking Actions (top right corner), selecting Update and finally clicking Generate. Make sure the correct log integration is selected before clicking Generate.

Added template parameters

Similarly to our Terraform AWS EC2 module, the CloudFormation sidecar template now supports the injection of custom user instructions to shape the behaviour of the instance initialization. The new variables are:

  • CustomUserDataPre: allows the injection of Bash script commands to be executed before the sidecar installation.
  • CustomUserDataPreSidecarStart: allows the injection of Bash script commands to be executed before the sidecar starts.
  • CustomUserDataPost: allows the injection of Bash script commands to be executed after the sidecar starts.
  • MetadataHttpTokensOption: allows you to control the requirement of a token for the IMDS, defaulting to required.

Removed template variables

Since v4.8 the sidecar is deployed with support to all available repositories. For this reason, variables Enable*Support were removed from the CloudFormation template.