Step by step user guide for STUX GNU/Linux (index)

1. Web applications
   
   
   • Webmin - System administration - http://webmin.com
     
     
     You can run Webmin pre-installed (version 1.200) on STUX Live CD or you can download a more recent version from http://linuxpackages.net, if any.
     
     Webmin can be installed in a persistent directory (example: /mnt/hda2/webmin) or in a volatile RAM directory (example /tmp/webmin).
     
     In this example we install Webmin in /mnt/hda2/webmin
     
     If installation directory already exists, remove it:

     rm -fr /mnt/hda2/webmin

     • Setup
       
       
       To configure the pre-installed Webmin (version 1.200):
       
       
       1. Copy webmin directory in installation directory:

          cp -r  /usr/libexec/webmin/usr/libexec/webmin /mnt/hda2/webmin

       To configure a more recent version of Webmin:
       
       
       1. Download latest Webmin package from http://linuxpackages.net in a temporary directory:

          mkdir /tmp/webmin-setup

          wget -P /tmp/webmin-setup --passive-ftp ftp://ftp3.linuxpackages.net/pub/Slackware-10.1/Daemon/webmin/webmin-1.200-noarch-1ron.tgz

       2. Uncompress package:

          cd /tmp/webmin-setup

          tar -xvzf webmin-1.200-noarch-1ron.tgz

       3. Copy Webmin in installation directory:

          mv usr/libexec/webmin /mnt/hda2/webmin/ 

       4. Remove setup files:

          cd /tmp

          rm -r webmin-setup

       Execute: /mnt/hda2/webmin/setup.sh
       
       
       This will start an interactive setup: for testing purpose, the defult choiches are ok.
       
       
     • Start
       
       
       To start webmin:
       

       /mnt/hda2/webmin/webmin-init start

     • Stop
       
       
       To stop webmin:
       

       /mnt/hda2/webmin/webmin-init stop

     • Restart
       
       
       To restart webmin:
       

       /mnt/hda2/webmin/webmin-init restart

     • Start at boot
       
       
       During interactive setup, you have been asked if start webmin at boot: if you answered 'yes', and if configuration is saved persistently, webmin will be restarted at boot.
     
     
   • phpMyAdmin - MySQL management - http://www.phpmyadmin.net
     
     
     We suppose, as example, that Apache Document Root directory is in:

     /mnt/hda2/www/htdocs

     and we want to make service phpMyAdmin available at default path:

     http://127.0.0.1/phpMyAdmin

     1. Remove, if exists, a previous phpMyAdmin installation:

        rm -rf /mnt/hda2/www/htdocs/phpMyAdmin

     2. Copy phpMyAdmin directory in Apache Document Root, renaming it in 'phpMyAdmin' for simplicity:

        cp -r /usr/local/phpMyAdmin-2.6.3-pl1/ /mnt/hda2/www/htdocs/phpMyAdmin

     3. Start Apache, if not already running.
     4. Start MySQL, if not already running.
     
     Now you can access phpMyAdmin as a web application: open the following url:

     http://127.0.0.1/phpMyAdmin

     If everything is ok, you'll see phpMyAdmin main page.
     
     NOTE:
     
     
     If you got 'Access Denied' error, could be that root MySQL password has been changed, and phpMyAdmin configuration file has not been updated consequently.
     Check password for root MySQL user in:

     /mnt/hda2/www/htdocs/phpMyAdmin/config.inc.php.

     in the first occurrence of:

     $cfg['Servers'][$i]['password']='password';

     To change password for root MySQL user, see MySQL configuration.
     
     
     
   • phpBB - Web Forums - http://www.phpbb.com
     
     
     phpBB is no more installed by default starting from STUX 0.9.2: you have to dowload the last version of phpBB from http://www.phpbb.com/downloads.php. We suppose, as example, that Apache Document Root directory is in:

     /mnt/hda2/www/htdocs

     and we want to make service phpBB available at default path:

     http://127.0.0.1/phpBB2

     1. Start Apache, if not already running.
     2. Start MySQL, if not already running.
     3. Remove, if exists, a previous phpBB installation:

        rm -rf /mnt/hda2/www/htdocs/phpBB2

     4. Download and install phpBB2 into the Apache Document Root directory:

        cd /mnt/hda2/www/htdocs
        wget http://switch.dl.sourceforge.net/sourceforge/phpbb/phpBB-2.0.21.zip
        unzip phpBB-2.0.21.zip

     5. Now you can access phpBB setup, as a web application: open the following url:

        http://127.0.0.1/phpBB2

        If everything is ok, you'll see phpBB installation page:
        essentially you need to insert a username and a password for MySQL, so you need to create a new user for MySQL.
        
        
     6. Use a command like this to create new MySQL user:

        echo "GRANT ALL PRIVILEGES ON *.* TO 'phpbb_user'@'localhost' IDENTIFIED BY 'phpbb_password' WITH GRANT OPTION;" | mysql -u root --password=MySQLRootPass

        where:
        phpbb_user is the username
        phpbb_password is the password
        MySQLRootPass is the root password for MySQL
        
        
     7. Invent a username and password for phpBB and continue: you will see a page with this message:
        
        
        
        choose 'Just send me the file and I'll FTP it manually' and save the file in

        /mnt/hda2/www/htdocs/phpBB2/config.php

        overwriting the old one.
        
        
     8. Remove setup files:

        rm -r /mnt/hda2/www/htdocs/phpBB2/install /mnt/hda2/www/htdocs/phpBB2/contrib

     9. Ready! Access to the service: http://127.0.0.1/phpBB2.
     
     
