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

Revision as of 10:17, 7 March 2016

***PAGE ON CONSTRUCTION**

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-400000 | iPortaldoc v4.2
• IPD-400001 | iPortaldoc v4.2.u1

Scenario C - UCoIP is installed with version 4.0

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

This means that you must:

Scenario A - iPortalDoc is installed with version 4.0.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

• 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 4.9 you don't need to apply any update now.

• 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 B - iPortalDoc is installed with version 4.2.1

As iPortalDoc is already in version 4.2.1, you don't need to apply any update right now.

• 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 4.9 you don't need to apply any update now.

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

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 [5]

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 version 4.0

• 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 (Note: If you have UCoIP, check its version. If it is not updated, 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.)
   • Apply configurations
6. iPortalDoc version 4.2 update 1: iportaldoc-v4_2-1.deb (available here: [6])
   • 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 4.9 you don't need to apply any update now.

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

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 [8]

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 [9]

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 [10]

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 Contacts version on IPBRICK 5.x was higher than v4.9, update it now until the same version.

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

• Restore iPortalDoc's DB [11]

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 [12]

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

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

Script ipbrickdb_ipb5: |[9]

md5sum: 7339475f75c10cd7b54347f0cf6a5361

Script ipbrickdb_ipb6: |[10]

md5sum: 5d071c63f9a0a9a23802682a45f9e9fa