[Lunar-commits] r14923 - in lunar-iso/trunk: lunar-install/sbin scripts template
Auke Kok
sofar at lunar-linux.org
Sun May 22 14:59:54 UTC 2005
Author: sofar
Date: 2005-05-22 14:59:53 +0000 (Sun, 22 May 2005)
New Revision: 14923
Added:
lunar-iso/trunk/template/README
Modified:
lunar-iso/trunk/lunar-install/sbin/lunar-install
lunar-iso/trunk/scripts/isofs
Log:
Adding README which repalces the introduction. Fixed up the finishing script to include it and put the version info into it as well.
Modified: lunar-iso/trunk/lunar-install/sbin/lunar-install
===================================================================
--- lunar-iso/trunk/lunar-install/sbin/lunar-install 2005-05-22 14:53:59 UTC (rev 14922)
+++ lunar-iso/trunk/lunar-install/sbin/lunar-install 2005-05-22 14:59:53 UTC (rev 14923)
@@ -11,25 +11,7 @@
introduction()
{
- $DIALOG --title "Welcome to Lunar Linux" --msgbox \
-"The purpose of Lunar Linux is to return control to System
-Administrators that the wizards and maintainers of modern
-distributions have steadily chipped away." 8 65
-
- $DIALOG --cr-wrap --title "The Benefits of Lunar Linux" --msgbox \
-"Lunar Linux empowers System Administrators to choose:
-
- the architecture that programs are compiled for,
- the dependencies a program is compiled with,
- compiler optimizations, and compile time options.
-
-And it provides the conveniences of:
-
- command line and menu driven package management,
- ASCII configuration and data files,
- FSH 2.2 compliant filesystem hierarchy,
- LSB 1.1 compliance,
- System V Init, and Networking." 18 65
+ $DIALOG --textbox /README 0 0
I_OK="\\Z2"
if (( STEP == 1 )); then
(( STEP++ ))
@@ -60,15 +42,15 @@
# debug the problem in case there is one
(
- echo "ERROR: "
+ echo ""
echo "ERROR: An error occurred while executing a command. The command was:"
echo "ERROR: \"$@\""
echo "ERROR: "
echo "ERROR: You should inspect any output above and retry the command with"
echo "ERROR: different input or parameters. Please report the problem if"
echo "ERROR: you think this error is displayed by mistake."
- echo "ERROR: "
- echo "ERROR: Press ENTER to continue"
+ echo ""
+ echo "Press ENTER to continue"
read JUNK
) >&2
return $RESULT
Modified: lunar-iso/trunk/scripts/isofs
===================================================================
--- lunar-iso/trunk/scripts/isofs 2005-05-22 14:53:59 UTC (rev 14922)
+++ lunar-iso/trunk/scripts/isofs 2005-05-22 14:59:53 UTC (rev 14923)
@@ -30,19 +30,21 @@
cp $ISO_SOURCE/isolinux/{f{1,2,3}.txt,boot.cat,isolinux.{bin,cfg},generate-iso.sh,README} $ISO_TARGET/isolinux/
-for file in $ISO_TARGET/isolinux/{f{1,2,3}.txt,boot.cat,isolinux.{bin,cfg}} $ISO_TARGET/etc/motd $ISO_TARGET/etc/motd $ISO_TARGET/sbin/lunar-install ; do
- sed -i -e "s:%VERSION%:${ISO_VERSION}:g" \
- -e "s:%CODENAME%:${ISO_CODENAME}:g" \
- -e "s:%KERNEL%:${ISO_KVER}:g" $file
-done
-
echo "+ copying package listing"
cp $ISO_SOURCE/aaa_base/packages $ISO_TARGET/.packages
echo "+ copying aaa_base.tar.bz2"
cp $ISO_SOURCE/aaa_base/aaa_base.tar.bz2 $ISO_TARGET/var/cache/lunar/
echo "+ copying aaa_dev.tar.bz2"
cp $ISO_SOURCE/aaa_dev/aaa_dev.tar.bz2 $ISO_TARGET/var/cache/lunar/
+echo "+ copying README"
+cp $ISO_SOURCE/template/README $ISO_TARGET
+for file in $ISO_TARGET/isolinux/{f{1,2,3}.txt,boot.cat,isolinux.{bin,cfg}} $ISO_TARGET/etc/motd $ISO_TARGET/etc/motd $ISO_TARGET/sbin/lunar-install $ISO_TARGET/README ; do
+ sed -i -e "s:%VERSION%:${ISO_VERSION}:g" \
+ -e "s:%CODENAME%:${ISO_CODENAME}:g" \
+ -e "s:%KERNEL%:${ISO_KVER}:g" $file
+done
+
# reverse approach this:
rmdir $ISO_TARGET/var/build
cd $ISO_TARGET
Added: lunar-iso/trunk/template/README
===================================================================
--- lunar-iso/trunk/template/README 2005-05-22 14:53:59 UTC (rev 14922)
+++ lunar-iso/trunk/template/README 2005-05-22 14:59:53 UTC (rev 14923)
@@ -0,0 +1,238 @@
+
+ //// \\\\
+ WELCOME TO LUNAR_LINUX !
+ \\\\ ////
+
+
+You are reading the README file which is present in the root of the ISO.
+This version comes with the following ISO:
+
+ %VERSION% - %CODENAME%
+
+To navigate through this file, use PgUp, PgDn, Up, Down etc. to browse
+through this file, or start your favorite editor on this file. Please
+read on for some general tips and hints first, and more detailed info
+on the installer procedure below.
+
+========
+
+
+Index:
+
+1. About lunar-linux
+2. General tips and hints
+3. Installer procedure
+4. Where to get more help
+5. What more to do with this ISO
+6. After installation
+
+========
+
+
+1. About lunar-linux
+
+Lunar-Linux is a source distribution. This means that lunar is just like
+any other distrobution, except that you compile packages instead of
+installing precompiled packages. That really is the only difference with
+so-called "binary" distributions.
+
+This means that you have the control over how you compile packages yourself,
+instead of relying on the willingness of others to provide you the features
+of software that you need or want. This control is what allows you to do
+the following with lunar that other distributions typically don't allow you
+to do:
+
+* optimize your entire system for speed, or size
+* sacrifice stability for speed or vice versa
+* insert or remove features of packages that require recompiling
+* upgrade core system components without reinstalling
+
+But this is just an incomplete list. There are many more benefits that are
+not mentioned here.
+
+The downside is that you need to spend time compiling packages. However,
+with the current power of systems, this hardly stops people from choosing
+such an approach!
+
+A little history about lunar: Lunar-Linux was born as a fork from Sorcerer
+GNU Linux (SGL). Nowadays SGL doesn't exist anymore because the original
+author (Kyle Sallee) retracted his GPL code and distributes it under a
+non-OSSI approved license, and renamed it "Sorcerer". Another group of
+people also forked SGL into SourceMage GNU Linux, and they work side
+by side Lunar-Linux, often sharing concepts and ideas.
+
+Lunar will provide you with an excellent platform for the following tasks:
+
+* server oriented systems
+* development and programming systems
+* high-performance computing and clustering
+* High-end gaming
+* Desktop computing
+
+But be warned: depending on your needs you might need to invest a large
+amount of time into your system. Lunar is not a hands-off distribution
+per se, although it can be under specific circumstances.
+
+It is all up to you!
+
+========
+
+
+2. General tips and hints
+
+There are many tips that we can give you now but a few are more important
+than others:
+
+* Know your system's hardware or get to know it
+
+Picking good drivers, configuring your system is important. Choose wisely
+and get to know your system by reading `lspci` and /proc/cpuinfo. Read
+documentation and howto's, and other people's experiences online.
+
+* Don't over-optimize!
+
+Optimizations are nice, but they can break your entire system. Start
+with modest optimizations, and increase them slowly as you understand
+what they do and how dangerous they can be.
+
+* Make backups!
+
+Always make sure you can fall back to a known-good state if you are
+changing vital parts of your system!
+
+* RTFM, search, ask, document
+
+There is always someone who has solved a problem before you. First use
+the documentation provided as much as possible (man, info, howtos), then
+search the internet first. If you can't find anything to help you, ask
+on the lunar mailinglists (see our website), and last, let others know
+how you solved your problem.
+
+
+I hope you realize with these tips that you can help yourself much
+more than we can help you.
+
+
+========
+
+3. Installer procedure
+
+The lunar ISO installer consists of 3 major stages. Globally they are:
+
+I - prepare your system
+
+In this stage you prepare partitions and select the filesystems that you
+wish to use. The partitioning is done instantly, so be careful with what
+you choose. If you already have proper partitions you can select them
+and choose filesytems for them. Lunar will not format them initially.
+
+II - installation
+
+In this stage all partitions are formatted if needed and requested, swap
+or swapfiles are created, and all required packages are installed onto
+your system.
+
+The second part of this phase allows you to select and install a bootloader,
+which allows you to boot any kernels you choose next. Without this, your
+box would be quite useless.
+
+III - configuration
+
+After your box is finished installing and made ready for operation, you
+can configure certain parts before actualy booting the system. This
+includes setting a root password, administrating your network already
+and a few more settings can be set.
+
+
+========
+
+4. Where to get more help
+
+If you need more help and the provided information is not sufficient,
+you can get more help the following way:
+
+* The Internet - websites
+
+Countless websites describe pretty much every problem out there. Most of
+the time they can be solved without the need of a person, and some very
+good documentation websites provide very detailed help on most common
+tasks. Good website to start: tldp.org (linux documentation project)
+
+* lunar-linux.org
+
+As everyone out there, we have a website with specific lunar documentation
+that is constantly adjusted.
+
+* mailing lists and mailing lists archives
+
+Visit our homepage and you will find the way to subscribe to our mailing-
+list. From there you can contact many lunar-fanatics who are willing to
+help you with your problems.
+
+* IRC: #lunar on irc.freenode.net
+
+Join our IRC (Internet Relay Chat) channel #lunar on the freenode IRC
+network. There you can contact not only many lunar developers and users
+almost 24 hours a day, but also 50.000 other linux users and OSS developers
+online.
+
+* e-mail
+
+If all else fails, and you have no way of contacting use through the
+mentioned methods above, you can send an e-mail to maintainer at lunar-linux.org
+
+
+========
+
+5. What more to do with this ISO
+
+Next to installing Lunar on your system, the ISO also provides you with
+a well-filled live-ISO image with many installation and rescue system
+components. This can help you in case you have problems with your
+installed system.
+
+The ISO provides cache tarballs for the most critical components too,
+in /var/cache/lunar. These can help you recover from serious problems
+with your system instantly.
+
+You can also use the ISO to boot a system that has problematic bootloader
+configurations, and correct them.
+
+This is just a short summary of possibilities. Many more things are
+possible!
+
+
+========
+
+5. After installation
+
+As always, the fun just starts when you are done installing. Then it is
+up to you to really "finish" your system. Here's a few pointers:
+
+* setup users and permissions. Run 'luser' and start working as a normal
+user as fast as possible. If you don't have to be root, don't.
+
+* install services and support libraries. Nothing is worse then a blank
+box that doesn't provide basic programs. Look through the module list
+and sections, and figure out what features you wish to have installed.
+
+* tweak the optimizations. Perhaps the default (and safe, but fast)
+optimizations are not enough for you. Optionally you might want to
+rebuild your entire system after installing, to make sure all components
+are build with the preferences you want.
+
+* keep your system up2date. As soon as you are done installing, your system
+most likely will need some updates already. Keep your system up2date! This
+will prevent people from breaking into your box, or from serious defects
+to cause harm to your system.
+
+* keep your system clean. Run 'lunar prune' to minimize old sources lying
+around. Remove packages that you don't really need anymore. A clean box
+is a safe box, and nothing can be so dangerous as tons of old programs
+luring around.
+
+
+========
+
+Lunar-Linux - hope you enjoy using it as much as wel enjoy making it!
+
More information about the Lunar-commits
mailing list