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.

1. 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.
2. Ensure that the CA certificate files referenced in both ast_defaults.yml and ast_receivers.yml exist at the specified paths.
3. 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/

4. Run the migration script on the AST box. You can run the script in one of the following modes:

   • In-place (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
   

5. Manually update any password fields in the YAML files to ensure correctness and security.

6. Verify the generated or updated YAML files (ast_defaults.yml and ast_receivers.yml) to ensure correctness.

7. 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.