Difference between revisions of "Migrating an iPortalDoc from IPBRICK 5.x to 6.1"

Latest revision as of 15:35, 29 September 2017

***PAGE ON CONSTRUCTION***

NOTE: This procedure is also valid for upgrades from IPBRICK v5.x to v6.1 or greater.

This next procedure will explain how to update an IPBrick version 5.x with iPortalDoc to an IPBrick version 6.1 with iPortalDoc. After this migration, iPortalDoc will be in version 4.2.1 running on top of IPBrick version 6.1. After this procedure is fully completed, you can update iPortalDoc to its newer version.

Before Migrating:

Check iPortalDoc's version: iPortalDoc needs to be at least in version 4.2.1 (or greater) before the migration to an IPBrick version 6.1 or greater.

In this procedure, we will assume three possible scenarios in IPBrick version 5.3:

Scenario A - iPortalDoc is installed with version 4.0.1

• IPD-400000 | iPortalDoc v4.0
• IPD-400001 | iPortalDoc v4.0.u1

Scenario B - iPortalDoc is installed with version 4.2.1

• IPD-420000 | iPortalDoc v4.2
• IPD-420001 | iPortalDoc v4.2.u1

Scenario C - UCoIP is installed with version 3.0

• IPD-400000 | iPortalDoc v4.0
• BIL-200000 | ipbrick-billing - Billing Software v2.0.
• UFI-300000 | ucoip4iportaldoc - UCoIP for iPortalDoc

Scenarios A and B

If iPortalDoc is installed with version 4.0.1 (Scenario A) start by installing the necessary updates until it reaches version 4.2.1.

• Install:

1. iPortalDoc version 4.0 update 2: iportaldoc-v4_0-2.deb
2. iPortalDoc version 4.0 update 3: iportaldoc-v4_0-3.deb
3. iPortalDoc version 4.0 update 4: iportaldoc-v4_0-4.deb
4. iPortalDoc version 4.0 update 5: iportaldoc-v4_0-5.deb
   • Apply configurations
5. iPortalDoc version 4.2: iportaldoc-v4_2.deb
   • Apply configurations
6. iPortalDoc version 4.2 update 1: iportaldoc-v4_2-1.deb (available here: [1])
   • Apply configurations

If your iPortalDoc is already in version 4.2.1 (Scenario B), or if you have just updated it to this version (Scenario A), you can continue from this point on, without having to install any more updates.

• Check IP Contacts version: It needs to be at least in version 4.9 before the migration to an IPBrick version 6.1 (please find the download link on the bottom of this page).

Note: If Contacts is already in version 5.0.1 you don't need to apply any update.

• Backup iPortalDoc's DB (command [2])

Eg:

./ipbrickdb_ipb5 --dump --dbname dbdoc --file dump_file_path

• If there's an iPortalDoc Light, update to version 3.2, please follow this by backing up the data

Eg:

./ipbrickdb_ipb5 --dump --dbname dbdoc_leve --file dump_file_path

• Before migrating IPBrick 5.3 we recommend that you update IPBrick version at least till update 11, since this update will install Groupware version 1.2.11-2:
  • IPBrick v5.3 - update 11 [3]

NOTE: Check your browser's version if you are using Internet Explorer. iPortalDoc is fully compatible with Internet Explorer version 9 or higher.

iPortalDoc is also compatible with Google Chrome and Mozilla Firefox.

Scenario C - UCoIP is installed with iPortalDoc version 4.0

• Install:

1. iPortalDoc version 4.0 update 1: iportaldoc-v4_0-1.deb
2. iPortalDoc version 4.0 update 2: iportaldoc-v4_0-2.deb
3. iPortalDoc version 4.0 update 3: iportaldoc-v4_0-3.deb
4. iPortalDoc version 4.0 update 4: iportaldoc-v4_0-4.deb
5. iPortalDoc version 4.0 update 5: iportaldoc-v4_0-5.deb
   • Apply configurations
6. UCoIP Recording version 4 (you may find its link on the bottom of the page)
   • Apply configurations
7. iPortalDoc version 4.2 update 1: iportaldoc-v4_2-1.deb (available here: [4])
   • Apply configurations

• Check IP Contacts version: It needs to be at least in version 4.9 before the migration to an IPBrick version 6.1 (please find the download link on the bottom of this page).

Note: If Contacts is already in version 5.0.1 you don't need to apply any update.

• Backup iPortalDoc's DB (command [5])

Eg:

./ipbrickdb_ipb5 --dump --dbname dbdoc --file dump_file_path

• If there's an iPortalDoc Light, update to version 3.2, please follow this by backing up the data

Eg:

./ipbrickdb_ipb5 --dump --dbname dbdoc_leve --file dump_file_path

• Before migrating IPBrick 5.3 we recommend that you update IPBrick version at least till update 11, since this update will install Groupware version 1.2.11-2:
  • IPBrick v5.3 - update 11 [6]

NOTE: Check your browser's version if you are using Internet Explorer. iPortalDoc is fully compatible with Internet Explorer version 9 or higher.

iPortalDoc is also compatible with Google Chrome and Mozilla Firefox.

After the installation of IPBrick version 6.1:

• Install iPortalDoc v4.2 [7]

Note: If you have UCoIP, please install UCoIP Recording version 4.0 and skip the step above, since the UCoIP Recording package already includes iPortalDoc v4.2; you may find its link on the bottom of the page.

• Install update 1 for iPortalDoc v4.2 [8]

Note: If you had any other updates for iPortalDoc installed in version 5.x, you now need to install them again in IPBrick version 6.1.

• If IPBrick 5.x had IP Contacts version 5.0.1 installed, you can update it now to the same version but for IPBrick version 6.1 (please find the link on the bottom of the page).

• Replace IPBrick's configurations that were migrated to IPBrick 6.1.

• Restore iPortalDoc's DB [9]

Eg:

./ipbrickdb_ipb6  --restore --dbname dbdoc          --file /home1/_work/dump_dbdoc.sql

• If there is an iPortalDoc Light, restore the DB

Eg:

./ipbrickdb_ipb6  --restore --ipdoclight --dbname dbdoc_leve --file file_com_dump

• Rebuild iPortalDoc workflow accounts:

   a) Definitions Menu -> Configuration Interface
   b) Poplist on the right (Menu) -> Workflows
   c) Click on the Rebuild button

• Rebuild share "Access" and the account of Associated Emails to Documents, of iPortalDoc:

   a) Access Share: Definitions -> Configuration Interface-> Build Global FS
   b) Emails associated to documents: Definitions -> Configuration Interface -> Build Global mailFS
      (This task is scheduled to be executed at midnight);

• Contacts application: rebuild entities and contacts

   a) Administration -> Rebuild Contacts

• Update iPortalDoc till the last official update

Useful links:

IPContacts v4.8 update to install in an IPBrick v5 [10]

IPContacts v4.9 update to install in an IPBrick v5 [7]

IPContacts v5.0.1 update to install in an IPBrick v6.1 [11]

UCoIP Recording v4.0 update to install in an IPBrick v5 [[8]]

Script ipbrickdb_ipb5: |[9]

md5sum: 7339475f75c10cd7b54347f0cf6a5361

Script ipbrickdb_ipb6: |[10]

md5sum: 5d071c63f9a0a9a23802682a45f9e9fa