User Tools

Site Tools


usersguide:postinstallation

This is an old revision of the document!


Post Installation

Setting the Root Password

You should set a password for the root account. Type:

passwd

Then enter the new password in the prompts (No characters or *'s will appear as you type your password but it IS being entered).

Setting the Timezone

Unix systems always run the clock using UTC time (sometimes named as Greenwich time). You should adjust the timezone setting to have the dates shown by utilities to be like your wall clock. Type:

echo export TZ=Europe/Amsterdam > /etc/rc.timezone

or

echo export TZ=America/New_York > /etc/rc.timezone

The timezone will be set when you log in again.

Of course, you should adjust Europe/Amsterdam according to your location. You can look into the /usr/share/zoneinfo hierarchy to find the correct name. The general principle is continent/city or ocean/city, where city is the English name of the biggest city in the same timezone as you. The city would ideally be in your country, since timezone rules have a strong tendency to vary according to national rules.

Setting the Host Name

You can use the hostname(1) command to manually set the system hostname. For example:

# hostname minix.example.com

/!\ When DHCP is enabled, your settings will be overriden by the DHCP client when renewing the lease.

By default, MINIX runs a DHCP client at boot time, to request an IP address from your DHCP server.

In this case, typically you will not know what the IP address will be and so providing a host name for the system has no functional purpose. But, if you arrange for your DHCP server to always assign the same address to your MINIX system, based on the machine's MAC address, then naming the MINIX host has a real purpose, e.g., you can SSH to it from another machine on your network.

The same is true if you disable the running of the DHCP client at system initialization time and instead manually assign a static IP address (see boot(8) for more information). So if you know what the IP address will be and wish to assign a name to your MINIX host, enter the address/name pair into /etc/hosts (see hosts(5) for specific information about the format of that file).

Installing Binary Packages

See InstallingBinaryPackages on how to install prebuilt packages from the network or from the installation CD. This is one of the first things you should do because the system you get after finishing setup is a barebones system. Using pkgin, you can choose from a large number of packages to tailor the system to your requirements.

Getting OpenSSH and Logging in Remotely with It

The PKGSRC OpenSSH package contains both the client (ssh) and the daemon (sshd). To install it after you have done pkgin update, type: pkgin install openssh. Then type: reboot to start the daemon. We recommend installing this, as it allows ssh access from another host, which improves greatly the user experience in the absence of X11.

If you installed MINIX in a virtual machine, please refer to the Virtualization chapter for your virtual machine monitor of this user guide for further instructions on how to enable network access to the MINIX guest.

To access MINIX 3 via ssh, proceed as follows:

  • Note the IP address in the prompt, say aaa.bbb.ccc.ddd
pkgin update
pkgin openssh
user add -m mary
shutdown -r now

where “mary” is the name of the user you want to log in as (if it does not already exist). Then on a different computer, type:

ssh mary@aaa.bbb.ccc.ddd

Using Virtual Terminals

MINIX 3 supports four virtual terminals. You can switch between them using ALT+F1 through ALT+F4. This could be useful, for example, if you type a command to install many packages and want to do something while it is installing. You can just switch to a different virtual terminal, log in there, and do other work.

Adding Users

Always logging in as root is usually a bad idea, so it is highly recommended to set up at least one other user as soon as possible. For directions on how to do that please see: Managing User Accounts

Changing Keyboard Layouts

Several keyboard layouts are available. These layouts are loaded from files called “keymaps.”

For example, here's how to enable the Swapped Caps & Ctrl U.S. keymap:

loadkeys /usr/lib/keymaps/us-swap.map

To make the keymap the default:

cp /usr/lib/keymaps/us-swap.map /etc/keymap

For details, see keymap(5). This contains the complete documentation on how to create and configure keymaps. The keymap source code is in /usr/src/drivers/tty/keymaps.

Running the test sets

After installing MINIX, you can check the status of your system by running different tests.

MINIX POSIX (and more) tests

To run the MINIX tests do the following:

# cd /usr/tests/minix-posix
# ./run

Warning: This test suite is extremely extensive, and my take up to several hours to complete, depending on your hardware. The usual run time on current computer (about 2GHz Intel CPUs) is about half an hour.

You might see some warning, those are fine as long as the test prints “ok” at the end.

After all the tests have been run, a summary will be printed.

KYUA tests

We have imported the KYUA test suits. At this moment we have not yet spent much time trying to get all tests to pass. It is expected that some are marked as broken, and / or failed.

Also not everything which is tried is relevant on MINIX, for example we do not have quota support, which is why all the related tests fail.

Anyway, to see how much MINIX is NetBSD-compatible, you can run the kyua tests as follow:

# cd /usr/tests
# kyua test

To see the report, you can use on of

# kyua report         # text-only report
# kyua report-html    # HTML report
# kyua report-tap     # TAP report

Note: The KYUA tests are not yet supported on MINIX/arm.

Recompiling the System from Source

usersguide/postinstallation.1453584378.txt.gz · Last modified: 2016/01/23 22:26 by lionelsambuc