Skip to content

System Maintenance

This guide covers essential maintenance tasks to keep your AI Controller (AIC) deployment running smoothly. Regular maintenance helps prevent issues and extends the life of your installation.

Maintenance Overview

Proper system maintenance ensures reliable operation and includes regular updates, regular backup verification, and basic system health monitoring. This document focuses on practical guidance that's specific to AI Controller rather than general database maintenance.

Update Process

Keeping AI Controller and its components current is essential for security and performance. Follow these steps to safely update your AI Controller installation:

  1. Download the latest updates by calling <AIC install directory>/bin/AIC --download_update
  2. Backup the existing AI Controller database and the server.cfg file used
  3. Stop the AI Controller service, if appropriate
  4. Rename the existing AI Controller installation directory
  5. Extract the newly downloaded update archive into the directory previously occupied by the old AI Controller installation
  6. Replace the <AIC install directory>/configuration/server.cfg with the backup created in step 2
  7. Run the MigrationsRunner utility to update the database schema:

<AIC install directory>/bin/MigrationsRunner --env=prod
* This step alters the database. If errors are seen in the console, these will need to be closely analyzed and the database inspected to see which updates have been made, and which not.

  1. Restart the AI Controller service, if appropriate, or restart AI Controller by calling <AIC install directory>/bin/AIC

  2. Verify AI Controller is working correctly:

    • Log in to the web frontend
    • Check the version displayed in the bottom left is the version updated to
    • Check the various pages show the expected data for your AI Controller instance
    • Check that applications can use AI Controller in the same way they did prior to the update

  3. Remove the old AI Controller install directory that was renamed in step 4

Administrators will see update notifications when logged into AIC. You can also monitor the news page for announcements.

Database Maintenance

For detailed information about database maintenance and optimization for MySQL, refer to the official MySQL documentation at: - MySQL Maintenance and Tuning

Regular database backups are crucial before updates and as part of routine maintenance. Ensure you have a backup strategy in place for your AI Controller database.

Basic Health Monitoring

Monitor the following to ensure AI Controller is running effectively:

  1. Service Status: Verify the AI Controller service is running properly
  2. Log Files: Check for unexpected errors in the AI Controller logs
  3. Disk Space: Ensure sufficient storage remains for logs and database growth
  4. Memory Usage: Monitor for unexpected increases in memory consumption

For detailed monitoring solutions, you may want to implement standard system monitoring tools appropriate for your environment.

Updated: 2025-05-16