<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>MemberManual/MigrationGuide</title><revhistory><revision><revnumber>114</revnumber><date>2012-12-17 21:12:48</date><authorinitials>ClintonEbadi</authorinitials><revremark>this is leftover information from the fyodor -&gt; peer1 transition!</revremark></revision><revision><revnumber>113</revnumber><date>2008-12-03 16:49:37</date><authorinitials>MichaelOlson</authorinitials></revision><revision><revnumber>112</revnumber><date>2008-07-07 04:27:56</date><authorinitials>localhost</authorinitials><revremark>converted to 1.6 markup</revremark></revision><revision><revnumber>111</revnumber><date>2008-05-14 23:50:18</date><authorinitials>MichaelOlson</authorinitials><revremark>s/mail2/mail/</revremark></revision><revision><revnumber>110</revnumber><date>2008-04-08 12:48:04</date><authorinitials>AdamChlipala</authorinitials><revremark>Update status</revremark></revision><revision><revnumber>109</revnumber><date>2007-12-15 17:22:10</date><authorinitials>AdamChlipala</authorinitials><revremark>members2 -&gt; members</revremark></revision><revision><revnumber>108</revnumber><date>2007-12-09 02:26:29</date><authorinitials>ClintonEbadi</authorinitials><revremark>bolded note to delete the shared-folders subdir since it is important and easy to miss visually</revremark></revision><revision><revnumber>107</revnumber><date>2007-12-09 01:13:06</date><authorinitials>MichaelOlson</authorinitials><revremark>Mention removing shared maildir stuff</revremark></revision><revision><revnumber>106</revnumber><date>2007-11-28 18:29:26</date><authorinitials>MichaelOlson</authorinitials><revremark>remove link to migrated page, add migration end date</revremark></revision><revision><revnumber>105</revnumber><date>2007-11-25 04:47:47</date><authorinitials>RyanMikulovsky</authorinitials></revision><revision><revnumber>104</revnumber><date>2007-11-22 22:05:52</date><authorinitials>MichaelOlson</authorinitials><revremark>Change day to today</revremark></revision><revision><revnumber>103</revnumber><date>2007-11-21 02:37:10</date><authorinitials>RyanMikulovsky</authorinitials><revremark>fix a typo</revremark></revision><revision><revnumber>102</revnumber><date>2007-11-21 02:08:39</date><authorinitials>MichaelOlson</authorinitials><revremark>Commence the forced migration period!</revremark></revision><revision><revnumber>101</revnumber><date>2007-11-16 23:35:06</date><authorinitials>MichaelOlson</authorinitials><revremark>Add MoinMoin quickie</revremark></revision><revision><revnumber>100</revnumber><date>2007-11-16 23:33:17</date><authorinitials>MichaelOlson</authorinitials><revremark>Add mailman info, remove mailman and moin bugs</revremark></revision><revision><revnumber>99</revnumber><date>2007-11-13 17:48:14</date><authorinitials>MichaelOlson</authorinitials><revremark>Link to bug reports</revremark></revision><revision><revnumber>98</revnumber><date>2007-11-13 17:43:56</date><authorinitials>MichaelOlson</authorinitials><revremark>Define migration status more specifically, and list some known issues that must be addressed</revremark></revision><revision><revnumber>97</revnumber><date>2007-11-12 07:36:57</date><authorinitials>MichaelOlson</authorinitials><revremark>Minor typos</revremark></revision><revision><revnumber>96</revnumber><date>2007-11-12 06:39:58</date><authorinitials>RyanMikulovsky</authorinitials></revision><revision><revnumber>95</revnumber><date>2007-11-12 03:28:30</date><authorinitials>MichaelOlson</authorinitials></revision><revision><revnumber>94</revnumber><date>2007-11-12 03:26:34</date><authorinitials>MichaelOlson</authorinitials><revremark>Revamp.  Almost ready for forced migration.</revremark></revision><revision><revnumber>93</revnumber><date>2007-11-11 22:30:03</date><authorinitials>RyanMikulovsky</authorinitials></revision><revision><revnumber>92</revnumber><date>2007-11-11 22:28:28</date><authorinitials>RyanMikulovsky</authorinitials><revremark>remove portion that was put into the Manual</revremark></revision><revision><revnumber>91</revnumber><date>2007-11-11 19:50:30</date><authorinitials>RyanMikulovsky</authorinitials><revremark>one too many 'the'</revremark></revision><revision><revnumber>90</revnumber><date>2007-11-11 04:57:06</date><authorinitials>RyanMikulovsky</authorinitials><revremark>clarify fyodor domtool dir</revremark></revision><revision><revnumber>89</revnumber><date>2007-11-11 04:38:36</date><authorinitials>RyanMikulovsky</authorinitials><revremark>expand a little on migration strategy</revremark></revision><revision><revnumber>88</revnumber><date>2007-11-11 03:39:49</date><authorinitials>MichaelOlson</authorinitials></revision><revision><revnumber>87</revnumber><date>2007-11-11 03:38:55</date><authorinitials>MichaelOlson</authorinitials></revision><revision><revnumber>86</revnumber><date>2007-11-11 03:37:44</date><authorinitials>MichaelOlson</authorinitials><revremark>no periods in subdomain</revremark></revision><revision><revnumber>85</revnumber><date>2007-11-11 03:12:17</date><authorinitials>MichaelOlson</authorinitials><revremark>Document how to try out new servers on a subdomain</revremark></revision><revision><revnumber>84</revnumber><date>2007-11-06 06:00:38</date><authorinitials>RyanMikulovsky</authorinitials><revremark>wiki link oops</revremark></revision><revision><revnumber>83</revnumber><date>2007-11-06 05:58:59</date><authorinitials>RyanMikulovsky</authorinitials><revremark>OpenAFS section replaced with link to OpenAFS subpage</revremark></revision><revision><revnumber>82</revnumber><date>2007-11-01 21:28:34</date><authorinitials>MichaelOlson</authorinitials><revremark>Remove email-specific stuff</revremark></revision><revision><revnumber>81</revnumber><date>2007-11-01 19:24:43</date><authorinitials>MichaelOlson</authorinitials><revremark>Turn sect numbers off</revremark></revision><revision><revnumber>80</revnumber><date>2007-10-26 01:53:33</date><authorinitials>71.179.100.190</authorinitials></revision><revision><revnumber>79</revnumber><date>2007-10-25 17:30:35</date><authorinitials>DavorOcelic</authorinitials></revision><revision><revnumber>78</revnumber><date>2007-10-25 04:40:11</date><authorinitials>MichaelOlson</authorinitials></revision><revision><revnumber>77</revnumber><date>2007-10-24 22:42:49</date><authorinitials>AdamChlipala</authorinitials><revremark>Update to simplified instructions</revremark></revision><revision><revnumber>76</revnumber><date>2007-10-15 11:17:39</date><authorinitials>MichaelOlson</authorinitials><revremark>Use listacl/setacl instead of la/sa for consistency</revremark></revision><revision><revnumber>75</revnumber><date>2007-10-15 00:42:45</date><authorinitials>MichaelOlson</authorinitials><revremark>Add back accidentally reverted text</revremark></revision><revision><revnumber>74</revnumber><date>2007-10-15 00:40:29</date><authorinitials>MichaelOlson</authorinitials><revremark>Clarify example in &quot;Securing directories&quot; section</revremark></revision><revision><revnumber>73</revnumber><date>2007-10-15 00:33:06</date><authorinitials>AdamChlipala</authorinitials><revremark>Clarify AFS permissions</revremark></revision><revision><revnumber>72</revnumber><date>2007-09-30 18:27:11</date><authorinitials>RyanMikulovsky</authorinitials><revremark>the in the wrong place.</revremark></revision><revision><revnumber>71</revnumber><date>2007-09-30 18:23:45</date><authorinitials>RyanMikulovsky</authorinitials><revremark>small addition to email section.</revremark></revision><revision><revnumber>70</revnumber><date>2007-09-30 18:20:06</date><authorinitials>RyanMikulovsky</authorinitials><revremark>SpamAssassin</revremark></revision><revision><revnumber>69</revnumber><date>2007-09-29 19:41:37</date><authorinitials>RyanMikulovsky</authorinitials><revremark>openafs...</revremark></revision><revision><revnumber>68</revnumber><date>2007-09-20 23:51:01</date><authorinitials>RyanMikulovsky</authorinitials><revremark>slightly more detail on USER.daemon principle</revremark></revision><revision><revnumber>67</revnumber><date>2007-09-20 23:22:45</date><authorinitials>RyanMikulovsky</authorinitials><revremark>mention USER.daemon for Apache</revremark></revision><revision><revnumber>66</revnumber><date>2007-09-20 23:11:47</date><authorinitials>AdamChlipala</authorinitials><revremark>Web sites</revremark></revision><revision><revnumber>65</revnumber><date>2007-09-17 11:01:44</date><authorinitials>MichaelOlson</authorinitials><revremark>Fix some typos in Log-In Security and s/he/they/</revremark></revision><revision><revnumber>64</revnumber><date>2007-09-17 01:55:45</date><authorinitials>MichaelOlson</authorinitials><revremark>Mention squirrelmail</revremark></revision><revision><revnumber>63</revnumber><date>2007-09-16 16:03:28</date><authorinitials>RyanMikulovsky</authorinitials></revision><revision><revnumber>62</revnumber><date>2007-09-16 15:43:22</date><authorinitials>213.147.110.16</authorinitials></revision><revision><revnumber>61</revnumber><date>2007-09-16 09:47:00</date><authorinitials>213.147.110.16</authorinitials></revision><revision><revnumber>60</revnumber><date>2007-09-15 16:16:01</date><authorinitials>RyanMikulovsky</authorinitials><revremark>move DenyHosts under SSH Login section</revremark></revision><revision><revnumber>59</revnumber><date>2007-09-15 14:35:15</date><authorinitials>AdamChlipala</authorinitials><revremark>Remove socket permissions warning</revremark></revision><revision><revnumber>58</revnumber><date>2007-09-15 14:16:10</date><authorinitials>MichaelOlson</authorinitials><revremark>Spelling and misc. clarifications</revremark></revision><revision><revnumber>57</revnumber><date>2007-09-15 13:27:51</date><authorinitials>AdamChlipala</authorinitials><revremark>public_html CGI</revremark></revision><revision><revnumber>56</revnumber><date>2007-09-15 13:16:58</date><authorinitials>schmagr1fe07-dmz.mycingular.net</authorinitials><revremark>s/mire password/New password/; fix some bad text relocations</revremark></revision><revision><revnumber>55</revnumber><date>2007-09-15 01:54:56</date><authorinitials>t0rch</authorinitials><revremark>Add comment about needing socket permission to do step 5</revremark></revision><revision><revnumber>54</revnumber><date>2007-09-14 15:44:03</date><authorinitials>RyanMikulovsky</authorinitials><revremark>add info about public_html ACL and expand public_html section</revremark></revision><revision><revnumber>53</revnumber><date>2007-09-14 15:30:40</date><authorinitials>RyanMikulovsky</authorinitials></revision><revision><revnumber>52</revnumber><date>2007-09-14 15:26:18</date><authorinitials>adsl-75-7-153-107.dsl.chi2ca.sbcglobal.net</authorinitials><revremark>remove unnecessary word</revremark></revision><revision><revnumber>51</revnumber><date>2007-09-14 15:25:44</date><authorinitials>adsl-75-7-153-107.dsl.chi2ca.sbcglobal.net</authorinitials></revision><revision><revnumber>50</revnumber><date>2007-09-14 15:24:51</date><authorinitials>adsl-75-7-153-107.dsl.chi2ca.sbcglobal.net</authorinitials></revision><revision><revnumber>49</revnumber><date>2007-09-14 13:37:46</date><authorinitials>bzq-84-108-20-56.cablep.bezeqint.net</authorinitials></revision><revision><revnumber>48</revnumber><date>2007-09-14 08:12:28</date><authorinitials>MichaelOlson</authorinitials><revremark>Migrate changes</revremark></revision><revision><revnumber>47</revnumber><date>2007-08-27 23:32:57</date><authorinitials>RyanMikulovsky</authorinitials><revremark>update status of migration</revremark></revision><revision><revnumber>46</revnumber><date>2007-08-27 15:16:31</date><authorinitials>MichaelOlson</authorinitials><revremark>Clarify that list should be contacted if erroneously added to blacklist</revremark></revision><revision><revnumber>45</revnumber><date>2007-08-25 19:24:36</date><authorinitials>RyanMikulovsky</authorinitials><revremark>hcoop-announcements -&gt; hcoop-announce</revremark></revision><revision><revnumber>44</revnumber><date>2007-08-25 18:44:03</date><authorinitials>RyanMikulovsky</authorinitials><revremark>update migration status</revremark></revision><revision><revnumber>43</revnumber><date>2007-08-19 04:50:36</date><authorinitials>RyanMikulovsky</authorinitials><revremark>slight update of current mire situation</revremark></revision><revision><revnumber>42</revnumber><date>2007-08-02 20:23:58</date><authorinitials>RyanMikulovsky</authorinitials><revremark>include a status for curious people that may not be subscribed to mailing lists</revremark></revision><revision><revnumber>41</revnumber><date>2007-07-08 02:17:33</date><authorinitials>AdamChlipala</authorinitials><revremark>hcoop-sysadmin -&gt; admins</revremark></revision><revision><revnumber>40</revnumber><date>2007-07-05 11:21:58</date><authorinitials>t0rch</authorinitials></revision><revision><revnumber>39</revnumber><date>2007-07-04 19:57:38</date><authorinitials>RyanMikulovsky</authorinitials><revremark>add WebDAV</revremark></revision><revision><revnumber>38</revnumber><date>2007-07-04 19:39:08</date><authorinitials>RyanMikulovsky</authorinitials><revremark>readd ssh section for additional details</revremark></revision><revision><revnumber>37</revnumber><date>2007-07-04 19:37:37</date><authorinitials>RyanMikulovsky</authorinitials><revremark>make denyhost stuff a little less precise...</revremark></revision><revision><revnumber>36</revnumber><date>2007-07-04 19:31:45</date><authorinitials>RyanMikulovsky</authorinitials><revremark>move ssh security to log-in security, add denyhost details</revremark></revision><revision><revnumber>35</revnumber><date>2007-07-04 14:51:42</date><authorinitials>MichaelOlson</authorinitials><revremark>Re-org slightly, add ssh section</revremark></revision><revision><revnumber>34</revnumber><date>2007-07-02 16:12:39</date><authorinitials>AdamChlipala</authorinitials><revremark>dbtool grant</revremark></revision><revision><revnumber>33</revnumber><date>2007-06-26 22:27:45</date><authorinitials>RyanMikulovsky</authorinitials><revremark>modified to reflect list only default of $HOME</revremark></revision><revision><revnumber>32</revnumber><date>2007-06-26 05:49:04</date><authorinitials>RyanMikulovsky</authorinitials><revremark>extraneous S on ACL</revremark></revision><revision><revnumber>31</revnumber><date>2007-06-26 05:48:08</date><authorinitials>RyanMikulovsky</authorinitials><revremark>add a detail about UNIX file permissions being useless</revremark></revision><revision><revnumber>30</revnumber><date>2007-06-26 05:28:17</date><authorinitials>RyanMikulovsky</authorinitials><revremark>add preliminary ACL security stuff.</revremark></revision><revision><revnumber>29</revnumber><date>2007-06-25 02:10:27</date><authorinitials>RyanMikulovsky</authorinitials></revision><revision><revnumber>28</revnumber><date>2007-06-24 21:57:29</date><authorinitials>AdamChlipala</authorinitials><revremark>dropdb</revremark></revision><revision><revnumber>27</revnumber><date>2007-06-23 21:04:50</date><authorinitials>AdamChlipala</authorinitials><revremark>vmail</revremark></revision><revision><revnumber>26</revnumber><date>2007-06-22 15:25:46</date><authorinitials>AdamChlipala</authorinitials><revremark>Bugzilla is ON</revremark></revision><revision><revnumber>25</revnumber><date>2007-06-03 18:59:06</date><authorinitials>AdamMegacz</authorinitials></revision><revision><revnumber>24</revnumber><date>2007-06-03 18:58:14</date><authorinitials>AdamMegacz</authorinitials></revision><revision><revnumber>23</revnumber><date>2007-06-03 18:57:44</date><authorinitials>AdamMegacz</authorinitials></revision><revision><revnumber>22</revnumber><date>2007-06-03 18:57:27</date><authorinitials>AdamMegacz</authorinitials></revision><revision><revnumber>21</revnumber><date>2007-06-03 18:56:46</date><authorinitials>AdamMegacz</authorinitials></revision><revision><revnumber>20</revnumber><date>2007-06-03 18:56:03</date><authorinitials>AdamMegacz</authorinitials></revision><revision><revnumber>19</revnumber><date>2007-06-03 01:02:53</date><authorinitials>AdamChlipala</authorinitials><revremark>Refactor log-in part</revremark></revision><revision><revnumber>18</revnumber><date>2007-06-03 00:57:44</date><authorinitials>AdamChlipala</authorinitials><revremark>No ssh pub key</revremark></revision><revision><revnumber>17</revnumber><date>2007-06-03 00:36:52</date><authorinitials>netblock-68-183-25-2.dslextreme.com</authorinitials></revision><revision><revnumber>16</revnumber><date>2007-06-03 00:34:42</date><authorinitials>AdamChlipala</authorinitials><revremark>Portal passwords and Bugzilla</revremark></revision><revision><revnumber>15</revnumber><date>2007-06-02 19:07:34</date><authorinitials>adsl-70-237-15-244.dsl.chi2ca.sbcglobal.net</authorinitials><revremark>mysql and psql access to deleuze</revremark></revision><revision><revnumber>14</revnumber><date>2007-06-02 19:06:42</date><authorinitials>adsl-70-237-15-244.dsl.chi2ca.sbcglobal.net</authorinitials></revision><revision><revnumber>13</revnumber><date>2007-06-02 15:03:45</date><authorinitials>AdamChlipala</authorinitials><revremark>Account creation</revremark></revision><revision><revnumber>12</revnumber><date>2007-05-29 14:59:49</date><authorinitials>MichaelOlson</authorinitials><revremark>Add thunderbird note</revremark></revision><revision><revnumber>11</revnumber><date>2007-05-29 14:30:39</date><authorinitials>MichaelOlson</authorinitials><revremark>no normal pop3</revremark></revision><revision><revnumber>10</revnumber><date>2007-05-29 02:58:22</date><authorinitials>MichaelOlson</authorinitials><revremark>Flesh out email section</revremark></revision><revision><revnumber>9</revnumber><date>2007-05-29 01:26:25</date><authorinitials>MichaelOlson</authorinitials><revremark>Add note for megacz</revremark></revision><revision><revnumber>8</revnumber><date>2007-05-29 00:49:01</date><authorinitials>MichaelOlson</authorinitials><revremark>Fix typo</revremark></revision><revision><revnumber>7</revnumber><date>2007-05-29 00:48:41</date><authorinitials>MichaelOlson</authorinitials><revremark>Add TOC, alphabetize, and add a few sections</revremark></revision><revision><revnumber>6</revnumber><date>2007-05-23 03:59:37</date><authorinitials>AdamChlipala</authorinitials><revremark>dbtool</revremark></revision><revision><revnumber>5</revnumber><date>2007-05-18 04:51:50</date><authorinitials>AdamChlipala</authorinitials><revremark>Revert to revision 3.</revremark></revision><revision><revnumber>4</revnumber><date>2007-05-17 20:35:17</date><authorinitials>AdamChlipala</authorinitials><revremark>Revert to revision 2.</revremark></revision><revision><revnumber>3</revnumber><date>2007-05-17 18:05:26</date><authorinitials>cpe-76-180-90-92.buffalo.res.rr.com</authorinitials><revremark>changed proper nameservers to ns1 and ns3</revremark></revision><revision><revnumber>2</revnumber><date>2007-05-17 04:47:24</date><authorinitials>RobinTempleton</authorinitials><revremark>rsync -a</revremark></revision><revision><revnumber>1</revnumber><date>2007-05-17 02:21:41</date><authorinitials>AdamChlipala</authorinitials></revision></revhistory></articleinfo><warning><para>This page is historical information from the migration to Peer1 in 2006. For information on migrating to Navajos and Bog, see <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/NavajosBogMigrationGuide#">NavajosBogMigrationGuide</ulink> instead. </para></warning><para>This page describes the steps that members using the old machines need to take in order to migrate to the new machines. </para><para>For the purposes of this page, we'll use the name New to refer to the servers hosted at Peer 1 (which are deleuze, mire, and eventually abulafia and krunk) and Old to refer to any servers that we've used previously. </para><section><title>Status of Migration</title><para>Everyone has been migrated to the new machines.  People who haven't finished this yet are holding up the works and should get their acts together.  A deadline of Monday, April 14, was announced by e-mail.  If you aren't migrated by then, your service may be degraded arbitrarily. </para></section><section><title>Summary of what exactly is going on here</title><para>Having an account on our new machines will allow you to have full access to your space in AFS (currently 400MB per user) and the ability to log in to <code>mire.hcoop.net</code> via ssh. </para><para>Requesting an account on the new infrastructure will not affect your fyodor account.  You will have access to both accounts until after all migration is complete. </para></section><section><title>Getting started</title><section><title>Step 1: Get a New account</title><orderedlist numeration="arabic"><listitem><para>ssh to <code>hcoop.net</code> as usual. </para></listitem><listitem><para>Run this command line: <code>migrationpw</code> </para></listitem><listitem><para>Follow the on-screen directions. </para></listitem><listitem><para>Wait for an e-mail from the user creation script.  (This stage requires that a human run the script periodically to watch for failures, but one of us should run it several times a day.) </para></listitem></orderedlist><para>The password you set will go into our new Kerberos database, allowing log-in to mire and any other of our servers that we choose to enable for non-admin shell access.  You will also use this password for authentication to other services, like e-mail and members-only HCoop web sites. </para><para>An e-mail will be sent to your HCoop account to let you know that your account has been created.  Be sure to memorize your password, as it won't be saved anywhere unencrypted once the account creation script runs! </para></section><section><title>Step 2: Try logging in</title><para>Now you may attempt to login to <code>mire.hcoop.net</code> using your favorite SSH client or the new AJAX SSH service at <ulink url="http://ssh.hcoop.net/"/>.  The latter requires a modern browser that cooperates with AJAX. </para><section><title>SSH Public Key is Obsoleted</title><para>You can no longer use SSH public key authentication.  Kerberos authentication (&quot;<code>ssh -K</code>&quot;) <emphasis>is</emphasis> supported, for passwordless log-in.  Some day, someone might implement the Kerberos support needed to make SSH public key auth work again.  See <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual/DistributedSecurity#">MemberManual/DistributedSecurity</ulink> for more information on all of this. </para><para>That being said, if you've always been typing a password to log in via SSH and don't care to do otherwise, then you don't need to bother reading this section! </para></section><section><title>DenyHosts</title><para>If you fail to log in correctly quite a few times, the DenyHosts scripts might lock you out.  Currently any blocked IP's are purged after a week, so if you don't want to wait you'll need to submit a ticket, or if you can't access the portal to do this you'll need to send an email to <code>&lt;admins AT hcoop DOT net&gt;</code>. </para></section></section><section><title>Step 3: Visit the new portal</title><para><ulink url="https://members.hcoop.net/">The new portal</ulink> uses the same password you use to log in to mire.  That is, if you haven't created a New account yet, then you can't access the new portal. </para><para>You should use the new portal for all administrative requests, except for the specialized request types (e.g., domains, firewall rules, etc.) when they relate to fyodor. </para></section><section><title>Step 4: Have your mail dual-delivered</title><para>We recommend that you tell fyodor to <emphasis>dual-deliver</emphasis> all of your mail so that one copy goes to deleuze (our new main server) and one copy goes to fyodor.  That way you can start reading your email via deleuze, but if anything goes wrong you can just switch back to fyodor. </para><para>To do this, put the following lines in your <code>~/.forward</code> file <emphasis>on fyodor</emphasis>.  Note that the comment on the first line is <emphasis role="strong">mandatory</emphasis> -- it tells exim that this forward file uses special exim features.  If your username was <code>fred</code>, you would put this in your <code>~/.forward</code>: </para><screen><![CDATA[  # Exim filter
  deliver fred
  deliver fred@deleuze.hcoop.net]]></screen><para>and you mail will be dual-delivered. </para></section><section><title>Step 5: Copy your existing email</title><para>You can also copy the contents of your mailboxes from fyodor to mire (actually to our shared AFS filesystem by way of mire).  To do this, log in to fyodor and type the following. </para><screen><![CDATA[  rsync -are ssh --no-g --progress --verbose ~/Maildir/ mire.hcoop.net:Maildir/]]></screen><para>Then log into mire and <emphasis role="strong">remove the <code>~/Maildir/shared-folders</code> directory, if it exists</emphasis>.  Also, change the contents of <code>~/Maildir/shared-maildirs</code> on mire to: </para><screen><![CDATA[SpamAssassin    /var/local/lib/spamd/Maildir]]></screen></section></section><section><title>Migration strategy</title><section><title>Making a subdomain on fyodor and pointing it at mire</title><para>It is possible to test out your setup on the new servers by making a new subdomin on the old machine that points to the new machine.  This way you can hone your new setup until it's as good as the old, while still having access to the old. </para><para>First, make a directory in your <code>/etc/domains/TLD/DOMAIN</code> folder on the old machine.  <emphasis role="strong">TLD</emphasis> is the Top-Level Domain of your domain.  For example, it might be <code>com</code>, <code>net</code>, <code>us</code>, <code>in</code> etc.  <emphasis role="strong">DOMAIN</emphasis> is your domain, and <emphasis role="strong">SUB</emphasis> is the new subdomain that you would like to use.  <emphasis role="strong">SUB</emphasis> should not include any of the text in <emphasis role="strong">DOMAIN</emphasis>, and should have no periods. </para><screen><![CDATA[mkdir /etc/domains/TLD/DOMAIN/SUB]]></screen><para>In that directory, make a file called <code>.dns</code> with the following contents. </para><screen><![CDATA[Primary         ns      ns
