summaryrefslogtreecommitdiff
path: root/Administrator_Guide/ja-JP/Upgrading_from_Kolab_2_on_OpenPKG.po
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-08-24 15:34:45 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-08-24 15:34:45 (GMT)
commit089a5a819444f51359936ea355d3c96315826ec1 (patch)
tree2edd983e5b51e74701c943955e956c34aec551d5 /Administrator_Guide/ja-JP/Upgrading_from_Kolab_2_on_OpenPKG.po
parente96837b4f14e1723379477603cdf66b80e1e9d8a (diff)
downloadkolab-docs-089a5a819444f51359936ea355d3c96315826ec1.tar.gz
Add language ja-JP
Diffstat (limited to 'Administrator_Guide/ja-JP/Upgrading_from_Kolab_2_on_OpenPKG.po')
-rw-r--r--Administrator_Guide/ja-JP/Upgrading_from_Kolab_2_on_OpenPKG.po425
1 files changed, 425 insertions, 0 deletions
diff --git a/Administrator_Guide/ja-JP/Upgrading_from_Kolab_2_on_OpenPKG.po b/Administrator_Guide/ja-JP/Upgrading_from_Kolab_2_on_OpenPKG.po
new file mode 100644
index 0000000..7b94d47
--- /dev/null
+++ b/Administrator_Guide/ja-JP/Upgrading_from_Kolab_2_on_OpenPKG.po
@@ -0,0 +1,425 @@
+#
+# AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2012-08-24T15:34:45\n"
+"PO-Revision-Date: 2012-08-24T15:34:45\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Upgrading from Kolab 2 on OpenPKG"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As Kolab Groupware used to be distributed as an OpenPKG stack, with different locations for files, the upgrade of a Kolab 2 server to a Kolab 3 server is a largely manual process."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The Kolab 3 server used here has been set up for the same domain name space as the Kolab 2 server. No users have been created on the Kolab 3 server."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>kolab2.example.org</literal> refers to the Kolab 2 server, <literal>kolab3.example.org</literal> refers to the Kolab 3 server."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Preparations"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "During the migration, the Kolab 2 server cannot be allowed to;"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Receive new email."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Let users post/submit new data."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The easiest way to prevent any of this happening is to shut down all Kolab Groupware related services on <literal>kolab2.example.org</literal>:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>/kolab/bin/openpkg rc stop all</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Create a backup of the data from <literal>kolab2.example.org</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Shut down the Cyrus IMAP service on <literal>kolab3.example.org</literal>:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>service cyrus-imapd stop</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Shut down the Kolab daemon on <literal>kolab3.example.org</literal>:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>service kolabd stop</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Update the settings related to the recipient policy in <filename>/etc/kolab/kolab.conf</filename>. The following settings are important:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>primary_mail</literal> setting in the <literal>[<replaceable>$domain</replaceable>]</literal> section."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The policy MUST<footnote> <para> the policy enforces consistency in the <literal>mail</literal> attribute values for all users - and therefore mailbox names, and ACL entry subject validity </para> </footnote> either match the former convention used, if any, or not be enabled at all. See <xref linkend=\"exam-Administrator_Guide-Upgrading_from_Kolab_2_on_OpenPKG-Example_Migration_of_example.org\" /> for an example and some more gotchas."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In case the recipient policy is not to be applied, consider updating the <literal>user_types</literal> as per the instructions in <xref linkend=\"sect-Administrator_Guide-Kolab_Web_Administration_Panel-Editing_user_types\" />."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>secondary_mail</literal> setting in the <literal>[<replaceable>$domain</replaceable>]</literal> section."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This part of the policy does not apply should the <literal>primary_mail</literal> setting already have been disabled."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Example Migration of example.org"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Our first example has had a running Kolab 2.3 on OpenPKG server, with a general email address convention of \"surname\"@example.org."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "By default, a Kolab &PRODUCT_VERSION; Groupware server will apply a recipient policy for the <literal>mail</literal> attribute value of \"givenname\".\"surname\"@example.org. The recipient policy must therefore be adjusted."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In the <literal>[example.org]</literal> section in <filename>/etc/kolab/kolab.conf</filename>, the <literal>primary_mail</literal> setting must be adjusted to match the \"surname\"@example.org convention:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "(...snip...)\n"
+"[example.org]\n"
+"primary_mail = %(surname)s@%(domain)s\n"
+"(...snip...)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now, users that are created will get a <literal>mail</literal> attribute value of \"surname\"@example.org assigned."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "First adding user John Doe will give him a <literal>mail</literal> attribute value of <emphasis>doe@example.org</emphasis>, but should you have a Jane Doe as well, she would get <emphasis>doe2@example.org</emphasis>. It is therefore important to add users in order."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Migration of LDAP"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This section has not been authored yet."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Migration and Upgrade of Data"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The following procedure"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Migrate the Data Through Copying"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Login to <literal>kolab3.example.org</literal> to execute the steps in this procedure."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Copy mailboxes.db and annotations.db. These files are located in <filename>/kolab/var/imapd/</filename> on your Kolab 2 server."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>scp root@kolab2.example.org:/kolab/var/imapd/annotations.db \\</userinput>\n"
+"&gt; <userinput>/var/lib/imap/annotations.db</userinput>\n"
+"(...)\n"
+"# <userinput>scp root@kolab2.example.org:/kolab/var/imapd/mailboxes.db \\</userinput>\n"
+"&gt; <userinput>/var/lib/imap/mailboxes.db</userinput>\n"
+"(...)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Migrate the mail spool:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>rsync -rltpHvz --progress --partial \\</userinput>\n"
+"&gt; <userinput>kolab2.example.org:/var/imapd/spool/ \\</userinput>\n"
+"&gt; <userinput>/var/spool/imap/</userinput>\n"
+"(...)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Migrate the seen and subscription databases:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>rsync -rltpHvz --progress --partial \\</userinput>\n"
+"&gt; <userinput>kolab2.example.org:/var/imapd/domain/ \\</userinput>\n"
+"&gt; <userinput>/var/lib/imap/domain/</userinput>\n"
+"(...)\n"
+"# <userinput>rsync -rltpHvz --progress --partial \\</userinput>\n"
+"&gt; <userinput>kolab2.example.org:/var/imapd/user/ \\</userinput>\n"
+"&gt; <userinput>/var/lib/imap/user/</userinput>\n"
+"(...)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Ensure the filesystem permissions are correct:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>chown -R cyrus:mail /var/lib/imap/ /var/spool/imap/</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Ensure only the cyrus user can read and write, and the mail group can read the contents of either directory tree:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>find /var/lib/imap -type f -exec chmod 640 {} \\;</userinput>\n"
+"# <userinput>find /var/lib/imap -type d -exec chmod 750 {} \\;</userinput>\n"
+"# <userinput>find /var/spool/imap -type f -exec chmod 640 {} \\;</userinput>\n"
+"# <userinput>find /var/spool/imap -type d -exec chmod 750 {} \\;</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Stop the Kolab daemon:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Start the Cyrus IMAP service on <literal>kolab3.example.org</literal>:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>service cyrus-imapd start</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Users should not yet be allowed to interact with the system at this point. We suggest closing access to the system through the firewall."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The annotations database may not have been upgraded correctly, causing some annotations to miss the first 4 characters of their value. The easiest way to fix the issue, that is known to work, is to get the annotation values as they were on the old (Kolab 2) IMAP server, and set them on the new (Kolab 3) IMAP server."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>kolab -c conf/kolab-kolab2.example.org.conf \\</userinput>\n"
+"&gt; <userinput>list-mailbox-metadata \"user/john.doe/Calendar*@example.org\"</userinput>\n"
+"Folder user/john.doe/Calendar@example.org\n"
+" /shared/vendor/cmu/cyrus-imapd/lastpop\n"
+" /shared/vendor/cmu/cyrus-imapd/partition&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;default\n"
+" /shared/vendor/cmu/cyrus-imapd/lastupdate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8-Aug-2012 16:16:06 +0200\n"
+" /shared/vendor/cmu/cyrus-imapd/size&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;266564\n"
+" /shared/vendor/cmu/cyrus-imapd/pop3newuidl&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;true\n"
+" /shared/vendor/cmu/cyrus-imapd/sharedseen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;false\n"
+" /shared/vendor/kolab/folder-type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;event.default\n"
+" /shared/vendor/cmu/cyrus-imapd/condstore&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;true\n"
+" /shared/vendor/cmu/cyrus-imapd/duplicatedeliver&nbsp;&nbsp;&nbsp;false\n"
+" /shared/vendor/kolab/incidences-for&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;admins\n"
+" /shared/vendor/kolab/folder-test&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;true\n"
+"Folder user/john.doe/Calendar/Private@example.org\n"
+" /shared/vendor/cmu/cyrus-imapd/lastpop\n"
+" /shared/vendor/cmu/cyrus-imapd/partition&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;default\n"
+" /shared/vendor/cmu/cyrus-imapd/lastupdate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8-Aug-2012 16:08:58 +0200\n"
+" /shared/vendor/cmu/cyrus-imapd/condstore&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;true\n"
+" /shared/vendor/cmu/cyrus-imapd/pop3newuidl&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;true\n"
+" /shared/vendor/cmu/cyrus-imapd/size&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;305426\n"
+" /shared/vendor/cmu/cyrus-imapd/sharedseen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;false\n"
+" /shared/vendor/kolab/folder-type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;event\n"
+" /shared/vendor/cmu/cyrus-imapd/duplicatedeliver&nbsp;&nbsp;&nbsp;false\n"
+"# <userinput>kolab list-mailbox-metadata \"user/john.doe/Calendar*@example.org\"</userinput>\n"
+"Folder user/john.doe/Calendar@example.org\n"
+" /shared/vendor/cmu/cyrus-imapd/lastpop\n"
+" /shared/vendor/cmu/cyrus-imapd/partition&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;default\n"
+" /shared/vendor/cmu/cyrus-imapd/lastupdate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8-Aug-2012 16:16:27 +0200\n"
+" /shared/vendor/cmu/cyrus-imapd/duplicatedeliver&nbsp;&nbsp;&nbsp;false\n"
+" /shared/vendor/cmu/cyrus-imapd/pop3newuidl&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;true\n"
+" /shared/vendor/cmu/cyrus-imapd/size&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;266564\n"
+" /shared/vendor/cmu/cyrus-imapd/sharedseen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;false\n"
+" /shared/vendor/kolab/folder-type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;event.default\n"
+"Folder user/john.doe/Calendar/Private@example.org\n"
+" /shared/vendor/cmu/cyrus-imapd/lastpop\n"
+" /shared/vendor/cmu/cyrus-imapd/partition&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;default\n"
+" /shared/vendor/cmu/cyrus-imapd/lastupdate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8-Aug-2012 16:27:44 +0200\n"
+" /shared/vendor/cmu/cyrus-imapd/duplicatedeliver&nbsp;&nbsp;&nbsp;false\n"
+" /shared/vendor/cmu/cyrus-imapd/pop3newuidl&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;true\n"
+" /shared/vendor/cmu/cyrus-imapd/size&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;305426\n"
+" /shared/vendor/cmu/cyrus-imapd/sharedseen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;false"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Fix'em:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "#!/bin/bash\n"
+"\n"
+"# Interesting Annotations\n"
+"declare -a ia\n"
+"\n"
+"ia[${#ia[@]}]=\"/shared/vendor/kolab/folder-type\"\n"
+"ia[${#ia[@]}]=\"/shared/vendor/kolab/folder-test\"\n"
+"\n"
+"for folder_search in user/*@example.org shared/*@example.org; do\n"
+" kolab -c conf/kolab-kolab.kolabsys.com.conf \\\n"
+" list-mailbox-metadata \"${folder_search}\" | \\\n"
+" while read line; do\n"
+" if [ ! -z \"$(echo $line | grep ^Folder)\" ]; then\n"
+" current_folder=$(echo $line | cut -d' ' -f2-)\n"
+"\n"
+" echo \"Folder: '${current_folder}'\"\n"
+" else\n"
+" annotation_key=$(echo $line | awk '{print $1}')\n"
+" annotation_value=$(echo $line | awk '{print $2}')\n"
+"\n"
+" i=0\n"
+" set_annotation=0\n"
+" while [ $i -lt ${#ia[@]} ]; do\n"
+" if [ \"${ia[$i]}\" == \"${annotation_key}\" ]; then\n"
+" set_annotation=1\n"
+" break\n"
+" fi\n"
+" let i++\n"
+" done\n"
+"\n"
+" if [ ${set_annotation} -eq 0 ]; then\n"
+" continue\n"
+" fi\n"
+"\n"
+" echo \"Setting ${annotation_key} to ${annotation_value}\"\n"
+"\n"
+" kolab set-mailbox-metadata \\\n"
+" \"${current_folder}\" \\\n"
+" \"${annotation_key}\" \\\n"
+" \"${annotation_value}\"\n"
+" fi\n"
+" done\n"
+"\n"
+"done"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Upgrade all messages from Kolab Format version 2 to Kolab Format version 3 using <command>kolab-formatupgrade</command>. This command is run in two parts. The first will upgrade all mailbox contents in the personal namespace:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>kolab lm \"user/%@example.org\" | \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;<userinput>sed -e 's/user\\///g' | \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;<userinput>while read user; do</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>kolab-formatupgrade \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--user \"${user}\" \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--password <replaceable>$password</replaceable> \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--proxyauth cyrus-admin \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--port 143 \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--encrypt TLS \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput><replaceable>localhost</replaceable></userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;<userinput>done</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The second part upgrades the contents of shared folders. Shared folders have no designated owners, and we can therefore not login as a designated user to upgrade the format."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As the user <literal>cyrus-admin</literal> normally does not have the necessary privileges to insert new messages into mail folders, so we're going to have to give out the rights first. We'll delete them again afterwards."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "# <userinput>kolab sam shared/*@example.org cyrus-admin lrswiptexa</userinput>\n"
+"# <userinput>kolab lm shared/*@example.org | \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;<userinput>while read folder; do</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>kolab-formatupgrade \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--user cyrus-admin \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--password <replaceable>$password</replaceable> \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--port 143 \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--encrypt TLS \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput>--folder \"${folder}\" \\</userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<userinput><replaceable>localhost</replaceable></userinput>\n"
+"&gt;&nbsp;&nbsp;&nbsp;<userinput>done</userinput>\n"
+"# <userinput>kolab dam shared/*@example.org cyrus-admin</userinput>"
+msgstr ""
+