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
- 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//fields ...).
- - Define the way the calendars are displayed
- (admin/structure/types/manage//display ...) and edited
- (admin/structure/types/manage//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.