Migrating user data from osaf.us to hub.chandlerproject.org

In the Chandler Desktop Preview release, the system used for sharing with a server has been changed to use a faster, more capable system.

As a result, the osaf.us server will no longer be used or updated. People using Chandler sharing should move to hub.chandlerproject.org.

You can move off osaf.us on your own schedule though eventually that server will be shut down. You should have until at least the end of August 2007 to complete this move.

Select the right version

OR:

Chandler Desktop 0.7 Preview migration instructions

Step 1: Launch your current Chandler Desktop

1. Start Chandler Desktop like you normally do

Step 2: Handle your non-shared collections

1. If all your collections are already shared to osaf.us, go ahead to step #3.
2. If some collections aren't published, you need to prepare them for migration or you will lose them. It will be easiest to just publish all your collections to the server. To do that:
   1. Select a collection in the left-hand sidebar
   2. Go to Share >> Publish menu
   3. A dialog box named "Publish" will pop up. Select your osaf.us / WebDAV sharing account from the pulldown and click the "Publish" button.
3. Note: If you have data that you are uncomfortable publishing to our servers, you should export each collection to .ics files. To do that:
   1. Select a collection in the left-hand sidebar
   2. Go to File >> Export. Save each collection into a file.
4. Note: Only events are saved properly to .ics files. Tasks are partially preserved. Other Chandler items including notes and emails will be lost.

Step 3: Backup your Chandler Desktop data locally

1. Go to File >> Export collections and settings... menu
2. If a "Set Master password" dialog pops up, read the message and click "No" or "Yes" depending on how you'd like to manage your repository.
3. Select a filename and directory to use (the default YYYYMMDD.chex filename should be fine) and save the backup file

Step 4: Save your account settings

1. Go to Tools >> Save and Restore >> Save settings...
2. If a "Set Master password" dialog pops up, read the message and click "No" or "Yes" depending on how you'd like to manage your repository. Warning: If you select "No", please be careful with your settings file as it will contain all of your passwords in plain text.
3. Select a filename and directory to use (the default chandler.ini filename should be fine) and save the settings file

Step 5: Quit Chandler Desktop

1. Shut down Chandler as you would normally.

Step 6: Download and install new Chandler Desktop

1. Note: Please use a version of Chandler Desktop equal to or greater than 0.7.dev-r14601-checkpoint200700606.
2. You can download this software here: http://downloads.osafoundation.org/chandler/checkpoints/20070606

Step 7: Launch new Chandler Desktop

1. Find where Chandler Desktop is installed on your computer and start it by clicking on that icon
2. Answer "yes" to any dialogs indicating your repository will be deleted. Note: the following steps assume you are starting with a blank repository and restoring everything from the server or .ics files
3. Confirm you have no collections, accounts, or data in your new Chandler.
4. Note: Please check that you aren't running your previously-installed version of Chandler Desktop accidentally

Step 8: Create an account on the new server

1. Visit http://hub.chandlerproject.org/ in your browser
2. Select "Click here to create one."
3. Enter the required information into the signup form and click "submit"
4. Look in your email for an account activation email and click the URL in that email

Step 9: Create a Chandler Hub Sharing account in Chandler Desktop

1. Go to File >> Accounts... menu. This will open the "Account Preferences" dialog, shown below.
2. Select "Chandler Hub sharing (Default)" if not already selected
3. Enter your server account user name and password as you created them in step #8 above
4. Press the "Test" button to confirm your hub.chandlerproject.org account is set up and working properly from Chandler

Step 10: Restore your account settings

1. Go to Tools >> Save and Restore >> Restore settings...
2. Choose the settings file (chandler.ini) you saved in step #4 above
3. Fill out the "Setting Master Password" dialogs if they appear
4. Chandler will automatically restore your account settings, subscriptions and published shares

Step 11: Unsubscribe from each collection you have published

