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

From wiki.IPBRICK.COM
Jump to: navigation, search
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
''' ***EPAGE ON CONSTRUCTION** '''
+
''' ***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.
 
This next procedure will explain how to update an IPBrick version 5.x with iPortalDoc to an IPBrick version 6.1 with iPortalDoc.
Line 9: Line 10:
 
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.
 
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 assume that the following updates are installed in IPBrick version 5.3:
+
In this procedure, we will assume three possible scenarios in IPBrick version 5.3:
  
−
* IPD-400000 | iPortaldoc v4.0
+
 
−
* IPD-400001 | iPortaldoc v4.0.u1
+
'''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.
 
* BIL-200000 | ipbrick-billing - Billing Software v2.0.
 
* UFI-300000 | ucoip4iportaldoc - UCoIP for iPortalDoc
 
* UFI-300000 | ucoip4iportaldoc - UCoIP for iPortalDoc
  
−
This means that you must:
+
 
 +
=== 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:
 
* Install:
 
# iPortalDoc version 4.0 update 2: iportaldoc-v4_0-2.deb
 
# iPortalDoc version 4.0 update 2: iportaldoc-v4_0-2.deb
Line 28: Line 45:
 
#* Apply configurations
 
#* Apply configurations
  
−
Note: If iPortalDoc is already in version 4.2.1, you don't need to apply any update right now.
+
'''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).
 
* 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.
+
Note: If Contacts is already in version 5.0.1 you don't need to apply any update.
  
−
* Check UCoIP version: If it is not updated, please install UCoIP Recording version 4.0 (see link on the bottom of the page).
 
  
 
* Backup iPortalDoc's DB (command [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5])
 
* Backup iPortalDoc's DB (command [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5])
Line 48: Line 64:
 
* 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:
 
* 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 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_73_6_38&products_id=581]
 
** IPBrick v5.3 - update 11 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_73_6_38&products_id=581]
−
 
  
 
'''NOTE: Check your browser's version if you are using Internet Explorer. iPortalDoc is fully compatible with Internet Explorer version 9 or higher.'''
 
'''NOTE: Check your browser's version if you are using Internet Explorer. iPortalDoc is fully compatible with Internet Explorer version 9 or higher.'''
Line 54: Line 69:
 
''' iPortalDoc is also compatible with Google Chrome and Mozilla Firefox.'''
 
''' iPortalDoc is also compatible with Google Chrome and Mozilla Firefox.'''
  
 +
=== Scenario C - UCoIP is installed with iPortalDoc version 4.0 ===
  
−
== After the installation of IPBrick version 6.1: ==
+
* Install:
 +
# iPortalDoc version 4.0 update 1: iportaldoc-v4_0-1.deb
 +
# iPortalDoc version 4.0 update 2: iportaldoc-v4_0-2.deb
 +
# iPortalDoc version 4.0 update 3: iportaldoc-v4_0-3.deb
 +
# iPortalDoc version 4.0 update 4: iportaldoc-v4_0-4.deb
 +
# iPortalDoc version 4.0 update 5: iportaldoc-v4_0-5.deb
 +
#* Apply configurations
 +
# UCoIP Recording version 4 (you may find its link on the bottom of the page)
 +
#* Apply configurations
 +
# iPortalDoc version 4.2 update 1: iportaldoc-v4_2-1.deb (available here: [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_44_108&products_id=784])
 +
#* Apply configurations
  
−
- Install iPortalDoc v4.2 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_85&products_id=694]
+
* 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).
  
−
- Install update 1 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_44_108&products_id=802]
+
Note: If Contacts is already in version 5.0.1 you don't need to apply any update.
  
−
Note: if you had any other update for iPortalDoc installed on version 5.x, you need to install the same iPortalDoc update for IPBrick version 6.1 now.  
+
* Backup iPortalDoc's DB (command [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5])
  
 +
Eg:
 +
./ipbrickdb_ipb5 --dump --dbname dbdoc --file dump_file_path
  
−
- If the IPBRICK contacts version at IPBRICK 5.x was greater than v4.9, update the IPBRICK Contacts until the existing version now.
+
* 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 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_73_6_38&products_id=581]
 +
 +
'''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 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_85&products_id=694]
 +
'''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 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_44_108&products_id=802]
 +
 +
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 the IPBrick configuration migrated to IPBrick 6.1.
+
* Replace IPBrick's configurations that were migrated to IPBrick 6.1.
  
−
- Restore the dbdoc DB [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb6]
+
* Restore iPortalDoc's DB [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb6]
  
 
Eg:
 
Eg:
 
  ./ipbrickdb_ipb6  --restore --dbname dbdoc          --file /home1/_work/dump_dbdoc.sql
 
  ./ipbrickdb_ipb6  --restore --dbname dbdoc          --file /home1/_work/dump_dbdoc.sql
  
−
- If there is an iPortalDoc Light, restore the DB
+
* If there is an iPortalDoc Light, restore the DB
  
 
Eg:
 
Eg:
 
  ./ipbrickdb_ipb6  --restore --ipdoclight --dbname dbdoc_leve --file file_com_dump
 
  ./ipbrickdb_ipb6  --restore --ipdoclight --dbname dbdoc_leve --file file_com_dump
  
−
 
+
* Rebuild iPortalDoc workflow accounts:
−
- Rebuild iPortalDoc workflow accounts:
+
 
     a) Definitions Menu -> Configuration Interface
 
     a) Definitions Menu -> Configuration Interface
 
     b) Poplist on the right (Menu) -> Workflows
 
     b) Poplist on the right (Menu) -> Workflows
 
     c) Click on the Rebuild button
 
     c) Click on the Rebuild button
  
−
- Rebuild share "Access" and the account of Associated Emails to Documents, of iPortalDoc:
+
* Rebuild share "Access" and the account of Associated Emails to Documents, of iPortalDoc:
 
     a) Access Share: Definitions -> Configuration Interface-> Build Global FS
 
     a) Access Share: Definitions -> Configuration Interface-> Build Global FS
 
     b) Emails associated to documents: Definitions -> Configuration Interface -> Build Global mailFS
 
     b) Emails associated to documents: Definitions -> Configuration Interface -> Build Global mailFS
 
       (This task is scheduled to be executed at midnight);
 
       (This task is scheduled to be executed at midnight);
  
−
- Contacts application: rebuild entities and contacts
+
* Contacts application: rebuild entities and contacts
 
     a) Administration -> Rebuild Contacts
 
     a) Administration -> Rebuild Contacts
 +
 +
* Update iPortalDoc till the last official update
  
 
== Useful links: ==
 
== Useful links: ==
Line 98: Line 147:
  
 
IPContacts v4.9 update to install in an IPBrick v5 [[Media:Ipbrick-contacts_4.9_all.deb |[7]]]
 
IPContacts v4.9 update to install in an IPBrick v5 [[Media:Ipbrick-contacts_4.9_all.deb |[7]]]
 +
 +
IPContacts v5.0.1 update to install in an IPBrick v6.1 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_73_35&products_id=891]
  
 
UCoIP Recording v4.0 update to install in an IPBrick v5 [[http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_51&products_id=799[8]]]
 
UCoIP Recording v4.0 update to install in an IPBrick v5 [[http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_51&products_id=799[8]]]

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

Retrieved from "https://wiki.ipbrick.com/index.php?title=Migrating_an_iPortalDoc_from_IPBRICK_5.x_to_6.1&oldid=1010"