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

13 years ago
.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
13 years ago
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
13 years ago
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
13 years ago
Installation on external hard drive is basically the same, but it is not hardware-dependent.
.PP
13 years ago
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
13 years ago
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
13 years ago
Disk for Master Boot Record (MBR). Setting the 'off' value disables boot record altering.
.RE
.PP
\fB\-\-type\fR \fIdevice type\fR
.RS 4
13 years ago
Device type. Valid values are hdd, usb-hdd, and flash.
.RE
.PP
\fB\-\-iso\fR \fIpath to file\fR
.RS 4
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
Users added to the installed system. For adding several users use the option as many times as you need.
.RE
.PP
13 years ago
\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
13 years ago
Short or full hostname.
.RE
.PP
\fB\-\-netconf\fR \fInetwork manager\fR
.RS 4
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
\fB\-\-video\fR \fIVIDEODRV\fR
.RS 4
13 years ago
Changes Xorg video driver.
13 years ago
.RE
.PP
\fB\-X\fR \fI<width>x<height>\fR
.RS 4
13 years ago
Changes Xorg server resolution.
13 years ago
.RE
.PP
\fB\-\-fb\fR \fI<widht>x<height>\fR
.RS 4
13 years ago
Changes frame buffer resolution.
13 years ago
.RE
.PP
\fB\-\-scheduler\fR \fISCHEDULER\fR
.RS 4
Changes I/O scheduler.
.RE
.PP
13 years ago
\fB\-\-timezone\fR \fITIMEZONE\fR
.RS 4
Changes timezone.
.RE
.PP
\fB\-\-set\fR \fIVAR=VALUE\fR
.RS 4
13 years ago
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
13 years ago
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
13 years ago
Prevents the system from asking questions while installing.
.RE
.PP
\fB\-\-startup\fR
.RS 4
13 years ago
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
13 years ago
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
13 years ago
Disables package configuring by calculate-install.
.RE
.PP
\fB\-\-nospinner\fR
.RS 4
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
Lists variables in XML format. To be used with the '--show-variables' option.
.RE
.PP
\fB\-\-color\fR \fIWHEN\fR
.RS 4
13 years ago
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
13 years ago
Prints the version number of cl-install, then exits.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
13 years ago
Prints help and then exits.
.RE
.SH SEE ALSO
.PP
cl-builder(1), cl-image(1)
.SH EXAMPLES
.PP
13 years ago
Installing the system on /dev/sda2
.nf
cl-install -d /dev/sda2
.fi
.PP
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
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
13 years ago
.SH AUTHOR
.PP
13 years ago
This man page was originally written by Calculate Ltd.