AST Migration Guide¶

Overview¶

This guide provides step-by-step instructions for the migration of ast_defaults.yml and ast_receivers.yml files on the AST box. Follow the steps below for preparation, execution, and verification.

Create the configuration files ast_defaults.yml and ast_receivers.yml on the AST box. These files should either be created or existing ones reused.
Ensure that the CA certificate files referenced in both ast_defaults.yml and ast_receivers.yml exist at the specified paths.
Copy the migration script (ast_migration.sh) from the F5Insights box to the AST box. Use the following scp command for this:
```
scp <user>@<f5insights_box>:/opt/f5insights/ast_migration.sh <user>@<ast_box>:/path/to/config/
```
Run the migration script on the AST box. You can run the script in one of the following modes:

In-place mode (creates backups of original files):
```
./ast_migration.sh -i /path/to/config
```
Output to a specific directory:
```
./ast_migration.sh -i /path/to/config -o /path/to/output
```
Manually update any password fields in the YAML files to ensure correctness and security.
Verify the generated or updated YAML files (ast_defaults.yml and ast_receivers.yml) to ensure correctness.
Upload the generated files in the F5Insights UI to trigger the migration.

Notes¶

Ensure all file paths referenced in the YAML files and the migration script are accurate.
Create backup copies of all critical files before executing the migration script.
Verify that the referenced CA certificates match the specifications in the YAML files.
Ensure the F5Insights UI is properly configured to accept and validate the uploaded files.