LFIRSTTIME(8)		 Lunar Linux for the first time		   LFIRSTTIME(8)

NAME
     lfirsttime - What to do after a successful installation.

SYNOPSIS
     This  manual  page has been written in order to ease the life of the system
     administrator after the installation part of Lunar Linux.

DESCRIPTION
     Lunar Linux is a source based distribution which means  that  every  module
     installed	is  compiled from source.  Lunar Linux is also a rolling release
     distribution so there is no need to reinstall when a new ISO  is  released,
     simply keep your packages up to date.

     These are the suggested tasks you should accomplish after the first boot of
     a newly installed Lunar box.

     All  of  the  lunar related commands mentioned below either feature a whole
     manpage or at least a very useful helpscreen. If you need immediate  assis-
     tance regarding any of those commands, issue:

     man 'command' or 'command' --help

     at your console.

     A list of things to do:

     Network settings
	    This  step	is  crucial to your future success with Lunar Linux.  If
	    you haven't configured your network yet try it with lnet.

     Check your network settings
	    Once you have configured your network, try to ping something on  In-
	    ternet.

	    Example: ping ping.sunet.se

	    If	it doesn't work you may be having a name resolution problem, try
	    pinging to the IP address instead of the name.

	    Example: ping 192.36.125.18

	    If pinging to IP is working but pinging to	name  fails,  check  the
	    /etc/resolv.conf  file  and see if the nameserver entries are there.
	    You may also want to check the man page, man resolv.conf, if you are
	    not familiar with the content of this file.

     Check the network device
	    If pinging the IP address fails, check if your network interface  is
	    up and running. You may use the command ip addr list to view the in-
	    terface's status.

	    If	you cannot, then check if your NIC (network interface card) mod-
	    ule is loaded (assuming you are using a  modular  kernel);	use  the
	    command lsmod to get a list of currently loaded modules.

	    If	you  do not know for sure what type of network card you have try
	    executing the command: cat /proc/pci | grep Ethernet or lspci.  This
	    should give the manufacturer and model name of your ethernet card.

     lnet or manual configuration
	    Your network setting can be configured completely using  lnet;  just
	    make  sure you set up your interface correctly as needed. If you en-
	    counter problems after having configured your network with lnet  you
	    probably want to adjust the configuration manually.

	    The	 network  configuration	 file for your Lunar installation may be
	    found in /etc/config.d/network/'interface' (i.e. 'eth0' -> /etc/con-
	    fig.d/network/eth0). If you adjust	your  interface's  configuration
	    manually it is required to restart the interface using systemctl.

	    Example eth0 using DHCP: systemctl restart lnet-dhpcd@eth0

	    Example eth0 using static ip: systemctl restart lnet-static@eth0

     Update your modules repository
	    The modules repository from where the coretools gather their package
	    information	 is called moonbase. Also, packages are usually referred
	    to as modules. Since the moonbase on your installation  is	probably
	    outdated  it's  strongly  recommended to update your moonbase as the
	    first thing you do.

	    To update your moonbase run: lin moonbase

     Update your coretools
	    The coretools are the heart of every Lunar Linux system.  They  pro-
	    vide  you  with all the necessary commands to maintain a working in-
	    stallation thus it's always recommended to have the	 latest	 version
	    installed. Our coretools module is called lunar.

	    To update lunar coretools run: lin lunar

	    A  very brief explanation of the most important coretool components.
	    For further information regarding the referenced parts please  refer
	    to their manpages (i.e. man <part>):

		   lin <module>		   Install a package/module

		   lvu <option> <module>   View information about a package/mod-
		   ule

		   lrm <moduule>	   Uninstall a package/module

		   lunar <option>	   Lunar configuration utility

     Set your preferences
	    Lunar Linux can easily be customized and is highly configurable. For
	    changing  the  options  that affect your system you may use the menu
	    driven lunar configuration utility.	 It's  based  on  ncurses  which
	    means you can even run it in the console of your choice. You need to
	    become root to use it.

	    Optimizations
		   Set the optimizations for your computer. Be aware that chang-
		   ing	your  optimizations  to	 the wrong values might actually
		   break your whole installation so be really careful about what
		   you're choosing. The ISO has been built  with  a  minimum  of
		   available optimizations to ensure the highest amount of flex-
		   ibility. To see whether or not your processor supports a cer-
		   tain feature try a cat /proc/cpu. It usually shows the avail-
		   able settings that suit your machine.

	    Integrity checking
		   Lunar  is  performing  a range of security checks on tarballs
		   and installed packages to prevent faulty tarballs and  possi-
		   ble	intruders  from taking over your system. It also ensures
		   that none of your currently installed packages is broken. You
		   may select the amount of checks from the  Integrity	checking
		   submenu at the Options menu. It's generally recommended to at
		   least choose FIND_CHECK and LDD_CHECK.

	    Feature menu
		   As  mentioned  before, Lunar is highly configurable. Thus you
		   have a whole menu to select its features from. It's	strongly
		   advised  to	at least take a look at it and get used to them.
		   Explanations are usually displayed as soon as you  select  an
		   item. It can be a powerful companion while achieving the goal
		   of setting up your system.

     General updates
	    Right now you're set to update your whole system. Before you do that
	    make sure you have the most recent moonbase and coretools installed.

	    To update your whole system run: lunar update

	    lunar  update  actually implicitly update moonbase and coretools for
	    you. If you don't want it to do that you can use  lunar  renew  that
	    only updates the out of date modules.

	    It's  going	 to  compare your system's installed modules against the
	    moonbase's definitions and update the installed modules accordingly.
	    It's going to give you a list of modules that are going  to	 be  up-
	    dated. If you're not sure wether you want a certain module to be up-
	    dated  remove  it  from the list. Once you're done the coretools are
	    going to start the update which usually is going to take a while de-
	    pending on how long ago the last update was done. So grab  a  coffee
	    and/or a book and wait for it to finish ;-)

	    Once  it is done it is going to present you with a summary about how
	    many module where successfully updated and which of them failed. lvu
	    ('lvu activity') is going to show you which of them failed and  usu-
	    ally why. lvu ('lvu compile <module>') is also going to show you the
	    compilation's  logfile  which  should clearly point you to the error
	    that led to the failure of the module's compilation.

	    The first thing to do would be to 're'lin'	(i.e.  execute	lin  -cr
	    once  more.	 It is always advised to use the -c (compile) and the -r
	    (reconfigure) switch in case a module fails to compile. If you think
	    you will not be able to resolve the matter on your own you can still
	    file a bugreport at	 https://github.com/lunar-linux/lunar/issues  or
	    report  the	 error	to the Lunar Linux mailinglist. You will have to
	    subscribe  to   the	  list	 at   http://lists.lunar-linux.org/mail-
	    man/listinfo/lunar before being able to post any e-mail to it.

	    Once the update has been completed successfully you may go ahead and
	    customize your installation to suit your own needs. Well done!

