This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
how_to:v5_-_move_to_a_new_pc [2013/04/16 10:25] – [Restore the Database Backup] paul | how_to:v5_-_move_to_a_new_pc [2024/09/02 08:35] (current) – [Copy the VPOP3 directory tree] paul | ||
---|---|---|---|
Line 5: | Line 5: | ||
- Stop VPOP3 on the original PC | - Stop VPOP3 on the original PC | ||
- Manually make a backup of the database on the original PC | - Manually make a backup of the database on the original PC | ||
- | - Copy the VPOP3 directory tree from the original PC to the new PC **except for the VPOP3\pgsql directory** | + | - Copy the VPOP3 directory tree from the original PC to the new PC **except for the VPOP3\pgsql directory** |
- Install VPOP3 on the new PC, **but do not start VPOP3 yet** | - Install VPOP3 on the new PC, **but do not start VPOP3 yet** | ||
- Restore the database backup (from step 2) on the new PC | - Restore the database backup (from step 2) on the new PC | ||
Line 14: | Line 14: | ||
Please make sure you follow these instructions in the correct order. Many problems with moving installations are because people have thought we have got it wrong, and so do things in a different (incorrect) order. | Please make sure you follow these instructions in the correct order. Many problems with moving installations are because people have thought we have got it wrong, and so do things in a different (incorrect) order. | ||
- | If you want, we can do this move for you via remote access. The charge for us to do that is currently [[http:// | + | If you want, we can do this move for you via remote access. The charge for us to do that is currently [[https:// |
You can follow most of these steps if VPOP3 was on a PC that died, and you are moving it to a replacement PC. However, this is less ideal than [[restore_a_backup_of_vpop3|restoring from the latest daily backup]] you made. If you were not previously backing up VPOP3, this may be a [[http:// | You can follow most of these steps if VPOP3 was on a PC that died, and you are moving it to a replacement PC. However, this is less ideal than [[restore_a_backup_of_vpop3|restoring from the latest daily backup]] you made. If you were not previously backing up VPOP3, this may be a [[http:// | ||
Line 22: | Line 22: | ||
=====Backup the database===== | =====Backup the database===== | ||
To backup the database, go to a command prompt on the VPOP3 computer, and go to the VPOP3 directory. Then run | To backup the database, go to a command prompt on the VPOP3 computer, and go to the VPOP3 directory. Then run | ||
- | pgsql\bin\pg_dump -F c -p 5433 -U vpop3 -f database.dmp | + | pgsql\bin\pg_dump -F c -p 5433 -v -U vpop3 -f database.dmp |
//Note: the above line (and all subsequent database command lines on this page) assume port 5433 is being used. This will work in the majority of cases, but in certain circumstances, | //Note: the above line (and all subsequent database command lines on this page) assume port 5433 is being used. This will work in the majority of cases, but in certain circumstances, | ||
At the password prompt, type **vpop3pass** | At the password prompt, type **vpop3pass** | ||
- | (This assumes a standard installation, | + | (This assumes a standard installation, |
This will create a file ' | This will create a file ' | ||
Line 34: | Line 34: | ||
How you do this depends on your network setup. | How you do this depends on your network setup. | ||
- | The easiest way to copy it all except for the VPOP3\pgsql directory is often to copy everything, then delete the VPOP3\pgsql from the **new PC** after the copy has finished | + | The easiest way to copy it all except for the VPOP3\pgsql directory is often to copy everything, then delete the VPOP3\pgsql from the **new PC** after the copy has finished. |
+ | |||
+ | Also, do not copy any other ' | ||
Note that if you are moving to Windows Vista/ | Note that if you are moving to Windows Vista/ | ||
Line 41: | Line 43: | ||
Install VPOP3 on the new PC as normal, but: | Install VPOP3 on the new PC as normal, but: | ||
* Make sure you install into the same directory that you copied the VPOP3 directory tree to, so if you copied it to D:\VPOP3, make sure you install to D:\VPOP3. Most problems with moving VPOP3 are because this step is not followed correctly. | * Make sure you install into the same directory that you copied the VPOP3 directory tree to, so if you copied it to D:\VPOP3, make sure you install to D:\VPOP3. Most problems with moving VPOP3 are because this step is not followed correctly. | ||
- | * If the installer asks you to enter your licence key, you do not need to do so, as the licence key will be recovered when you restore the database later in the process. However, make sure you choose the correct edition of VPOP3 - VPOP3 Basic or VPOP3 Enterprise | + | * If the installer asks you to enter your licence key, you should enter it here. If you do not enter it, make sure you choose the correct edition of VPOP3 - VPOP3 Basic or VPOP3 Enterprise |
* During the component selection stage of the installation, | * During the component selection stage of the installation, | ||
* At the end of the install, make sure you **uncheck** the **Start VPOP3** option, so that VPOP3 does not run | * At the end of the install, make sure you **uncheck** the **Start VPOP3** option, so that VPOP3 does not run | ||
+ | * If you are wanting to install a later version of VPOP3 as well as moving VPOP3, then at this step you would install the later version rather than the original version. | ||
=====Restore the Database Backup===== | =====Restore the Database Backup===== | ||
- | On the new PC, open up a command prompt and go to the VPOP3 directory. Then run | + | First, **delete the DBCHANGES.DAT file** from the VPOP3 directory (if it exists). This contains settings changes wanted by the installer, but they will overwrite the restored data, so you do not want them to take effect in this scenario. |
+ | |||
+ | Then, on the new PC, open up a command prompt and go to the VPOP3 directory. Then run | ||
pgsql\bin\pg_restore -p 5433 -U postgres -C -v -d postgres database.dmp | pgsql\bin\pg_restore -p 5433 -U postgres -C -v -d postgres database.dmp | ||
Line 67: | Line 71: | ||
In this case, you will need to create the VPOP3 database again during the restore: | In this case, you will need to create the VPOP3 database again during the restore: | ||
- | pgsql\bin\pg_restore -p 5433 -U postgres -C -d postgres database.dmp | + | pgsql\bin\pg_restore -p 5433 -U postgres -C -v -d postgres database.dmp |
- | + | ||
- | (note the change from the normal restore procedure from '' | + | |
At the command prompt, enter '' | At the command prompt, enter '' | ||
+ | |||
+ | ====Moving installation directory==== | ||
+ | If you are installing VPOP3 in a different directory on the new PC than it was on the old PC, you need to change some settings. | ||
+ | |||
+ | This needs a little utility. You can download it from http:// | ||
+ | |||
+ | At a command prompt, find the VPOP3 installation directory and run | ||
+ | vpop3settings replacepaths <old path> <new path> | ||
+ | | ||
+ | e.g. Run | ||
+ | vpop3settings replacepaths c:\vpop3 d:\vpop3 | ||
+ | | ||
+ | The utility will display all the settings which used the old location and ask if you want to change them to the new location. Check the settings, and press ' | ||