adoptcontext deprecated
PACKAGE: open-xchange-core
NAME
adoptcontext
SYNOPSIS
adoptcontext -o sourceServerId [-c contextId | -f file] [--check] -A masterAdmin -P masterAdminPassword [-p RMI-Port] [-s RMI-Server] [--responsetimeout responseTimeout] | [-h]
DESCRIPTION
Takes over contexts that a server of an older version created in a schema which is already updated for this server. The update tasks of that schema ran before such a context existed, so its calendar data is still in the legacy tables.
For each context, the tool assigns the context to this server and migrates its calendar data. The migration and the removal of the context's legacy calendar rows commit together, so running the tool again for an adopted context does not migrate it twice. A context without legacy calendar rows is not migrated at all, since its appointments may already have been migrated when this server updated the schema.
The context has to be disabled before, and it stays disabled afterwards, so that it can be checked before it is enabled again on this server. Run the tool on a node of this server.
Before adopting a context:
- Disable it on the older server and close its sessions there. A session left open keeps writing to the legacy tables; the tool refuses a context that has both legacy and migrated calendar data.
- Make sure the older server does not drop a schema it considers empty when deleting a context. It counts only the contexts assigned to itself, so deleting its last context in a schema would drop the adopted contexts with it.
Once the last context of the older server is adopted from a schema, run these update tasks once on that schema with forceupdatetask:
com.openexchange.groupware.update.tasks.FolderPermissionAddGuestGroupcom.openexchange.groupware.update.tasks.FolderPermissionReadAllForUserInfostorecom.openexchange.groupware.update.tasks.DropUnusedSharedAddressBookFoldercom.openexchange.groupware.update.tasks.FolderCorrectOwnerTaskcom.openexchange.groupware.update.tasks.CorrectInvalidTimezoneIdsTaskcom.openexchange.groupware.update.tasks.AddStartTLSColumnForMailAccountTablesTask, only ifcom.openexchange.mail.enforceSecureConnectionistrue
Never run the calendar migration or the calendar correction tasks on such a schema again; they act on all contexts of the schema.
OPTIONS
-o, --source-server sourceServerId : The identifier of the server the contexts are currently assigned to.
-c, --context contextId : The identifier of the context to adopt.
-f, --file file : A file with one context identifier per line. This option is a substitute for '-c/--context'.
--check : Only checks the contexts and reports what would be done.
-A, --adminuser masterAdminUser : Master admin user name for authentication. Optional, depending on your configuration.
-P, --adminpass masterAdminPassword : Master admin password for authentication. Optional, depending on your configuration.
-h, --help : Prints a help text
-s,--server rmiHost : The optional RMI server (default: localhost)
-p,--port rmiPort : The optional RMI port (default:1099)
--responsetimeout : The optional response timeout in seconds when reading data from server (default: 0s; infinite).