Upgrade safely
Record the current environment
Section titled “Record the current environment”particledb --versionRecord client package versions, configuration and the data directory. Read the target release’s changes before replacing the binary.
Prepare a recovery path
Section titled “Prepare a recovery path”Use the backup or export process supported by your edition. Verify a restore on a separate instance. Do not assume an older binary can read a directory written by a newer version.
Test the application
Section titled “Test the application”Run representative queries, writes, transactions and error handling. Verify Particles and their dependencies separately. Run schema changes on a test copy before applying them in production.
Roll out
Section titled “Roll out”Stop writes using your application’s maintenance process. Follow the release-specific upgrade procedure, start the new version, check health and sample records, then restore traffic.
If validation fails, use the planned recovery process instead of opening the same directory with an unverified older binary.