Skip to main content

Upgrade Guide

This guide covers upgrading Anava components including the cloud platform, camera ACAP, and web installer.

Upgrade Overview​

Components​

Anava has three main components that may need updates:

ComponentLocationUpdate Method
Cloud PlatformAnava cloudAutomatic
ACAPEach cameraWeb installer or manual
Web InstallerBrowser-basedSelf-updating

Upgrade Path​

Upgrade Path

Checking Versions​

Current Versions​

Find current versions:

ComponentWhere to Check
CloudSettings → About
ACAPCamera web UI → Apps → AnavaAgent
InstallerInstaller page header

Available Versions​

Check for updates:

  1. Release notes page: anava.ai/releases
  2. Console notification: Banner when update available
  3. Email notification: For critical updates

ACAP Updates​

Via Web Installer​

The recommended method for updating ACAPs:

  1. Navigate to web installer
  2. Select cameras to update
  3. Click Update Firmware/Apps
  4. Select new ACAP version
  5. Deploy

Bulk ACAP Update​

For many cameras:

Bulk ACAP Update

Manual ACAP Update​

For individual cameras:

  1. Download ACAP from releases page
  2. Access camera web interface
  3. Go to Apps → Add app
  4. Upload .eap file
  5. Enable app

ACAP Update Considerations​

FactorConsideration
Downtime~30-60 seconds per camera during restart
ConfigurationSettings are preserved
Batch sizeUpdate 10-20 cameras at a time
TimingSchedule during low-activity periods

Cloud Platform Updates​

Automatic Updates​

The cloud platform updates automatically:

  • No action required
  • Zero downtime for most updates
  • Notification of major changes

What Updates Include​

Update TypeContents
FeatureNew capabilities
EnhancementImproved functionality
SecurityVulnerability patches
AI ModelAnalysis improvements

Update Timing​

Update TypeNoticeTiming
Security (critical)NoneImmediate
Security (standard)24 hoursWithin week
Feature1 weekScheduled
Major version2 weeksCoordinated

Pre-Update Checklist​

Before Any Update​

  • Review release notes
  • Check compatibility requirements
  • Export current configuration
  • Identify rollback procedure
  • Schedule maintenance window
  • Notify stakeholders

For ACAP Updates​

  • Verify camera connectivity
  • Check disk space on cameras
  • Test update on pilot camera first
  • Plan batch groups

For Major Updates​

  • Review breaking changes
  • Test in staging (if available)
  • Prepare rollback plan
  • Schedule extended window
  • Arrange technical support

Update Procedures​

ACAP Update Procedure​

Step 1: Preparation

1. Identify cameras to update
2. Group by location/function
3. Create update schedule
4. Export current configuration

Step 2: Pilot Test

1. Select 1-2 pilot cameras
2. Apply update
3. Verify operation:
   - Camera connects to cloud
   - Triggers fire correctly
   - Detections occurring
   - No error logs
4. Wait 24 hours if possible

Step 3: Phased Rollout

Batch 1: 10% of cameras
├── Update
├── Verify
├── Wait 1 hour

Batch 2: 25% of cameras
├── Update
├── Verify
├── Wait 1 hour

Batch 3: Remaining cameras
├── Update
├── Verify
└── Complete

Step 4: Verification

For each camera:
✓ Online in console
✓ Profiles active
✓ Test detection works
✓ No error logs

Configuration Migration​

When updates require configuration changes:

  1. Automatic migration: Most updates migrate automatically
  2. Manual migration: Rare, documented in release notes
  3. Migration failures: Logged, rollback available

Rollback Procedures​

ACAP Rollback​

If issues occur after ACAP update:

  1. Via Web Installer

    • Select affected cameras
    • Choose previous ACAP version
    • Deploy

  2. Manual Rollback

    • Download previous ACAP version
    • Upload to camera manually
    • Enable previous version

Configuration Rollback​

If configuration is corrupted:

  1. Access configuration backup
  2. Import previous configuration
  3. Reassign cameras to groups
  4. Verify profiles active

Emergency Rollback​

For critical issues:

  1. Disable affected profiles

    • Stops problematic detections immediately
    • Cameras continue other functions

  2. Contact support

    • Priority response for production issues
    • Remote assistance available

Update Scheduling​

EnvironmentRecommended Window
Critical 24/72-5 AM local time
Business hours6-8 AM or weekend
DevelopmentAnytime

Coordination​

For multi-site deployments:

Update Schedule:
├── Site A: Monday 3 AM PST
├── Site B: Monday 6 AM EST
├── Site C: Tuesday 3 AM PST
└── Site D: Tuesday 6 AM EST

Freeze Periods​

Consider avoiding updates during:

  • Major events
  • Holiday periods
  • Critical business operations
  • Other planned maintenance

Post-Update Verification​

Immediate Checks​

Within 1 hour of update:

CheckHow
Cameras onlineDevice status page
Profiles activeProfile list
Detections occurringSessions view
No errorsLog review

24-Hour Checks​

After 24 hours:

CheckHow
False positive rateCompare to baseline
True positive rateReview verified events
System performanceDashboard metrics
User feedbackCheck with operators

Verification Checklist​

Post-Update Verification:
□ All cameras showing online
□ ACAP versions match expected
□ Profiles correctly active/inactive
□ Test trigger produces detection
□ ONVIF events reaching VMS
□ TTS announcements working
□ Push notifications delivered
□ No unusual error logs
□ Performance within normal range
□ User access working

Version Compatibility​

Compatibility Matrix​

ACAP VersionCloud VersionNotes
3.x2024.1+Current
2.x2023.6-2024.2Maintenance mode
1.x2023.1-2023.6End of life

Breaking Changes​

Breaking changes are documented with:

  • Clear identification in release notes
  • Migration guide
  • Extended support timeline
  • Rollback procedures

Troubleshooting Updates​

Update Fails to Deploy​

  1. Check connectivity

    • Camera reachable?
    • Installer can access camera?

  2. Check space

    • Sufficient storage on camera?

  3. Check compatibility

    • Camera firmware supported?
    • Previous ACAP version compatible?

Camera Offline After Update​

  1. Wait 2-3 minutes

    • Update may still be completing

  2. Check camera directly

    • Access web interface
    • Verify ACAP is running

  3. Restart ACAP

    • Stop and start AnavaAgent

  4. Rollback if needed

    • Deploy previous version

Configuration Lost After Update​

  1. Check cloud configuration

    • Configuration stored in cloud
    • Should sync on reconnect

  2. Re-add camera to group

    • Remove and re-add if needed

  3. Restore from backup

    • Import saved configuration