HINTS
     TAB-completion
	    All of the coretools are able to do tab-completion. Say, you want to
	    install  the  module  'xfce4-panel'	 just  go  ahead  and  type 'lin
	    xfce4-p<TAB>' and lin is going to append the rest  of  the	module's
	    name  to  the  command. Once there are too few characters to resolve
	    the name into one single module you just need to hit  TAB  twice  to
	    get	 a list of all the modules starting with the characters you just
	    typed i.e. 'lin xfce<TAB><TAB>' is going to give you a list	 of  all
	    modules starting with 'xfce'.

     Leftovers
	    In	case  of  a compilation failure the sources of the failed module
	    are left in $BUILD_DIRECTORY (usually /usr/src/).  Moreover,  a  few
	    tracking  files  lunar  creates  to monitor the running installation
	    process might be left in /tmp. Make sure you tidy up these two loca-
	    tions from time to time.

	    CAUTION: Directories like 'linux-x.x' are kernel source  directories
	    and	 _must_ be left intact. Otherwise your system is going to break!
	    Only delete them if you're absolutely sure that they don't belong to
	    your currently running kernel.

     IRC channel
	    The fastest help you get is by  chatting  with  the	 developers  di-
	    rectly.  Join  the	Lunar Linux IRC channel at Libera irc://irc.lib-
	    era.chat/#lunar

NOTES
     This is merely an introduction to what should be done to get a  ready-to-go
     Lunar  system.  Please  consult  the documentation at the Lunar website for
     more information.

SEE ALSO
     Documentation at the Lunar Linux website at http://lunar-linux.org

     lunar(8), moonbase(1), lin(8), lvu(1), lget(8), lrm(8), lnet(8)

DISCLAIMER
     The information and examples given here are for illustrative  purposes.  If
     you encounter any inaccuracies please send an email to the authors.

COPYRIGHT
     This document is originally Copyrighted Kagan Kongar 2002.

     Portions of this document Copyrighted (C) 2003-2004 Terry Chan

     It	 has  been  almost  completely	rewritten by Moritz Heiber for the Lunar
     Linux development team under the Creative Commons License, (C) 2005

     Updated by Stefan Wold for the Lunar Linux team under the Creative	 Commons
     License, (C) 2014

AUTHORS
     Kagan Kongar  <kongar@tsrsb.org.tr>

     Terry Chan	   <tchan@lunar-linux.org>

     Moritz Heiber <moe@lunar-linux.org>

     Stefan Wold   <ratler@lunar-linux.org>

Lunar Linux			   2014-10-11			   LFIRSTTIME(8)