Added several subsections to the guide.

pktsurf 2025-01-30 20:26:00 +05:30
parent 1b06ae4c03
commit 18913de8b4

@ -64,8 +64,6 @@ The rsync mirror is currently WIP
## 7. Installation
All SMLinux images can be used for offline/standalone installation. No pre-installation network setup is required. After downloading, decompress using the unzip utility. The x86_64 image can be dd'd onto a flash drive. This entire section assumes that /dev/sdb is your target storage device.
### 7.1 x86_64
> The x86_64 image does not support booting from UEFI yet. Support for UEFI coming soon.
The x86_64 image also has two partitions with the above partition layout. However, this image comes with a separate package directory /root/packages containing the packages that can be installed onto the target system. dd the x86_64 image to a flash drive of a size 4GB or larger:
@ -78,4 +76,124 @@ Boot up the target system, select "Boot from USB" or equivalent BIOS boot up opt
Username: **root**
Password: **smlinux**
Password: **smlinux**
Partition the target storage drive using a tool of your choice. If using syslinux, you need two partitions:
- /boot to be formatted as an FAT32 partition and
- / to be formatted as any journalling partition
Then format the partitions, assuming /dev/sdb is your hard disk/SSD
`# mkfs.fat /dev/sdb1`
`# mkfs.ext4 /dev/sdb2`
Creation and formatting of RAID partitions or encryption partitions is beyond the scope of this guide.
`# mkdir /mnt/boot`
`# mount /dev/sdb1 /mnt/boot`
`# mount /dev/sdb2 /mnt`
The installer packages for the target rootfs are available in /root/packages/x86_64 of the SMLinux boot drive. Install them using **installpkg**.
`# cd /root/packages/x86_64`
`# installpkg --root /mnt */*`
Install the **bootloader** on /dev/sdb:
`# dd if=/lib/syslinux/bios/mbr.bin of=/dev/sdb`
If you use syslinux, assuming you have TWO partitions, one FAT for /boot and one journalling partition for /
`# syslinux -i /dev/sdb1`
**OR**
If you use extlinux, assuming you have on ONE journalling partition, like ext4 for /
`# extlinux -i /dev/sdb1`
## 8. Post-Install Tasks
### 8.1 Basic Networking
After a reboot, login when presented with a tty1 prompt:
Username: ***root***
Password: ***smlinux***
This section assumes that the system has eth0 network interface.
To setup hostname for the current session, run
`# hostname example.com`
Edit ***/etc/hostname*** with your choice to set it permanently.
DHCP
**dhclient** is a wrapper around the busybox udhcpc DHCP client. Run the following to get a DHCP lease:
`# dhclient eth0`
Static IP
Use the ***ifconfig/route*** commands from the old net-utils package or the new ***ip*** command from the iproute2 package
`# ifconfig eth0 192.168.0.2 netmask 255.255.2525.0`
`# route add default gw 192.168.0.1`
`# ifconfig eth0 up`
**OR**
`# ip addr add 192.168.0.2/24 dev eth0`
`# ip route add default via 192.168.0.1`
`# ip link set eth0 up`
Add your DNS servers to ***/etc/resolv.conf***
`# vi /etc/resolv.conf`
`nameserver 8.8.8.8`
Verify network connectivity
`# ping google.com`
Add all your preferred connectivity method(s) to ***/etc/rc.d/rc.local***
### 8.2 Setting up Time Zone
The default timezone is **UTC**. The timezone can be changed permanently in two ways
- By creating a symlink:
- `# ln -sf /user/share/zoneinfo/Asia/Kolkata /etc/localtime`
**OR**
By adding **export TZ="Asia/Kolkata"** to ***/etc/profile***
### 8.3 Set System Time and NTP
Run the date command to set the correct time and date -
`# date -s "2025-01-01 12:00:00"`
Optionally, you can use **chrony** to keep the clock more accurate. Delete the service ***down*** file to auto start chrony at boot time.
`# rm /etc/service/chrony/down`
Edit ***/etc/chrony.conf*** and start the chrony daemon
`# sv start chrony`
Chrony daemon customisation is beyond the scope of this guide. Run `# man chronyd.conf` for detailed options.