aryalinux Files

AryaLinux - GNU/Linux, Linux desktop built from source code

Copyright (C) 2015 Chandrakant Singh

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.


INSTALLATION
------------

PREREQUISITES
-------------

1) A Computer with a 64-bit intel or AMD processor.
2) A MBR partitioned Hard Disk(Please do not attempt to install on a system
with GPT partition table. It is not tested and may not work as well.)
3) BIOS in legacy mode. Protected mode would not work.
4) An empty partition(drive) - Mandatory with around 15 GB space. This partition
would be formatted so backup your data in this partition.
5) A swap partition twice the size of RAM (in case RAM <= 2GB). This would be
used in case you would want to hibernate the system and for swap space.

** NB : We do not support VirtualBox and have not tested AryaLinux in VirtualBox
	and the outcome of running AryaLinux on VirtualBox cannot be guaranteed.

PROCEDURE
---------

1) Download the iso and burn it into a DVD or write to a pen-drive. ( Unetbootin
can be used to write to pen drive and works fine. dd method of writing the ISO
to pen drive has not been tested and may not work)
2) Restart your computer and boot into the DVD/Pen Drive with AryaLinux in it.
(Boot device selection key while booting ranges from F2 to F9 to F12 depending
on your system. You may also change the system boot sequence to the same effect)
3) Once you are at the desktop, Open up a terminal and issue the following set
of commands:

sudo su
installarya

You would be asked for details like the root partition and swap partition name
and the home partition name etc. Provide the data. The root partition would be
formatted and file copying would start. Once done, the installer would ask
further questions like username, password for user and root and the device
where bootloader is to be installed and the system locale.

Once of all of it is done and the installer completes, you can reboot to login
to your new OS.


PACKAGE MANAGEMENT
------------------

AryaLinux Packaging System (ALPS) is the package manager for AryaLinux. Since
AryaLinux is built from source and all components it comprises of are also built
from source, whenever you use alps to install new packages, source code is
downloaded, built and installed.

ALPS can be used to install packages by issuing the following command:

alps install gimp

You can do alps --help to see other options alps can take. Alps can only install
packages and not uninstall them. You would have to do that manually.

For more information about alps, visit aryalinux.org/alps


TROUBLESHOOTING
---------------

These are the issues you might run into while using AryaLinux:

Cannot boot from live disk/usb. System is stuck:
------------------------------------------------

In such a case, please send an email to support@aryalinux.org with either the 
error messsage or a screenshot of the error and we would work on fixing it.

Entered unmatching passwords during installation and the installer aborted:
---------------------------------------------------------------------------

In such a case please restart the installer. But before that some cleanup needs
to be done:

umount /root/src

This is not necessary if you have not given the name of a home partition:

umount /root/dest/home

umount /root/dest/dev/pts
umount /root/dest/dev
umount /root/dest/proc
umount /root/dest/sys
umount /root/dest/run
umount /root/dest

rm -rf /root/{src,dest}

This is not necessary if you have not given the name of a swap partition:

swapoff <whatever swap partition name you gave in the beginning>

After this you can restart the installer again by doing:

installarya


On rebooting other linuxes did not appear in grub screen
--------------------------------------------------------

Boot completely into the freshly installed aryalinux. Once at the desktop open
up a terminal and execute:

sudo su
grub-mkconfig -o /boot/grub/grub.cfg

** NB : Please make sure that you do not mount the partition where the other
linux resides as grub-mkconfig cannot detect linuxes in mounted partitions.


The time shown in clock is wrong or the day name and month name is wierd
------------------------------------------------------------------------

You may not have chosen the right locale while logging in. Log out, from locale
selection drop down at the top, beside the power icon, choose the right locale
and then login.

In case time is incorrect, then open up a terminal and enter the following
commands:

date
hwclock

See which one shows the correct time.

In case date command shows the correct time, then execute:

hwclock --systohc

In case hwclock command shows the correct time, then execute:

hwclock --hctosys

Logout and relogin


Wireless not working - firmware missing
---------------------------------------

Run this command to see if any of the firmware loading failed during system boot
up:

dmesg | grep firmware

In case you see something here, then you must see the name of the firmware that
was not loaded or not found. Usually it would be a file with a .bin or .fw
extension. Search for the firmware:

find /lib -name *the name of the firmware enclosed in asterisks*

If its present, then you would see its location. Copy the directory where it
is present to the /lib/firmware directory.

For example if the firmware that was missing is:

brcm/bcm43xx-0.fw

then search it by doing:

find /lib -name *bcm43xx-0.fw*

In my system I got the output as:

/lib/modules/brcm/bcm43xx-0.fw

Now copy the brcm directory over to /lib/firmware:

cp -rvf /lib/modules/brcm /lib/firmware

Reboot and see if the problem got solved. If not then please write us an email

at suport@aryalinux.org detailing the issue and we would get back to you.