~~NOTOC~~
====== Upgrade MongoDB ======
MongoDB can be directly installed over the top of an existing version, only if the major version is equal. This means for example a database running MongoDB 8.1.0 can be directly updated to MongoDB version 8.2.11 or 8.2.12 or even 8.3.11 if supported. When the major version does not match then the following procedure must be performed, this is a limitation of MongoDB.

For this entire process the DV2000 VMS cannot be running and must be shutdown. During this procedure, no messages, wakeup calls, reports, or configuration will be lost.

<WRAP center round important 100%>
**Installing the wrong version of MongoDB may result in data loss**.
</WRAP>

===== Requirements =====
  * CPU supports AVX (Advanced Vector Extensions).
  * MongoDB install from the downloads section under Database, located [[download:home|here]].

===== Procedure =====
This procedure typically takes less than three minutes when all installs are downloaded before starting.

==== Shutdown ====
  - Shutdown the DV2000.
  - Close all applications.

==== Backup ====
This step **must** be performed otherwise data loss will occcur.

  - Open a Administrator enabled console window. All commands listed below must be run from this window.
  - Backup database using the following command. 

  mongodump -h "127.0.0.1" -d bandon -o "c:\vs\database"

==== Uninstall Database ====
**Do not uninstall any DV2000 applications other than MongoDB or data loss will occur.** 

  * Uninstall MongoDB.
  * Ensure the checkbox to remove all databases is checked.

==== Install ====
  * Install newer [[download:home|MongoDB]] version.

==== Upgrade ====
This procedure will ensure the database is properly upgraded to the version just installed.

  * Upgrade the database using the following command.

  mongod.exe --upgrade

===== Completion =====

==== On Success ====
Verify the configuration using Manager.

  * Start Manager.
  * Verify the mailboxes and other configuration.
  * Start DV2000.

==== On Failure ====
If this process fails at any time following the backup procedure, install the original database version and start off with the Restore step listed above.