1. Select a collection from the left-hand sidebar.
2. If the collection has an arrow pointing to the right (indicating it's a shared collection), go to Share >> Unsubscribe menu
3. Note: You do not need to unsubscribe from collections you did not publish.
4. Note: The sharing status arrow to the right of the collection will disappear when you unsubscribe.

Step 12: Publish each of your collections via the Chandler Hub Sharing account

1. Select a collection in the left-hand sidebar that you want to publish to the server
2. Go to Share >> Publish menu
3. A dialog box named "Publish" will pop up. Select the "Chandler Hub sharing" account from the pulldown and click the "Publish" button.
4. Note: don't republish collections you are subscribed to, only those you originally published on osaf.us
5. Note: you don't need to publish a collection if you don't want share or backup that collection on the server

Step 13: Restore non-shared collections

• If you exported any non-shared collections into .ics files in step #2 above, then:
  1. Go to File >> Import .ics calendar file... menu to restore those collections from each file.
• If you shared collections that you'd prefer not stay published to the server, during step #2 above, then:
  1. Select each such collection in the sidebar, then use Share >> Unpublish menu to remove them from the server entirely.

Step 14: Delete the Chandler "WebDAV Sharing" sharing account

1. Go to File >> Accounts... menu
2. Select the "Cosmo Sharing service" or "WebDAV Sharing" account and press the "Delete account..." button
3. Press the "OK" or "cancel" button to close the accounts dialog

Step 15: Distribute new Chandler Hub sharing ticket-URLs

1. Select a collection in the left-hand sidebar
2. Go to Share >> Copy ticket URLs to clipboard menu
3. Open a new email or instant message to your friends
4. Paste the ticket URLs into the email. Delete the read-write URL if you don't want to share read-write access with others.
5. Send this message to your friends!

Step 16: Coordinate with your friends when they move servers too

• If you are subscribed to other people's collections, when they change servers, you should resubscribe to the new collections. To do that:
  1. Select the collection in the sidebar
  2. Go to Share >> Unsubscribe
  3. Go to Share >> Subscribe, enter the sharing URL your friend has given you, then click the "Subscribe" button

Chandler Desktop 0.7 Alpha 4 migration instructions

Step 1: Launch your current Chandler Desktop

1. Start Chandler Desktop like you normally do

Step 2: Handle your non-shared collections

1. If all your collections are already shared to osaf.us, go ahead to step #3.
2. If some collections aren't published, you need to prepare them for migration or you will lose them. It will be easiest to just publish all your collections to the server. To do that:
   1. Select a collection in the left-hand sidebar
   2. Go to Collection >> Share collection name menu
   3. A dialog box named "Publish" will pop up. Select your osaf.us / WebDAV sharing account from the pulldown and click the "Publish" button.
3. Note: If you have data that you are uncomfortable publishing to our servers, you should export each collection to .ics files. To do that:
   1. Select a collection in the left-hand sidebar
   2. Go to File >> Export. Save each collection into a file.
   3. Note: Only events are saved properly to .ics files. Tasks are partially preserved. Other Chandler items including notes and emails will be lost.

Step 3: Backup your Chandler Desktop data locally

1. Go to Test >> Repository >> Backup repository menu
2. Select a filename and directory to use and save the backup file

Step 4: Save your account settings

1. Go to Test >> Save Settings... menu
2. Select a filename and directory to use (the default chandler.ini filename should be fine) and save the settings file
3. Warning: Please be careful with your settings file as it contains all of your passwords in plain text.

Step 5: Quit Chandler Desktop

1. Shut down Chandler as you would normally.

Step 6: Download and install new Chandler Desktop

1. Note: Please use a version of Chandler Desktop equal to or greater than 0.7.dev-r14601-checkpoint200700606.
2. You can download this software here: http://downloads.osafoundation.org/chandler/checkpoints/20070606

Step 7: Launch new Chandler Desktop

1. Find where Chandler Desktop is installed on your computer and start it by clicking on that icon
2. Answer "yes" to any dialogs indicating your repository will be deleted. Note: the following steps assume you are starting with a blank repository and restoring everything from the server or .ics files
3. Confirm you have no collections, accounts, or data in your new Chandler.
4. Note: Please check that you aren't running your previously-installed version of Chandler Desktop accidentally

Step 8: Create an account on the new server

1. Visit http://hub.chandlerproject.org/ in your browser
2. Select "Click here to create one."
3. Enter the required information into the signup form and click "submit"
4. Look in your email for an account activation email and click the URL in that email

Step 9: Create a Chandler Hub Sharing account in Chandler Desktop

1. Go to File >> Accounts... menu. This will open the "Account Preferences" dialog, shown below.
2. Select "Chandler Hub sharing (Default)" if not already selected
3. Enter your server account user name and password as you created them in step #8 above
4. Press the "Test" button to confirm your hub.chandlerproject.org account is set up and working properly from Chandler

Step 10: Restore your account settings

1. Go to Tools >> Save and Restore >> Restore settings...
2. Choose the settings file (chandler.ini) you saved in step #4 above
3. Fill out the "Setting Master Password" dialogs if they appear
4. Chandler will automatically restore your account settings, subscriptions and published shares

Step 11: Unsubscribe from each collection you have published

1. Select a collection from the left-hand sidebar.
2. If the collection has an arrow pointing to the right (indicating it's a shared collection), go to Share >> Unsubscribe menu
3. Note: You do not need to unsubscribe from collections you did not publish.
4. Note: The sharing status arrow to the right of the collection will disappear when you unsubscribe.

Step 12: Publish each of your collections via the Chandler Hub Sharing account

1. Select a collection in the left-hand sidebar that you want to publish to the server
2. Go to Share >> Publish menu
3. A dialog box named "Publish" will pop up. Select the "Chandler Hub sharing" account from the pulldown and click the "Publish" button.
4. Note: don't republish collections you are subscribed to, only those you originally published on osaf.us
5. Note: you don't need to publish a collection if you don't want share or backup that collection on the server

Step 13: Restore non-shared collections

• If you exported any non-shared collections into .ics files in step #2 above, then:
  1. Go to File >> Import .ics calendar file... menu to restore those collections from each file.
• If you shared collections that you'd prefer not stay published to the server, during step #2 above, then:
  1. Select each such collection in the sidebar, then use Share >> Unpublish menu to remove them from the server entirely.

Step 14: Delete the Chandler "WebDAV Sharing" sharing account

1. Go to File >> Accounts... menu
2. Select the "Cosmo Sharing service" or "WebDAV Sharing" account and press the "Delete account..." button
3. Press the "OK" or "cancel" button to close the accounts dialog

Step 15: Distribute new Chandler Hub sharing ticket-URLs

1. Select a collection in the left-hand sidebar
2. Go to Share >> Copy ticket URLs to clipboard menu
3. Open a new email or instant message to your friends
4. Paste the ticket URLs into the email. Delete the read-write URL if you don't want to share read-write access with others.
5. Send this message to your friends!

Step 16: Coordinate with your friends when they move servers too

• If you are subscribed to other people's collections, when they change servers, you should resubscribe to the new collections. To do that:
  1. Select the collection in the sidebar
  2. Go to Share >> Unsubscribe
  3. Go to Share >> Subscribe, enter the sharing URL your friend has given you, then click the "Subscribe" button