You are here

UPGRADE.txt in Availability Calendars 7.2

UPGRADE
-------
Upgrading from the Availability Calendars module (7.x-2.x) to the fields based
Availability Calendar module (7.x-3.x) takes some care in planning an executing.
The following steps are to be executed in order:

1)
Make sure you are on the latest 7.x-2.x (dev) version of Availability Calendars.

2)
Make sure you have run update.php on that version.

Result)
The installation now contains a separate module "Availability Calendars update"
and your "old" data is in the format as expected by that update module.


3)
Install and enable the 7.x-3.x Availability Calendar field module. Ignore the
notifications about visiting the Availability Calendar Settings and Styling page
for now.

Result)
Your site has the tables in place to copy and convert the existing data to.


4)
Backup your database.

5)
Enable the "Availability Calendars update" module.

6)
Run admin/config/content/availability-calendars/update (e.g. by clicking on the
link in the notice af ter enabling) and follow the on-screen instructions.

7)
On success, backup your database again.

8)
Set up the created Availability Calendar fields:
- Change the (global) set of availability states
  (admin/config/content/availability-calendar/settings).
- Define styles like the colors for the availability states
  (admin/config/content/availability-calendar/styling).
- Define the allowed states and the default state per field
  (admin/structure/types/manage/<type>/fields ...).
- Define the way the calendars are displayed
  (admin/structure/types/manage/<type>/display ...) and edited
  (admin/structure/types/manage/<type>/fields ...).
- Disable "Availability Calendars update" module.
- Disable "Availability Calendars" module.
- Uninstall "Availability Calendars update" module.
- Uninstall "Availability Calendars" module.
- Delete the availability_calendars[_*].* files and the subdirectory ac_update.
- Backup your database once more.

Result)
Your data has been converted and you can start using the availability calendar
fields.


Errors
------
If you get error messages in your status bar during the update process, follow
the instructions to resolve the error and restart the update.

If you get fatal errors, your database might contain unforeseen conditions. Try
to decipher the error message to find the cause, remove that cause and restart
the conversion. if you can't solve it yourself you may create an issue detailing
steps you have done, error messages you got, etc.

File

ac_update/UPGRADE.txt
View source
  1. UPGRADE
  2. -------
  3. Upgrading from the Availability Calendars module (7.x-2.x) to the fields based
  4. Availability Calendar module (7.x-3.x) takes some care in planning an executing.
  5. The following steps are to be executed in order:
  6. 1)
  7. Make sure you are on the latest 7.x-2.x (dev) version of Availability Calendars.
  8. 2)
  9. Make sure you have run update.php on that version.
  10. Result)
  11. The installation now contains a separate module "Availability Calendars update"
  12. and your "old" data is in the format as expected by that update module.
  13. 3)
  14. Install and enable the 7.x-3.x Availability Calendar field module. Ignore the
  15. notifications about visiting the Availability Calendar Settings and Styling page
  16. for now.
  17. Result)
  18. Your site has the tables in place to copy and convert the existing data to.
  19. 4)
  20. Backup your database.
  21. 5)
  22. Enable the "Availability Calendars update" module.
  23. 6)
  24. Run admin/config/content/availability-calendars/update (e.g. by clicking on the
  25. link in the notice af ter enabling) and follow the on-screen instructions.
  26. 7)
  27. On success, backup your database again.
  28. 8)
  29. Set up the created Availability Calendar fields:
  30. - Change the (global) set of availability states
  31. (admin/config/content/availability-calendar/settings).
  32. - Define styles like the colors for the availability states
  33. (admin/config/content/availability-calendar/styling).
  34. - Define the allowed states and the default state per field
  35. (admin/structure/types/manage//fields ...).
  36. - Define the way the calendars are displayed
  37. (admin/structure/types/manage//display ...) and edited
  38. (admin/structure/types/manage//fields ...).
  39. - Disable "Availability Calendars update" module.
  40. - Disable "Availability Calendars" module.
  41. - Uninstall "Availability Calendars update" module.
  42. - Uninstall "Availability Calendars" module.
  43. - Delete the availability_calendars[_*].* files and the subdirectory ac_update.
  44. - Backup your database once more.
  45. Result)
  46. Your data has been converted and you can start using the availability calendar
  47. fields.
  48. Errors
  49. ------
  50. If you get error messages in your status bar during the update process, follow
  51. the instructions to resolve the error and restart the update.
  52. If you get fatal errors, your database might contain unforeseen conditions. Try
  53. to decipher the error message to find the cause, remove that cause and restart
  54. the conversion. if you can't solve it yourself you may create an issue detailing
  55. steps you have done, error messages you got, etc.