#pragma section-numbers off This page contains answers to questions often asked about DomTool and our setup. [[TableOfContents]] = Shell Access = == How do I run a shell session for a long time on mire? == If you want to have a long-running session with or without {{{screen}}}, there are simple ways to avoid AFS permission denied errors due to expiring tokens. If you don't use screen, just pay attention to the `kinit` and `krenew` commands. `krenew` can be a daemon by using the `-b` argument. {{{ 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 }}} This will last until the ticket can no longer be renewed (approximately 8 days). However, you can `kinit` and `krenew` 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 `aklog` 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 `kinit`, `aklog`, and `krenew`. With this simple method, your screen session can run indefinitely with minimal weekly input. ''Reference'': ["MemberManual/TransferringFiles/OpenAFS/Debian"] = Domains = == I created Domtool configuration for my domain and ran the domtool program on it, but my domain doesn't work at all. == Did you use the `domain` directive instead of the `dom` directive? `domain` is the primitive directive, where you must specify all details manually. If you're using `domain` and haven't listed the right nameservers manually, then your domain will definitely not work. Instead, use `dom`, which includes our current idea of the proper base configuration. We can change this later without any need for you to change your configuration. == I changed my Domtool configuration file, but the changes don't seem to have taken effect. == You must always rerun the `domtool` 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 `~/.domtool` directory. = Web Sites = == How do I read my Apache logs? == They are stored in {{{~/.logs/apache}}} in subdirectories corresponding to machine and domain, and are updated every 20 minutes. ''Reference'': MemberManual/ServingWebsites. == I get a very unhelpful "Internal Server Error" page from Apache when I try to access my dynamic web site content. == Check `error.log` in your virtual host's log directory. See the last answer for where that is. = E-mail = == I can't access my e-mail via IMAP anymore. == Check your quota on your e-mail volume by doing {{{ fs listquota ~/Maildir }}} If it is too low, then you will need to [https://members.hcoop.net/portal/quota request an increase in disk quota]. ''Reference'': ["MemberManual/Email"] = Custom Daemons = == Services that worked fine yesterday suddenly don't work anymore. == 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 {{{~/.domtool}}} directory. Admins sometimes need to regenerate all domtool configuration files after making a change to domtool; if one of the files in your {{{~/.domtool}}} directory has errors, it could prevent other files in that directory from being activated. To figure out whether this was the problem: for each file '''''' in your {{{~/.domtool}}} directory, run {{{ domtool -tc ~/.domtool/ }}} If you see any problems, either move the file into a different directory, or fix the problems. When done, run '''domtool''' on each file in your {{{~/.domtool}}} directory, and everything should be back to normal. It is highly recommended to keep files in a different directory while testing them, and then copy them to {{{~/.domtool}}} once you are certain that they are error-free. If you don't find any errors in your domtool configuration, then you might want to file a support request. ''Reference'': MemberManual/UsingDomtool. = Migration from Our Old Servers (for members who joined before December 2007) = == Can I copy my Domtool configuration verbatim from Fyodor? == No. Domtool has changed significantly from the version used in our old infrastructure on Fyodor. Please see the page MemberManual/UsingDomtool for instructions related to the most recent version of Domtool.