2. Create boot floppy to boot STUX from network (PXE)
   
   
   If you want boot STUX from network but your client BIOS does not support network booting, you can create a boot floppy that mount and load STUX from network.
   
   
   1. Enter the proper application:

      STUX CONTROL CENTER -> Setup -> Live CD -> Boot removable devices

   2. Select tab labeled 'PXE'
      
      you will see a window like this:
      
      
      
      
   3. Choose the ethernet driver required by PXE client machine.
      Boot floopy must contain the appropriate driver for the client network card.
      
      
   4. Click the button labeled 'Create'
      
      WARNING: all data on floppy disks will be lost !
      
      
   
   
3. List of installed packages
   
   
4. CD/DVD burning
   
   
   To start mastering a CD or a DVD:

   STUX Control Center -> Utility -> CD & DVD recording - K3B

   this will open K3B application:
   
   
   
   You can easily burn CD or DVD but you need to check following conditions:
   
   
   • Temp directory
     
     In STUX Live CD, by default, K3B temp directory is located in RAM, that probably is not large enough.
     
     You can check if Temp directory is valid looking in the bottom-right of K3B main window:
     
     
     - if there is a red folder icon, you need to change it.
     
     - if icon is green, temp directory is ok.
     
     To change K3B Temp directory, click on the icon on the bottom-right of K3B main window.
     
     
   • Swap space
     
     Even if you have lot of RAM installed, a large-enough swap space greatly helps, expecially for CD/DVD mastering, large iso file creation, etc.
     Set up Virtual Memory (Swap)
   
   
   
5. Compile modules in STUX
   
   
   With DVD version you can compile new module sources normally, because all kernel sources are present and configured.
   
   When using CDROM version, before compile a new module source, you have to integrate the linux sources in /usr/src/linux with at least directories /usr/src/linux/Kbuild and /usr/src/linux/scripts provided by standard kernel source package (STUX 2.0 uses the 2.6.24.4 kernel: http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.24.4.tar.gz); for example, to install kernel sources on hda1 partition open a shell console and execute:

   cd /mnt/hda1    # change to a directory on ext2 or ext3 partitions (no ntfs, no fat).
   sudo wget http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.24.4.tar.gz
   sudo tar -xvzf linux-2.6.24.4.tar.gz
   sudo ln -sf /mnt/hda1/linux-2.6.24.4/* /usr/src/linux
   

   
   
6. ACPI: video is dark, brightness is low
   
   Could happen with some laptop with ACPI enabled by BIOS that monitor is dark and brightness is lower than normal: this setting could be persistent even if computer is rebooted.
   To increase brightness:

   echo 7 > /sys/class/backlight/acpi_video0/brightness

   
   
7. Contact
   
   STUX is a project maintained by:
   

   GP STUDIO Internet Services (http://gpstudio.com)
   Via Cavaleri 4/A
   Milan, Italy

   Contact:

   Giacomo Picconi <giacomo.picconi @ gpstudio.com>