Default         69.90.123.68]]></screen><para>Then, run the <code>domtool</code> command to finalize your changes on Fyodor. </para><para>Now request control of the <emphasis role="strong">DOMAIN</emphasis> using the new portal (<ulink url="http://members.hcoop.net"/>).  When you receive notification of control, you can then log into mire.hcoop.net and configure <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/DomTool#">DomTool</ulink> so that Apache knows it can serve your <emphasis role="strong">SUB</emphasis>domain. Please take a look at <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual/UsingDomtool#">using DomTool</ulink>, the <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/DomTool/UserGuide#">DomTool user guide</ulink>, and <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/DomTool/Examples#">DomTool examples</ulink> to learn how to do this.  You'll probably want to take a look at the <code>vhost</code> directive. </para></section></section><section><title>Quickies</title><para>Be sure to read through the chapters of the <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual#">MemberManual</ulink> that interest you.  The following are some very quick overviews of things that have changed. </para><section><title>DNS</title><para>We are purposely not sending any DNS data from Old to New, which means that you need to change domains at your registrar if you want New to be authoritative for them.  The proper nameservers are <code>ns1.hcoop.net</code> and <code>ns3.hcoop.net</code>, in that order.  Keeping <code>ns.hcoop.net</code> and <code>ns2.hcoop.net</code> <emphasis role="strong">will not work</emphasis>. </para></section><section><title>Domains</title><para>See the <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/DomTool#">DomTool</ulink> page for instructions on managing your domains with the new setup.  The configuration files are in a vastly different format, but they have a better-defined syntax that should be relatively easy to understand. </para></section><section><title>Home</title><para>Your home directory is now managed by AFS.  You will enter it by default when logging in to <code>mire.hcoop.net</code> via ssh.  Type <code>pwd</code> to see what the path is.  It will look like <code>/afs/hcoop.net/user/u/us/username</code>.  Some directories have been created for you already, so that they have the correct permissions for things like serving web pages and delivering mail. </para></section><section><title>OpenAFS and permissions</title><para>First of all, UNIX permissions carry no weight with AFS -- therefore they are useless to you.  Instead, use Access Control Lists (ACL), which are a far more powerful way of restricting access to parts of a file tree.  Read <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual/GettingStarted#">MemberManual/GettingStarted</ulink> for further information on AFS concepts. </para><para>See the <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual/TransferringFiles/OpenAFS#">OpenAFS</ulink> subpage to find installation directions for various operating systems. </para></section><section><title>Mailman</title><para>See the <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual/Email/MailingLists#">Mailing Lists page</ulink> for details, including how to migrate existing lists to the new machines. </para></section><section><title>MoinMoin</title><para>See the <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual/ServingWebsites/MoinMoin#">MoinMoin configuration page</ulink> for details on how to set up <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MoinMoin#">MoinMoin</ulink> and how to migrate data to match the new version of <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MoinMoin#">MoinMoin</ulink> that we have installed. </para></section><section><title>rsync</title><para>If you're using rsync to transfer data to the new servers, the &quot;-a&quot; option by itself won't work properly because rsync attempts to chgrp the transferred files. Use &quot;-a --no-g&quot; instead of &quot;-a&quot;. </para></section><section><title>WebDAV</title><para>WebDAV is accessible at <ulink url="https://dav.hcoop.net/"/>.  WebDAV is useful when working on a website using systems that cannot mount an AFS share.  For details on how to setup WebDAV, take a look at <ulink url="http://research.cs.berkeley.edu/doc/dav/"/> </para><para>Note that you can only use WebDAV on directories that have <code>system:anyuser rl</code> as part of its ACL.  You'll be able to write even if <code>system:anyuser</code> does not. </para></section><section><title>webmail</title><para>A Squirrelmail instance for reading your email on the new servers is available at <ulink url="https://mail.hcoop.net/"/>. </para></section><section><title>Web sites</title><para>Your <code>~/public_html</code> directory is available via HTTP through <code>http://deleuze.hcoop.net/~USER/</code>. Eventually this will change to <code>http://hcoop.net/~USER/</code>. </para><para>Due to consequences of AFS authentication, we don't plan to allow dynamic content (CGI, PHP, etc.) via hcoop.net/~you/... on New.  If you don't have a domain hosted at HCoop, but want to serve dynamic content, then you can request an hcoop.net subdomain (example: <code>USER.hcoop.net</code>, where USER is your username) via <ulink url="http://bugzilla.hcoop.net/"/>. See the chapter on <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/MemberManual/ServingWebsites#">Serving Websites</ulink> for more details. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="https://wiki.hcoop.net/MemberManual/MigrationGuide/CategoryHistorical#">CategoryHistorical</ulink> </para></section></section></article>