How do I migrate my document vaults to a new server?
When migrating document vaults to a new server, use the same version of M-Files on both the old and the new server. If you need to upgrade M-Files in conjunction with the migration, upgrade M-Files on the new server only after the migration is complete and you have verified that the document vaults are functional on the new server.
Migrating document vaults to a new server when using Firebird as the database engine
If your document vaults use Firebird, complete the following steps to migrate the vaults to a new server:
-
Make sure there are no documents checked out on any workstation.
You may create a view that contains all the documents that are currently checked out in the vault by using the Checked out status filter for a view.
For instructions on specifying a view, see Creating a View.
-
Take the vaults offline.
For instructions, see Taking a Vault Offline.
-
Back up the master database and copy the backup file to the new server
computer.
For instructions, see Backing Up the Master Database.
-
Take full backups of your document vaults and copy the backup files to the new
server computer.
The backup files contain file data regardless of whether the file data is stored in the default location, or in a separately specified location, so there is no need to copy the file data separately.
For instructions, see Backing Up a Vault.
-
Install M-Files to the new server computer:
- Open M-Files Admin on the new server computer.
-
Restore the master database.
For instructions, see Restoring the Master Database.
-
Restore the document vaults from the backups using the option Restore
using original identity.
Pay attention to file data locations when restoring the vaults. If in doubt, check the settings on the old M-Files server.
For instructions, see Restoring a Vault.
-
Copy the search indexes from the old server computer to the new one:
- Optional:
Specify notification settings if you wish to enable notifications.
For instructions, see Editing Notification Settings in M-Files Admin.
-
Specify backup jobs and update the backup file locations if necessary.
For instructions, see Scheduled Backup Jobs.
- Stop and disable the M-Files Server service on the old server computer to make sure no users accidentally connect to it in the future.
-
Either:
- If you are using a DNS alias for your M-Files Server,
update the alias to point to the new server computer. This way you do not
have to distribute new vault connection settings to client
computers.or
- Edit the document vault connection settings on the client computers so that they connect to the new server address. For instructions, see Adding a Vault Connection.
- If you are using a DNS alias for your M-Files Server,
update the alias to point to the new server computer. This way you do not
have to distribute new vault connection settings to client
computers.
- Make sure that any external systems that point towards M-Files use either the DNS alias, or the DNS name or IP address of the new M-Files server.
- Disconnect the old server computer.
Migrating document vaults to a new server when using Microsoft SQL Server as the database engine
The instructions assume that Microsoft SQL Server is not changed during the migration. If Microsoft SQL Server is installed on the same computer as M-Files Server and therefore also requires migration, see Migrating the Vault Database from One Microsoft SQL Server to Another for further instructions. It does not matter whether you migrate M-Files Server before migrating the document vaults or the other way around.
If your document vaults use Microsoft SQL Server, complete the following steps to migrate the vaults to a new server:
-
Make sure there are no documents checked out on any workstation.
You may create a view that contains all the documents that are currently checked out in the vault by using the Checked out status filter for a view.
For instructions on specifying a view, see Creating a View.
-
Take the vaults offline.
For instructions, see Taking a Vault Offline.
-
Back up the master database and copy the backup file to the new server
computer.
For instructions, see Backing Up the Master Database.
- In Microsoft SQL Server Management Studio, take full backups of your document vaults as a precaution.
-
If the file data is stored on the file system, complete the following
steps:
-
Attach the document vaults to the new server in M-Files Admin
using the original identities of the vaults.
If the file data is stored on the file system, make sure to specify the correct file data location when attaching the vaults.
For instructions, see Attaching a Vault and Changing the Location of the Vault File Data for Microsoft SQL Server.
-
Copy the search indexes from the old server computer to the new one:
- Optional:
Specify notification settings if you wish to enable notifications.
For instructions, see Editing Notification Settings in M-Files Admin.
-
Specify backup jobs and update the backup file locations if necessary.
For instructions, see Scheduled Backup Jobs.
- Stop and disable the M-Files Server service on the old server computer to make sure no users accidentally connect to it in the future.
-
Either:
- If you are using a DNS alias for your M-Files Server,
update the alias to point to the new server computer. This way you do not
have to distribute new vault connection settings to client
computers.or
- Edit the document vault connection settings on the client computers so that they connect to the new server address. For instructions, see Adding a Vault Connection.
- If you are using a DNS alias for your M-Files Server,
update the alias to point to the new server computer. This way you do not
have to distribute new vault connection settings to client
computers.
- Make sure that any external systems that point towards M-Files use either the DNS alias, or the DNS name or IP address of the new M-Files server.
- Disconnect the old server computer.
Additional configuration required for the classic M-Files Web
If M-Files Web is installed on the M-Files application server, you need to install Internet Information Services and M-Files Web on the new server computer after installing M-Files Server on the new server computer.
If M-Files Web is installed on a separate proxy server instead, the following steps must be completed.
- If you upgrade M-Files Server after migrating to a new server computer, upgrade the M-Files Web proxy server to the same M-Files version as the one you installed on the new application server.
-
In the Microsoft Windows registry of the M-Files Web proxy computer, update the following setting to
point to the new M-Files application server:
Key HKEY_LOCAL_MACHINE\SOFTWARE\Motive\M-Files\<version>\Server\MFWA Value name Server Value type REG_SZ Value The DNS name of the M-Files application server.
Additional configuration required if you use RPC over HTTPS
On the RPC proxy computer, update the HOSTS file so that the server hostname (the one that clients use for connecting to the M-Files server) points to the IP address of the new M-Files application server.
For further information, see the document Enabling RPC over HTTPS Connections to M-Files Server.