home *** CD-ROM | disk | FTP | other *** search
/ terabyteunlimited.com / 2014.06.terabyteunlimited.com.tar / terabyteunlimited.com / ifl_en_gui_trial.zip / readme.txt < prev    next >
Text File  |  2011-12-23  |  18KB  |  356 lines
  1. Image for Linux with the IFL Boot Disk
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Image for Linux is a Linux-based disk imaging backup and restore solution.
  5.  
  6.  
  7. Licensing
  8. ~~~~~~~~~
  9. BY COPYING, DISTRIBUTING, INSTALLING, OR USING THE ACCOMPANYING TERABYTE, INC.
  10. ("TERABYTE") SOFTWARE PRODUCT (THE "PRODUCT"), THE INDIVIDUAL OR ENTITY USING
  11. THE PRODUCT ("USER") IS CONSENTING TO BE BOUND BY AND IS BECOMING A PARTY TO
  12. THE TERABYTE LICENSE AGREEMENT INCLUDED WITH THE PRODUCT PACKAGE. IF USER DOES
  13. NOT AGREE TO ALL OF THE TERMS OF THE LICENSE AGREEMENT, USER MUST NOT COPY,
  14. DISTRIBUTE, INSTALL OR USE THE PRODUCT IN ANY MANOR.  IF USER HAS RECEIVED A
  15. SIGNED LICENSE AGREEMENT FOR THE PRODUCT DIRECTLY FROM TERABYTE THAT CONTAINS
  16. TERMS WHICH VARY FROM THE TERMS OF THE INCLUDED LICENSE AGREEMENT, THEN THE
  17. SIGNED LICENSE AGREEMENT GOVERNS THE USE OF THE PRODUCT.
  18.  
  19.  
  20. Introduction
  21. ~~~~~~~~~~~~
  22. This archive contains the IFL Boot Disk, which in turn includes the Image for
  23. Linux program. The IFL Boot Disk supports a wide array of storage devices 
  24. including:
  25.  - IDE hard drives and CD/DVD drives
  26.  - USB 1.1/2.0/3.0 hard drives, flash drives, CD/DVD drives
  27.  - SATA hard drives and CD/DVD drives
  28.  - IEEE 1394 (FireWire) hard drives and CD/DVD drives
  29.  - most SCSI controllers (those supported natively by the Linux kernel)
  30.  - storage devices connected via PCMCIA interface (typically USB or IEEE 1394)
  31.  - ISCSI drives (over network connection)
  32.  - most RAID or SATA/RAID controllers
  33.  
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35. Section 1 - Creating and using the default configuration (iflnet.iso)
  36. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  37. The file iflnet.iso can be burned to CD/DVD from Windows or Linux to run the
  38. default configuration. The default configuration of the disk can be summarized
  39. as follows:
  40.  - wired networking using eth0 and/or eth1 interfaces and dhcp
  41.  - wireless interfaces can be configured manually from the menu
  42.  - console login not required on boot
  43.  - root password is 'ifl' (used for SSH login)
  44.  - the timezone is UTC
  45.  - uses us/qwerty keyboard by default (others selectable after boot)
  46.  - uses 80x25 as default video mode 
  47.  
  48. To create the default CD/DVD boot media in Windows:
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  50. 1. Unzip the IFL archive to a folder of your choice
  51.  
  52. 2. Use the included MakeDisk program to create a CD/DVD or USB flash drive. 
  53.  
  54. Note that for the registered version, burning iflnet.iso directly (with other
  55. software such as Nero) will cause the IFL program to prompt you for the
  56. product key each time it is started. When using MakeDisk, you will be prompted
  57. for the product key once while creating the boot media, and then will not be 
  58. prompted for it again when using the boot media it creates.
  59.  
  60.  
  61. To create the default CD/DVD boot media in Linux:
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  63. 1. Unzip the IFL archive to a directory of your choice
  64.  
  65. 2. Run the included setup script with the command ./setup. The setup script
  66.    will prompt for the IFL product key (registered version only). See section
  67.    2 below for more information.
  68.  
  69. 3. Burn the file iflnet.iso to CD/DVD using appropriate burner software such
  70.    as K3B (GUI program - recommended).
  71.  
  72.  
  73.  
  74. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  75. Section 2 - Working with the IFL Boot Disk from a Linux distribution 
  76. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  77. If using the IFL Boot Disk from a Linux distribution, you will have the ability
  78. to run the IFL program from there, as well as the ability to customize the disk,
  79. install it to a hard drive or UFD, and create a set of boot files for a PXE 
  80. network boot.
  81.  
  82. Setting up the IFL directory on a Linux distribution
  83. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  84. IFL can be set up on a Linux distribution by following these steps:
  85.    
  86.  - Extract the IFL zip archive in a directory of your choice on a Linux 
  87.    partition (not FAT/FAT32 or NTFS). This ensures that no problems with 
  88.    file permissions or upper/lower case will be encountered. 
  89.    
  90.  - Open a terminal window (such as an xterm) and change to the directory
  91.    that the archive was extracted to (the IFL directory).
  92.    
  93.  - Become root
  94.    
  95.  - From the IFL directory, run the command './setup' from the prompt. The 
  96.    setup script will do the following:
  97.  
  98.    - Prompt you to enter your product key (registered version only).
  99.  
  100.    - Present a menu to optionally select Restore Disc settings for restore
  101.      discs created from the Linux distrubution.
  102.  
  103.    - Offer the option to select an IFL language version other than English
  104.  
  105.    - Extract the IFL program (imagel) from iflnet.iso, and set up the IFL
  106.      directory so that bootable restore discs can be created when running
  107.      the IFL program from the Linux distribution.
  108.    
  109.  - Once setup has completed, the IFL program can be started by typing the
  110.    command './imagel' at the prompt.
  111.    
  112.  - To create an IFL CD/DVD boot disc, burn the file iflnet.iso to CD/DVD
  113.    using the burner software of your choice (such as K3b).
  114.  
  115.  - Note that the setup script can be run again to change settings, or
  116.    enter/correct the product key. 
  117.  
  118.  
  119. Setting up the IFL directory to create custom versions:
  120. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  121. The file config.zip contains all items need to created custom versions of the
  122. boot disk. This file is extracted automatically (as of LBD220EN) the first time
  123. that the setup script is executed. This populates the IFL directory with 
  124. several additional files and directories needed to customize the disk.
  125.  
  126. When customizing the disk, the following options are available:
  127.  
  128. a) From the makeISO/HDD/PXE scripts:
  129.  - keyboard map 
  130.  - video mode
  131.  - kernel boot parameters (see boot-problems.txt)
  132.  - LVM activation (see lvm.txt)
  133.  - separate restore disc settings for above (if desired)
  134.  - restore disc command line
  135.  - IFL language version (both restore disc and boot media)
  136.  - require console login
  137.  - change root password from default of 'ifl'
  138.  - configure one or more network interfaces (wired and wireless)
  139.  
  140. b) From the config.txt configuration file and various directories: 
  141.  - include custom scripts in the scripts directory (see scripts.txt)
  142.  - optionally execute some or all of the scripts on boot
  143.  - specify a timezone other than UTC
  144.  - specify a hostname other than 'ifl'
  145.  - start the SSH server automatically on boot (disabled by default)
  146.  - include a custom configuration for ISCSI (see iscsi.txt)
  147.  - enable the ISCSI daemon on boot
  148.  - edit the ifl-custom.ini file to specify custom ifl.ini settings for IFL
  149.  - can enable login from a serial port (COM1 and/or COM2)
  150.  
  151. The following steps are an outline of how to customize the disk:
  152.  
  153. 1. Edit config.txt (optional): If desired, edit the config.txt file in this 
  154.    directory to select and configure the available options. The config.txt file
  155.    is commented to explain each option. If you do not change anything in 
  156.    config.txt, the file will still be included on the disk, but will have no
  157.    effect. 
  158.  
  159. 2. Edit ifl-custom.ini (optional): When the setup script is run the first time, 
  160.    an empty file named ifl-custom.ini will be extracted from config.zip. This 
  161.    file can be edited to specify any desired ifl.ini settings for customized 
  162.    boot media created with the makeISO, makeHDD, and makePXE scripts. When one 
  163.    of those scripts is executed, ifl-custom.ini will be included in the boot
  164.    media, and will appear as ifl.ini in the /tbu directory. If you have no need
  165.    for any IFL settings, the file can be left empty - it won't have any effect. 
  166.    Note that this file is named ifl-custom.ini to separate it from the ifl.ini 
  167.    file also in the IFL directory. The settings in ifl.ini (if any) are only 
  168.    for IFL when executed from the Linux distribution.
  169.  
  170. 3. Set up the scripts directory (optional): If desired, populate the scripts 
  171.    directory with one or more bash scripts that you want to include on the 
  172.    disk. To have one or more of those scripts executed automatically on boot, 
  173.    you also need to configure the RUNSCRIPTS option in config.txt. The default 
  174.    is that NO scripts will be executed. It is not necessary to set permissions 
  175.    on the scripts. That will be taken care of automatically.
  176.  
  177. 4. Set up the iscsi directory (optional): If desired, set up the iscsi 
  178.    directory as needed to work with your network and iscsi target setup.
  179.    When creating custom boot media, the ENTIRE iscsi directory will be copied
  180.    to the root file system at /etc/iscsi, and will replace the default iscsi
  181.    directory there. The iscsi directory initially contains a copy of the 
  182.    default /etc/iscsi directory, so if no changes are made, building a custom 
  183.    disk will have no effect on iscsi operation.
  184.    
  185. 5. Set up the tbosdtfiles directory (optional): If desired, set up the
  186.    tbosdtfiles directory by adding tbosdt scripts, driver files etc. to
  187.    the directory. The tbosdtfiles directory will be included on the boot
  188.    disk in the /tbu directory. 
  189.  
  190. 6. Run 1 of the 3 make scripts (makeISO, makeHDD, or makePXE) to create the
  191.    custom version. Creating a custom version with makeHDD or makePXE requires
  192.    using the /c option. The makeISO script has no command line options, and
  193.    will always create a custom version. When creating a custom version, all of
  194.    the make scripts will present the following options:
  195.    
  196.    Option 1: The IFL Boot Media Settings menu (keyboard, video, etc.)
  197.    Option 2: Require console login? (default = no)
  198.    Option 3: Change the root password? (default = "ifl")
  199.  
  200.    Note that the makeHDD and makePXE scripts can also be used to install the
  201.    default version of the disk, based on iflnet.iso. In that case, the 3
  202.    options listed above will not be presented, and all settings will stay at
  203.    their default values. 
  204.  
  205.  
  206. The makeISO script: (type './makeISO' as root to create custom version)
  207. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  208. The makeISO script creates a custom version in ISO file format, based on the
  209. changes (if any) made in steps 1 through 5 above, and the options selected 
  210. while running the script. The ISO file will be named iflnet-custom.iso. 
  211. The makeISO script has no command line options.
  212.  
  213.  
  214. The makePXE script: (type './makePXE /c' as root to create custom version)
  215. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  216. The makePXE script will create a set of PXE boot files in the pxe directory.
  217. These files can then be used to manually set up a PXE network boot. Please 
  218. refer to the file pxe.txt in the help directory for more information about
  219. setting up a PXE boot.
  220.  
  221. The makePXE script can create either the default version of the disk, or a
  222. custom version as follows:
  223.  
  224. ./makePXE     -> create default version based on iflnet.iso
  225. ./makePXE /c  -> create custom version
  226.   
  227. The /c option will create a custom version based on the changes (if any) 
  228. made in steps 1 through 5 above, and the options selected while running 
  229. the script.
  230.  
  231.  
  232. The makeHDD script: (type './makeHDD' as root to see usage and examples)
  233. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  234. The makeHDD script will install the IFL Boot Disk to a hard drive partition,
  235. or to a UFD (USB Flash Drive). It can be used to install either the default
  236. version (based on iflnet.iso), or a custom version based on the changes 
  237. (if any) made in steps 1 through 5 above, and the options selected while 
  238. running the script.
  239.  
  240. The basic usage of makeHDD is as follows:
  241.  
  242. ./makeHDD /dev/xyz     -> install default version to /dev/xyz
  243. ./makeHDD /dev/xyz /c  -> install custom version to /dev/xyz
  244.  
  245. There are 2 additional options (/a and /mbr) which are covered below. To see
  246. usage information and examples, type './makeHDD' without parameters. 
  247.  
  248. Note that the makeHDD script can also be executed from a CD/DVD created from 
  249. iflnet.iso, or from a custom CD/DVD. In that case, the /c option is not 
  250. available, and makeHDD will always install the same version (default or custom)
  251. that it finds on the CD/DVD.
  252.  
  253. The makeHDD script can install to a partition on a hard drive, OR to a 
  254. partition on a UFD, OR to an entire UFD. An "entire UFD" means that the UFD
  255. will no longer contain any partitions (if it did previously) once the
  256. installation has completed.
  257.  
  258. To install to a partition, the following are required:
  259.  - the partition must already exist
  260.  - the partition must be a FAT16, FAT32, or a Linux (type 83) partition
  261.  - if it's a Linux partition, it must be a primary partition
  262.  - the partition must be at least 32 MB in size
  263.  - if FAT16 or FAT32, the mtools package must be installed
  264.  - the partition does not have to formatted, although it won't matter if it is
  265.  - the partition cannot be currently mounted
  266.  
  267. To install to an entire drive (usually a UFD), the following are required:
  268.  - the drive must be detected by Linux as being a removable drive.
  269.  - the drive must be at least 32 MB in size, but not larger than 8 GB
  270.  - the drive cannot be currently mounted
  271.  - if the drive currently contains partitions, none can be currently mounted
  272.    (ALL existing partitions will be deleted during installation)
  273.  
  274. The makeHDD script will check for the above conditions before installing,
  275. and will exit with an error message if it detects a problem.
  276.  
  277. The command line options available for makeHDD are as follows:
  278.  
  279. The /c option: This option will install a customized version based on the
  280. changes (if any) made in steps 1 through 5 above. If the /c option is not used,
  281. makeHDD will install the default version of the disk, based on iflnet.iso. When
  282. running makeHDD from the boot media, the /c option is not available, and the 
  283. version on that particular CD/DVD (whether it be the default version, or a 
  284. custom version) will always be installed.
  285.  
  286. The /mbr option: This option is available when installing to a partition. It 
  287. installs the standard MBR code to the MBR of the drive containing the target
  288. partition. This option is needed if you intend to boot directly from the drive
  289. (rather than use a boot manager), and it does not already contain MBR code 
  290. (or you want to replace the existing MBR code). The MBR code installed with 
  291. this option is 440 bytes, and will not overwrite the partition table on the 
  292. drive.
  293.  
  294. The /a option: This option will set the target partition active. This option is
  295. required if the partition installed to is on the drive that you are booting
  296. the system from, and that drive has a standard MBR installed. The standard MBR
  297. will look for an active partition to boot. If you intend to boot the partition
  298. from a boot manager (such as BootIt NG), this option is not required. 
  299.  
  300. The makeHDD script has some safeguards built in to help prevent mistakes
  301. like installing to the wrong drive or partition. In all cases, there will be
  302. a confirmation screen displayed where the user must type out the word 'yes'
  303. before going ahead with the installation. On that screen, the command line
  304. entered, as well as the target drive/partition information will be displayed
  305. as a visual check.
  306.  
  307. Additional Notes:
  308.  
  309. 1. Installing to a Linux partition - the extlinux boot loader is used, and the 
  310. partition is formatted as ext2. Extlinux requires that the partition be a 
  311. primary partition. The partition must be at least 32 MB in size.
  312.  
  313. 2. Booting from a Linux partition - the partition will not boot from a drive
  314. other than HD0 unless the drive is "BIOS swapped" so that it becomes HD0 for
  315. that session. This can be accomplished (for example) by using the swap option 
  316. in the BootIt NG boot manager. It can also be accomplished by changing the 
  317. BIOS boot order so that the system boots from that drive.
  318.  
  319. 3. Installing to a FAT16 or FAT32 partition - the partition must be a minimum
  320. of 32 MB. The syslinux boot loader is used. The partition can be either a 
  321. primary partition, or a volume in an extended partition. If it's a volume in 
  322. an extended partition, be sure to read note 4 below.
  323.  
  324. 4. Booting from a FAT16 or FAT32 partition - the partition will not boot from a
  325. drive other than HD0 unless the drive is "BIOS swapped" so that it becomes HD0 
  326. for that session. The exception to this is if BootIt NG is used as the boot
  327. manager - it can boot the partition from any drive. If the partition is a 
  328. volume in an extended partition, it must be booted using a boot manager capable
  329. of doing that, such as BootIt NG.
  330.  
  331. 5. Installing to a UFD (USB Flash Drive) - a UFD can be installed to as either 
  332. a partitioned device, or as an entire drive (not partitioned). 
  333.  
  334.  - Installing to a partition on a UFD is the same as installing to a partition
  335.    on a hard drive. An existing partition (such as /dev/sda1) must be specified. 
  336.    The /mbr option is available when installing to a partition on a UFD.
  337.  
  338.  - To install to the UFD as an entire drive, the entire drive is specified (such
  339.    as /dev/sda or /dev/sdb). This can be done even if the drive currently 
  340.    contains partitions, although ALL partitions will be deleted during the
  341.    installation. The makeHDD script warns about this condition twice before 
  342.    installing, requiring that you type 'yes' both times to confirm.
  343.  
  344.  - When installing to the entire drive, the drive cannot be larger than 8 GB
  345.    for data safety reasons.
  346.  
  347.  - When installing to the entire drive, the syslinux boot loader is used, and
  348.    the device is formatted as a FAT16 file system using a prepared 32 MB image. 
  349.  
  350. 6. Booting from a UFD - the system BIOS must capable of booting from a USB 
  351. drive, and must be set to boot from that device. This is accomplished by 
  352. entering the BIOS setup and changing the boot order. Many systems also have a
  353. key to press during boot which brings up a menu of devices to boot from. 
  354. Selecting the UFD from this menu will make the UFD the boot device for that 
  355. session.
  356.