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

From wiki.IPBRICK.COM
Jump to: navigation, search
 
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
''' ***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: ==
 
== Before Migrating: ==
  
−
- Check iPortalDoc version: iPortalDoc need to be 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.
  
−
iPortalDoc update 1 for IPBrick versions 5.x is available here: [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_44_108&products_id=784]
+
In this procedure, we will assume three possible scenarios in IPBrick version 5.3:
  
−
Note: If iPortalDoc is in version 4.2.1 you don't need to apply any update now.
 
  
−
- Check IPBRICK Contacts version:  Contacts need to be in version 4.8 before the migration to an IPBrick version 6.1.
+
'''Scenario A - iPortalDoc is installed with version 4.0.1'''
  
−
Note: If Contacts is in version 4.8 you don't need to apply any update now.
+
* IPD-400000 | iPortalDoc v4.0
 +
* IPD-400001 | iPortalDoc v4.0.u1
  
−
- Backup the DB (command [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5])
+
'''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:
 +
# 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
 +
# iPortalDoc version 4.2: iportaldoc-v4_2.deb
 +
#* 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
 +
 
 +
'''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 [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5])
  
 
Eg:
 
Eg:
 
  ./ipbrickdb_ipb5 --dump --dbname dbdoc --file dump_file_path
 
  ./ipbrickdb_ipb5 --dump --dbname dbdoc --file dump_file_path
  
−
- If there's an IPortalDoc Light, update until version 3.2, please follow this by backing up the data
+
* If there's an iPortalDoc Light, update to version 3.2, please follow this by backing up the data
  
 
Eg:
 
Eg:
 
  ./ipbrickdb_ipb5 --dump --dbname dbdoc_leve --file dump_file_path
 
  ./ipbrickdb_ipb5 --dump --dbname dbdoc_leve --file dump_file_path
  
−
'''NOTE: Check your browsers version if you are using Internet Explorer. iPortalDoc is fully compatible with Internet Explorer version 9 or greater.'''
+
* 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]
  
−
iPortalDoc is compatible with Google Chrome and Mozilla Firefox.
+
'''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:
 +
# 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
 +
 
 +
* 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 [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5])
 +
 
 +
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 [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: ==
 
== 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]</br>
+
* Install iPortalDoc v4.2 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_85&products_id=694]
−
- Install update 1 [http://eshop.ipbrick.com/eshop/software_info.php?cPath=3_40_44_108&products_id=785]</br>
+
'''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.
−
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.0 now.  
+
  
−
- If the IPBRICK contacts version at IPBRICK 5.x was greater than v4.3, update the IPBRICK Contacts until the existing version now.
+
* 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.
  
−
- Replace the IPBrick configuration migrated to IPBrick 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).
  
−
- Restore the dbdoc DB [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb6]
+
* Replace IPBrick's configurations that were migrated to IPBrick 6.1.
 +
 
 +
* 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
 +
    a) Administration -> Rebuild Contacts
 +
 +
* Update iPortalDoc till the last official update
  
 
== Useful links: ==
 
== Useful links: ==
  
−
IPContacts v4.8 update to install in an IPBrick v5 [http://downloads3.ipbrick.com/ipbrick-contacts_4.8_all.deb]
+
IPContacts v4.8 update to install in an IPBrick v5 [http://downloads3.ipbrick.com/wiki/ipbrick-contacts_4.8_all.deb]
 +
 
 +
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]]]
  
−
Script ipbrickdb_ipb5: [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5]
+
Script ipbrickdb_ipb5: [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb5 |[9]]
  
 
md5sum: 7339475f75c10cd7b54347f0cf6a5361
 
md5sum: 7339475f75c10cd7b54347f0cf6a5361
  
−
Script ipbrickdb_ipb6: [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb6]
+
Script ipbrickdb_ipb6: [http://downloads3.ipbrick.com/wiki/ipbrickdb_ipb6 |[10]]
  
 
md5sum: 5d071c63f9a0a9a23802682a45f9e9fa
 
md5sum: 5d071c63f9a0a9a23802682a45f9e9fa

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"