<?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/FAQ</title><revhistory><revision><revnumber>43</revnumber><date>2016-09-13 03:37:37</date><authorinitials>cpe-76-182-123-219.nc.res.rr.com</authorinitials><revremark>Password reset instructions on this page were out of date. Link to the GettingHelp page instead.</revremark></revision><revision><revnumber>42</revnumber><date>2013-01-14 09:24:32</date><authorinitials>ClintonEbadi</authorinitials><revremark>cat</revremark></revision><revision><revnumber>41</revnumber><date>2011-04-30 03:15:46</date><authorinitials>RichardDarst</authorinitials><revremark>Revert to true latest version</revremark></revision><revision><revnumber>40</revnumber><date>2011-04-22 22:50:26</date><authorinitials>ClintonEbadi</authorinitials><revremark>Revert to revision 38.</revremark></revision><revision><revnumber>39</revnumber><date>2011-04-21 16:29:12</date><authorinitials>li243-120.members.linode.com</authorinitials><revremark>L1VSnN  &lt;a href=&quot;http://avfjtuxectow.com/&quot;&gt;avfjtuxectow&lt;/a&gt;</revremark></revision><revision><revnumber>38</revnumber><date>2011-04-21 10:29:14</date><authorinitials>82.160.79.187</authorinitials><revremark>Wow! Great thnkiing! JK</revremark></revision><revision><revnumber>37</revnumber><date>2011-03-30 18:43:22</date><authorinitials>user-0c8h24l.cable.mindspring.com</authorinitials><revremark>remove fyodor migration info</revremark></revision><revision><revnumber>36</revnumber><date>2010-03-29 12:22:09</date><authorinitials>DavorOcelic</authorinitials></revision><revision><revnumber>35</revnumber><date>2010-03-29 12:21:12</date><authorinitials>DavorOcelic</authorinitials></revision><revision><revnumber>34</revnumber><date>2009-11-18 13:30:43</date><authorinitials>DavorOcelic</authorinitials></revision><revision><revnumber>33</revnumber><date>2009-11-18 13:18:38</date><authorinitials>DavorOcelic</authorinitials></revision><revision><revnumber>32</revnumber><date>2008-12-19 00:44:21</date><authorinitials>dhcp-37-70.EECS.Berkeley.EDU</authorinitials></revision><revision><revnumber>31</revnumber><date>2008-12-19 00:36:36</date><authorinitials>dhcp-37-70.EECS.Berkeley.EDU</authorinitials></revision><revision><revnumber>30</revnumber><date>2008-12-19 00:35:11</date><authorinitials>dhcp-37-70.EECS.Berkeley.EDU</authorinitials></revision><revision><revnumber>29</revnumber><date>2008-12-06 00:46:02</date><authorinitials>hgwm3.oceanic.com</authorinitials></revision><revision><revnumber>28</revnumber><date>2008-12-06 00:43:04</date><authorinitials>hgwm3.oceanic.com</authorinitials></revision><revision><revnumber>27</revnumber><date>2008-12-03 16:55:00</date><authorinitials>MichaelOlson</authorinitials><revremark>Add FAQ item about ssh public keys</revremark></revision><revision><revnumber>26</revnumber><date>2008-07-07 04:28:18</date><authorinitials>localhost</authorinitials><revremark>converted to 1.6 markup</revremark></revision><revision><revnumber>25</revnumber><date>2008-01-01 21:27:25</date><authorinitials>AdamChlipala</authorinitials><revremark>Clarify BIND semantics</revremark></revision><revision><revnumber>24</revnumber><date>2007-12-29 02:05:23</date><authorinitials>AdamChlipala</authorinitials><revremark>Domtool hints</revremark></revision><revision><revnumber>23</revnumber><date>2007-12-29 00:09:08</date><authorinitials>AdamChlipala</authorinitials><revremark>Reorganize and add &quot;Internal Server Error&quot;</revremark></revision><revision><revnumber>22</revnumber><date>2007-12-27 04:12:52</date><authorinitials>MichaelOlson</authorinitials><revremark>Add Email quota FAQ item and reword title</revremark></revision><revision><revnumber>21</revnumber><date>2007-12-16 19:08:10</date><authorinitials>RyanMikulovsky</authorinitials><revremark>stress that kinit, krenew can be used in regular shell sessions</revremark></revision><revision><revnumber>20</revnumber><date>2007-12-04 14:27:21</date><authorinitials>MichaelOlson</authorinitials><revremark>Destroy existing tickets for screen FAQ item before acquiring new ones</revremark></revision><revision><revnumber>19</revnumber><date>2007-11-30 13:56:15</date><authorinitials>JustinLeitgeb</authorinitials><revremark>Answer question related to domtool changes from old infrastructure</revremark></revision><revision><revnumber>18</revnumber><date>2007-11-30 05:17:13</date><authorinitials>cpe-66-27-155-248.socal.res.rr.com</authorinitials></revision><revision><revnumber>17</revnumber><date>2007-11-29 14:10:30</date><authorinitials>RyanMikulovsky</authorinitials><revremark>replace &quot;things&quot; with &quot;services&quot;</revremark></revision><revision><revnumber>16</revnumber><date>2007-11-29 14:09:47</date><authorinitials>RyanMikulovsky</authorinitials><revremark>add key phrase permission denied</revremark></revision><revision><revnumber>15</revnumber><date>2007-11-18 17:43:36</date><authorinitials>RyanMikulovsky</authorinitials><revremark>make running screen session on mire sound easy!</revremark></revision><revision><revnumber>14</revnumber><date>2007-11-18 17:40:15</date><authorinitials>RyanMikulovsky</authorinitials><revremark>add part about having commands in its own window</revremark></revision><revision><revnumber>13</revnumber><date>2007-11-18 17:38:11</date><authorinitials>RyanMikulovsky</authorinitials><revremark>add a few more details to the screen session part</revremark></revision><revision><revnumber>12</revnumber><date>2007-11-18 17:34:31</date><authorinitials>MichaelOlson</authorinitials><revremark>No need for pagsh after all</revremark></revision><revision><revnumber>11</revnumber><date>2007-11-18 17:24:25</date><authorinitials>MichaelOlson</authorinitials><revremark>Add kinit command to the screen FAQ, so that it actually works</revremark></revision><revision><revnumber>10</revnumber><date>2007-11-16 22:59:21</date><authorinitials>MichaelOlson</authorinitials><revremark>Remove notice about needing verification</revremark></revision><revision><revnumber>9</revnumber><date>2007-11-16 22:56:46</date><authorinitials>bzq-84-108-20-56.cablep.bezeqint.net</authorinitials></revision><revision><revnumber>8</revnumber><date>2007-11-16 22:54:45</date><authorinitials>bzq-84-108-20-56.cablep.bezeqint.net</authorinitials><revremark>simplified screen example</revremark></revision><revision><revnumber>7</revnumber><date>2007-11-16 22:13:16</date><authorinitials>MichaelOlson</authorinitials><revremark>Use pagsh for now</revremark></revision><revision><revnumber>6</revnumber><date>2007-11-16 21:39:05</date><authorinitials>MichaelOlson</authorinitials><revremark>Add references, and add item for screen and long-lived sessions</revremark></revision><revision><revnumber>5</revnumber><date>2007-11-14 15:24:18</date><authorinitials>MichaelOlson</authorinitials><revremark>clarify apache logs</revremark></revision><revision><revnumber>4</revnumber><date>2007-11-14 15:23:23</date><authorinitials>MichaelOlson</authorinitials><revremark>Add to .domtool explanation</revremark></revision><revision><revnumber>3</revnumber><date>2007-11-14 15:20:27</date><authorinitials>MichaelOlson</authorinitials><revremark>Add apache logs question</revremark></revision><revision><revnumber>2</revnumber><date>2007-11-14 15:13:37</date><authorinitials>MichaelOlson</authorinitials></revision><revision><revnumber>1</revnumber><date>2007-11-14 15:11:45</date><authorinitials>MichaelOlson</authorinitials><revremark>Initial contents</revremark></revision></revhistory></articleinfo><para>This page contains answers to questions often asked about <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/DomTool#">DomTool</ulink> and our setup. </para><section><title>Shell Access</title><section><title>Can I use an ssh public key to log in?</title><para>SSH public key authentication will not work.  This is a consequence of using Kerberos and AFS.  However, you can obtain tickets and tokens on your personal computer (i.e. the machine you're sitting in front of), and use those tickets to log in to mire without using a password.  For more information, see <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/MemberManual/ShellAccess/PasswordlessLogin#">MemberManual/ShellAccess/PasswordlessLogin</ulink>. </para><para>If you would like to know <emphasis>why</emphasis> things are this way, please see <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/MemberManual/DistributedSecurity#">MemberManual/DistributedSecurity</ulink>.  The &quot;short&quot; answer is that sshd public key authentication only works when the fileservers grant admin access to anybody with root access to any of the shell servers; this is a major security risk that we do not take.  </para></section><section><title>How do I run a shell session for a long time on mire?</title><para>If you want to have a long-running session with or without <code>screen</code>, there are simple ways to avoid AFS permission denied errors due to expiring tokens. </para><para>If you don't use screen, just pay attention to the <code>kinit</code> and <code>krenew</code> commands. <code>krenew</code> can be a daemon by using the <code>-b</code> argument. </para><screen><![CDATA[screen
# Once screen has loaded (or you have begun a regular shell session),
# then execute the following commands, or place them in a script.
kdestroy
unlog
kinit -l 10d
krenew -K 540 -t -b]]></screen><para>This will last until the ticket can no longer be renewed (approximately 8 days).  However, you can <code>kinit</code> and <code>krenew</code> again while in the screen session to restart the clock.  If the ticket expires while in a screen session, then you need to repeat those steps while in screen but be sure to add <code>aklog</code> for AFS ticket.  You do not have to restart the screen session.  In fact, you can dedicate a screen window just for monitoring and using <code>kinit</code>, <code>aklog</code>, and <code>krenew</code>. With this simple method, your screen session can run indefinitely with minimal weekly input. </para><para><emphasis>Reference</emphasis>: <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/MemberManual/TransferringFiles/OpenAFS/Debian#">MemberManual/TransferringFiles/OpenAFS/Debian</ulink> </para></section></section><section><title>Domains</title><section><title>I created Domtool configuration for my domain and ran the domtool program on it, but my domain doesn't work at all.</title><para>Did you use the <code>domain</code> directive instead of the <code>dom</code> directive?  <code>domain</code> is the primitive directive, where you must specify all details manually.  If you're using <code>domain</code> and haven't listed the right nameservers manually, then your domain will definitely not work.  Instead, use <code>dom</code>, which includes our current idea of the proper base configuration.  We can change this later without any need for you to change your configuration. </para><para>There are various other ways that you could run afoul of this general problem, which is that <emphasis>our DNS servers won't answer any queries for zones that don't have some nameservers set.</emphasis>  This behavior comes from BIND. </para></section><section><title>I changed my Domtool configuration file, but the changes don't seem to have taken effect.</title><para>You must always rerun the <code>domtool</code> program to publish changes.  You can run it on an individual file, or you can run it without arguments to reload all configuration in your <code>~/.domtool</code> directory. </para></section></section><section><title>Web Sites</title><section><title>How do I read my Apache logs?</title><para>They are stored in <code>~/.logs/apache</code> in subdirectories corresponding to machine and domain, and are updated every 20 minutes. </para><para><emphasis>Reference</emphasis>: <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/MemberManual/ServingWebsites#">MemberManual/ServingWebsites</ulink>. </para></section><section><title>I get a very unhelpful &quot;Internal Server Error&quot; page from Apache when I try to access my dynamic web site content.</title><para>Check <code>error.log</code> in your virtual host's log directory.  See the last answer for where that is. </para></section></section><section><title>E-mail</title><section><title>I can't access my e-mail via IMAP anymore.</title><para>Check your quota on your e-mail volume by doing </para><screen><![CDATA[fs listquota ~/Maildir]]></screen><para>If it is too low, then you will need to <ulink url="https://members.hcoop.net/portal/quota">request an increase in disk quota</ulink>. </para><para><emphasis>Reference</emphasis>: <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/MemberManual/Email#">MemberManual/Email</ulink> </para></section></section><section><title>Custom Daemons</title><section><title>Services that worked fine yesterday suddenly don't work anymore.</title><para>The most likely reason for IMAP, DNS, and web hosting to suddenly stop working is that there is a syntax error in one of the files in your <code>~/.domtool</code> directory.  Admins sometimes need to regenerate all domtool configuration files after making a change to domtool; if one of the files in your <code>~/.domtool</code> directory has errors, it could prevent other files in that directory from being activated. </para><para>To figure out whether this was the problem: for each file <emphasis role="strong">&lt;FILE&gt;</emphasis> in your <code>~/.domtool</code> directory, run </para><screen><![CDATA[domtool -tc ~/.domtool/<FILE>]]></screen><para>If you see any problems, either move the file into a different directory, or fix the problems. </para><para>When done, run <emphasis role="strong">domtool</emphasis> on each file in your <code>~/.domtool</code> directory, and everything should be back to normal. </para><para>It is highly recommended to keep files in a different directory while testing them, and then copy them to <code>~/.domtool</code> once you are certain that they are error-free. </para><para>If you don't find any errors in your domtool configuration, then you might want to file a support request. </para><para><emphasis>Reference</emphasis>: <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/MemberManual/UsingDomtool#">MemberManual/UsingDomtool</ulink>. </para></section></section><section><title>Password recovery</title><para>If you've forgotten your HCoop password, please see that <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/MemberManual/GettingHelp#Account_Problems">password reset instructions</ulink> </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="https://wiki.hcoop.net/MemberManual/FAQ/CategoryMemberManual#">CategoryMemberManual</ulink> </para></section></article>