You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
calculate-utils-2.2-install/man/cl-install.1

267 lines
9.9 KiB

.TH CL-INSTALL 1 "August 23, 2011" "Calculate Utilities" "Calculate Linux Installation"
.SH NAME
.PP
cl-install - Installs Calculate Linux on HDD, USB-Flash or USB-HDD
.SH SYNOPSIS
[-d] [-w] [--mbr] [--type] [--iso] [-s] [--march] [--build] [-l] [-u] [--hostname]
[--netconf] [--dhcp] [--ip] [--route] [--dns] [--proxy] [--ntp] [--nouuid] [--set] [-U] [-f]
[--startup] [--install] [--uninstall] [--nospinner]
[-P] [-p] [-v] [--filter] [--xml] [--color] [--version] [-h]
.SH DESCRIPTION
.PP
cl-install is the installation tool used in Calculate Linux. It supports installing on Hard Disk Drive, external hard disk and USB-stick. The image stored in '/var/calculate/linux' or '/var/calculate/remote/linux' will be used for installing. If installing from LiveCD/LiveUSB, the booted image is used.
.PP
Installation on hard disk can be done in regular mode or in interactive build mode if you want to create a customized distribution. To install in interactive build mode, use '--build'.
.PP
Installation on external hard drive is basically the same, but it is not hardware-dependent.
.PP
By default, installing on USB-flash is done by copying of the liveusb image with fat32 filesystem and the syslinux bootloader. If needed, the system can be installed with full file unpacking, as if installing on HDD. Use the '--type' option to enable this feature.
.SH OPTIONS
.PP
Options for
\fBcl-install\fR:
.PP
\fB\-d\fR, \fB\-\-disk\fR \fIDISK[:[DIR:FILESYSTEM:OPTIONS]]\fR
.RS 4
DISK points to the volume where the system will be installed if some part of the filesystem hierarchy has been remounted. DIR is the mounting point; if its value is set to 'none', it prevents the mounting point from being moved. FILESYSTEM refers to the file system; available values are ext2, ext3, ext4, reiserfs, xfs, jfs, btrfs and nilfs2. OPTIONS refers to mounting options; see 'man fstab'. To specify multiple volumes, use this option as many times as you need.
.RE
.PP
\fB\-w\fR, \fB\-\-swap\fR \fIswap volume\fR
.RS 4
.RE
.PP
\fB\-\-mbr\fR \fIboot disk\fR
.RS 4
Disk for Master Boot Record (MBR). Setting the 'off' value disables boot record altering.
.RE
.PP
\fB\-\-type\fR \fIdevice type\fR
.RS 4
Device type. Valid values are hdd, usb-hdd, and flash.
.RE
.PP
\fB\-\-iso\fR \fIpath to file\fR
.RS 4
Path to the file which contains the ISO image of your distribution. If not specified, the system will look for an image of the same architecture in '/var/calculate/linux' and '/var/calculate/remote/linux', or, if booting from LiveCD/LiveUSB, a livecd will be used. At finding multiple images, priority is given to the most recent version.
.RE
.PP
\fB\-s\fR, \fB\-\-os\fR \fIdistribution\fR
.RS 4
Lets you choose your distribution. Valid values are "CDS", "CLD", "CLDG", "CLDX", "CLS", "CMC" and "CSS". If specified, the required distro will be searched for in '/var/calculate/linux' and '/var/calculate/remote/linux'.
.RE
.PP
\fB\-\-march\fR \fIarchitecture\fR
.RS 4
Lets you choose your CPU's architecture. Valid values are "i686", "x86_64" and "auto". If specified, the required distro will be searched for in '/var/calculate/linux' and '/var/calculate/remote/linux'.
.RE
.PP
\fB\-\-build\fR
.RS 4
Installing in interactive build mode. Is valid while installing on HDD. If specified, the live image will be mounted at booting in a separate layer of the aufs2 filesystem. Additional layers allow to separate the changes from the results.
.RE
.PP
\fB\-\-pxe\fR
.RS 4
Installing for the booting of other computers using the network card.
.RE
.PP
\fB\-l\fR, \fB\-\-lang\fR \fIlanguage\fR
.RS 4
Language choice. Valid values are 'bg_BG' - Bulgarian, 'de_DE' - German, 'en_US' - English, 'es_ES' - Spanish, 'fr_FR' - French, 'it_IT' - Italian, 'pl_PL' - Polish, 'pt_BR' - Portugal Brazilian, 'pt_PT' - Portugal , 'ro_RO' - Romanian, 'ru_RU' - Russian, 'uk_UA' - Ukrainian.
.RE
.PP
\fB\-u\fR, \fB\-\-user\fR \fIuser\fR
.RS 4
Users added to the installed system. For adding several users use the option as many times as you need.
.RE
.PP
\fB\-A\fR, \fB\-\-autologin\fR \fIuser\fR
.RS 4
Autologin user added to the installed system.
.RE
.PP
\fB\-\-hostname\fR \fIhostname\fR
.RS 4
Short or full hostname.
.RE
.PP
\fB\-\-netconf\fR \fInetwork manager\fR
.RS 4
Lets you choose the network manager. Valid values are 'openrc' and 'networkmanager'. The latter can be chosen if NetworkManager is included in your distribution.
.RE
.PP
\fB\-\-dhcp\fR \fIinterface\fR
.RS 4
Getting IP-address through DHCP for the specified interface. If you need to specify two or more interfaces use the option several times.
.RE
.PP
\fB\-\-ip\fR \fB[IFACE:]\fR\fIIP\fR
.RS 4
IPv4 network address with CIDR specified. IFACE can indicate a network interface. The default IFACE value is eth0. You might change it to 192.168.0.1/24, for instance. Specifying several network interfaces is allowed.
.RE
.PP
\fB\-\-route\fR NETWORK:[GATEWAY][:IFACE[:SOURCE]]
.RS 4
Routing rule: network, gateway, interface, source IP. To specify a default gateway, you can set NETWORK at 'default'.
.RE
.PP
\fB\-\-dns\fR \fIDNS\fR
.RS 4
Network address of DNS server.
.RE
.PP
\fB\-\-proxy\fR \fIPROXY\fR
.RS 4
Network address of proxy server.
.RE
.PP
\fB\-\-ntp\fR \fINTP\fR
.RS 4
Network address of NTP timeserver.
.RE
.PP
\fB\-\-nouuid\fR
.RS 4
Disables using UUID device names. If specified, usual device names (/dev/sda1, etc.) will be used. Use it only if you are sure you understand what you do.
.RE
.PP
\fB\-\-video\fR \fIVIDEODRV\fR
.RS 4
Changes Xorg video driver.
.RE
.PP
\fB\-X\fR \fI<width>x<height>\fR
.RS 4
Changes Xorg server resolution.
.RE
.PP
\fB\-\-fb\fR \fI<widht>x<height>\fR
.RS 4
Changes frame buffer resolution.
.RE
.PP
\fB\-\-scheduler\fR \fISCHEDULER\fR
.RS 4
Changes I/O scheduler.
.RE
.PP
\fB\-\-timezone\fR \fITIMEZONE\fR
.RS 4
Changes timezone.
.RE
.PP
\fB\-\-set\fR \fIVAR=VALUE\fR
.RS 4
Alters the internal variable of Calculate utilities. For multiple value changing use the option as many times as you need.
.RE
.PP
\fB\-U\fR, \fB\-\-update\fR
.RS 4
Running install for new versions only. This option is useful if you have alloted a second volume for system update. You should run it together with the '--force' option.
.RE
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
Prevents the system from asking questions while installing.
.RE
.PP
\fB\-\-startup\fR
.RS 4
Configuring the current system. When you run the command, your system is being configured with templates; Calculate utilities are involved in autoconfiguring of any programs installed by the software manager. This command can be run either at booting the livecd or during your first system boot. It allows you to restore the initial system settings. The system configuration can be modified wiith language, network, video and other configuring options.
.RE
.PP
\fB\-\-live\fR
.RS 4
Configure only those parameters that are dependent on hardware. Used in conjunction with the '--startup'.
.RE
.PP
\fB\-\-install\fR
.RS 4
Sets calculate-install for package configuring. Running this in Calculate Linux lets the software manager allow autoconfiguring of programs it installs with calculate-install. The utility is run by the profile.bashrc script from calculate overlay.
.RE
.PP
\fB\-\-uninstall\fR
.RS 4
Disables package configuring by calculate-install.
.RE
.PP
\fB\-\-nospinner\fR
.RS 4
Prevents the progress bar from showing at system install .
.RE
.PP
\fB\-P\fR
.RS 4
Read passwords from standard input. If specified one or more users passwords are read from standard input.
.RE
.PP
\fB\-p\fR, \fB\-\-show-partitions\fR
.RS 4
Shows info about current partitioning. You will then be able to view a table outlining the following info: size, device, label, mounting point, filesystem format, type, installed system.
.RE
.PP
\fB\-v\fR, \fB\-\-show-variables\fR
.RS 4
Lists environment variables of Calculate utilities with their values and changing access flags. For a full output use '-vv'.
.RE
.PP
\fB\-\-filter\fR \fIfilter\fR
.RS 4
Variable filtering. Is used together with '--show-variables'. E.g.: 'cl-install -v --filter=video'.
.RE
.PP
\fB\-\-xml\fR
.RS 4
Lists variables in XML format. To be used with the '--show-variables' option.
.RE
.PP
\fB\-\-color\fR \fIWHEN\fR
.RS 4
Controls coloring. WHEN can take 'never', 'always' or 'auto' values, depending on whether you want or not to display your messages with color.
.RE
.PP
\fB\-\-version\fR
.RS 4
Prints the version number of cl-install, then exits.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Prints help and then exits.
.RE
.SH SEE ALSO
.PP
cl-builder(1), cl-image(1)
.SH EXAMPLES
.PP
Installing the system on /dev/sda2
.nf
cl-install -d /dev/sda2
.fi
.PP
Choosing 'fglrx' as the video driver. Before running be sure 'x11-drivers/ati-drivers' is installed.
.nf
cl-install --startup --set os_install_x11_video_drv=fglrx
.fi
.PP
Installing the system on several partitions. In our example the system will be installed on sda2, all users settings and data are stored on sda5, while sda1 is used as swap.
.nf
cl-install -d /dev/sda2 -d /dev/sda5:/var/calculate -d /var/calculate/home:/home -w /dev/sda1 --hostname calculatelinux
.fi
.PP
Installing the system with the following network options: ip address set at 192.168.1.20, mask set at 255.255.255.0, default gateway set at 192.168.1.1, DNS at 192.168.1.2. OpenRC is used as the network manager.
.nf
cl-install -d /dev/sda2 --ip 192.168.1.20/24 --route default:192.168.1.1 --dns 192.168.1.2 --netconf openrc
.fi
.PP
Installing the router. In our example two network interfaces are configured. For input eth0: ip address set at 1.2.3.6, mask at 255.255.255.252, gateway at 1.2.3.5. For output eth1: ip address set at 192.168.1.1, mask at 255.255.255.0., DNS address at 8.8.8.8. Routing to network 192.168.3.0/24 is made through gateway 192.168.1.2.
.nf
cl-install -d /dev/sda2 --ip eth0:1.2.3.6/30 --route default:1.2.3.5:eth0 --ip eth1:192.168.1.1 --route 192.168.3.0/24:192.168.1.2:eth1 --dns 8.8.8.8
.fi
.SH AUTHORS
.PP
Calculate Utilities are developed by Calculate Ltd. http://www.calculate.ru
.SH AUTHOR
.PP
This man page was originally written by Calculate Ltd.