|
|
| Line 1: |
Line 1: |
| - | ==== How to administer your Gentoo system ====
| + | This page has been moved to [http://www.kurobox.com/mwiki/index.php?title=Administer_Your_Gentoo_System here] |
| - | | + | |
| - | This document is not meant to become a generic Gentoo administration guide, but more to collect a few tricks specific to the usage of the distribution on a Kurobox. For a more general documentation, please refer to the official documentation, in particular: | + | |
| - | | + | |
| - | * Part II of the Gentoo Handbook
| + | |
| - | * The excellent Gentoo security guide
| + | |
| - | * The Gentoo Samba howto, and many other specific guides.
| + | |
| - | | + | |
| - | | + | |
| - | __TOC__
| + | |
| - | | + | |
| - | == Environmental files ==
| + | |
| - | Now is a good time to set up your ''~/.bashrc'' (configuration for shell) file. Every administrator has their own preferencies, but at a very minimum, I'd suggest the following:
| + | |
| - | export EDITOR=vi
| + | |
| - | export CVS_RSH=ssh
| + | |
| - | export TERM=vt100
| + | |
| - | alias ls="ls -hqp --color"
| + | |
| - | alias c=clear
| + | |
| - | alias r="fc -e - "
| + | |
| - | | + | |
| - | Change '''<code>vi</code>''' to your prefered editor. You might want to change '''<code>TERM</code>''', too. The '''<code>ls</code>''' alias line produces a more readable output (and coloured, too). You can use '''<code>fc -l</code>''' to list recent commands and '''<code>r</code>''' to repeat them ('''<code>r</code>''' repeats the last, '''<code>r foo</code>''' repeats the last command beginning '''<code>foo</code>''' and '''<code>r nnn</code>''' repeats command number '''<code>nnn</code>''' from the '''<code>fc -l</code>''' output). '''<code>c</code>''' clears the terminal window.
| + | |
| - | | + | |
| - | == How to install binary packages ==
| + | |
| - | The Gentoo/Kuro project will try to provide up-to-date binary packages for some commonly used applications that take much time to compile on a Kurobox (like apache, mysql, etc.)
| + | |
| - | Using binary packages may seems unusual on a Gentoo system, but is actually really easy. In ''/etc/make.conf'', declare the hosts of binaries you want to use:
| + | |
| - | PORTAGE_BINHOST="http://tdegreni.free.fr/kurobox/packages/"
| + | |
| - | | + | |
| - | Then, when you want "emerge" to fetch a binary package instead of compiling, use the ''-g'' option. For instance:
| + | |
| - | # emerge -g mysql
| + | |
| - | | + | |
| - | If no suitable binary is found, emerge will fallback to an usual from-sources installation. If you want to accept only binary package, then use ''-G'' instead of ''-g''. Finally, if you want emerge to always try to get a binary prior to compiling, then you can add getbinpkg to your FEATURES in ''/etc/make.conf''.
| + | |
| - | | + | |
| - | [TODO: pros and cons of binary packages, relation to USE flags, etc.]
| + | |
| - | | + | |
| - | == The power/reset buttons explained ==
| + | |
| - | Your Gentoo system has a special setup for the power (the one in front of the box) and reset (the small one on the back) buttons:
| + | |
| - | * to shut down your box, press the front button for ~6 seconds. That will do a "shutdown -h now".
| + | |
| - | * to reset your box, push the front button twice in less than 3 seconds. This will do a "shutdown -r now".
| + | |
| - | * to reset your box in EM mode (in case of troubles), press the back button for ~6 seconds.
| + | |
| - | | + | |
| - | For technical details about this feature, check the [[Survive without ppc_uartd]] page.
| + | |
| - | | + | |
| - | == Keep your box on time ==
| + | |
| - | === Timezone ===
| + | |
| - | The first thing to do if the clock of your box is important to you is to set its timezone (yeah, that could have been in the install guide, i forgot). It is as simple as creating the right symlink at the right place:
| + | |
| - | # ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime
| + | |
| - | # ln -sf /usr/share/zoneinfo/America/Chicago /etc/localtime
| + | |
| - | | + | |
| - | === Using ntp ===
| + | |
| - | Ntp is a protocol that permits syncing time with other servers. Once configured, your box will always stay perfectly on time, and can also be turned into a time server for the other machines of your LAN.
| + | |
| - | A net-misc/ntp binary package is available, so you can '''<code>emerge -g</code>''' it.
| + | |
| - | For the configuration, I suggest you read the [http://gentoo-wiki.com/NTP Howto NTP] from the Gentoo Wiki.
| + | |
| - | | + | |
| - | == Some system packages you should really install ==
| + | |
| - | Right after the installation, your system is really minimalistic. Here are a few packages that you probably should install:
| + | |
| - | === A log daemon ===
| + | |
| - | Possible choices are:
| + | |
| - | app-admin/syslog
| + | |
| - | app-admin/metalog
| + | |
| - | app-admin/syslog-ng
| + | |
| - | I personally prefer syslog-ng, thus that's the one i provide as binary package. But metalog also worths a try, feel free to compile it. And once you've installed and configured one, remember to add it to the default runlevel:
| + | |
| - | # rc-update add syslog-ng default
| + | |
| - | === A cron daemon === | + | |
| - | I suggest you try '''<code>sys-apps/fcron<code>''': it can understand traditional crontabs (à la vixie-cron and friends), but adds many other useful features (daily/weekly/etc. targets, cpu load control, per-user crontabs, etc.). It is available as binary package. Oh, and that also should be added to the default runlevel.
| + | |
| - | === Logrotate ===
| + | |
| - | That's the complement of your logger daemon, to avoid having your ''/var/log'' growing again and again. '''<code>emerge logrotate</code>''', configure it, and check it is in your cron jobs.
| + | |
| - | === Tmpreaper ===
| + | |
| - | Just like logrotate, you probably want that to keep your ''/tmp'' size under control. '''<code>emerge tmpreaper</code>'''.
| + | |
| - | == Kernel modules ==
| + | |
| - | Depending if you are using a Kuro or a Kuro/HG, the compiled kernel modules are in two different packages:
| + | |
| - | sys-kernel/modules-kurobox
| + | |
| - | sys-kernel/modules-kurobox-hg
| + | |
| - | You probably want to install one of this package. I've not much looked at the old Kuro ones, but the HG ones for instance add the generic scsi driver (which i think is required for mounting usb devices), more filesystems, more NLS encodings, etc. If there are there some modules you want loaded on boot, add them to ''/etc/modules.autoload.d/kernel-2.4'', and run '''<code>update-modules</code>'''.
| + | |
| - | | + | |
| - | [[Category:Gentoo]]
| + | |
| - | [[Category:HowTo]]
| + | |
