> Hi Jeff, > Thank you for doing this, I think it was needed, as setting up Unattended is not > very easy when > you don't know where to start...
The motivation for the documentation was to understand it myself :) That and I wanted to write a script to download and setup unattended from the ground up. > Here are a few things you might want to add : > * In the overview, add something to explain that you can also do a network boot and > load the files > directly on the network using PXE, then you don't need a boot disk added > * When you give download links for unattended, don't give direct links because they > will change > with every version. For example instead of "Download Unattended main from > http://prdownloads.sourceforge.net/unattended/unattended-4.0a.tar.gz?download"; you > might want to say something like "Go to the project download page at > https://sourceforge.net/project/showfiles.php?group_id=62053 and grab the > unattended-x.x.tar.gz > file, where x.x is the current version number" The problem is that I have to mention the exact version in other places because the zip file will unzip with a directory structure that looks like: ----unattended-4.0a |---bootdisk |---html |---install |---linuxboot If the zip file instead contained something like: |---bootdisk |---html |---install |---linuxboot Then I could remove the specifics in the command line examples, etc. For now I've modified all the examples, etc to use unattended-x.xx, although I'd still like to be able to have the user type the commands verbatim. I would prefer.... . net share install=c:\unattended\install instead of net share install=c:\unattended\unattended-x.xx\install > * Maybe move to the "3. Setup Unattended: Boot Disk" section the thing you said at > the end about > burning the CD image. Also explain that, if you don't have a CD drive on the target > machine, you > can use the floppy images that are in the bootdisk\images folder. Done, good idea. > * Sections 5 and 6 : if people want to do download all the packages and updates > automatically from > the internet, they might want to use the "prepare" script. On a linux server, it > should work as > long as they have perl installed. On a windows server, all you have to do is install > cygwin from > http://www.cygwin.com/ (be sure to add the perl package in the "interpreters" > section of the > cygwin install), then start up cygwin, go to the unattended/install folder and run > "./prepare". If > you don't have an English version of Windows, add the language code as an argument. > For example > for a French version, run "./prepare FRA". Whoa!, I added a section for this. Looking through os.html, apps.html and advanced.html I was unable to find any reference to the prepare script. I thought I was going to have to download all that by hand! :) > * You might want to add a last step saying "Configure the settings for your site > according to the > instructions from http://unattended.sourceforge.net/advanced.html"; Done. > * In the "2. Setup Unattended" section, maybe you could inform people that they > don't *have* to > enable guest access to the share if they don't want to. They can configure the > settings they use > to access the share when the bootdisk asks "do you want to override bootdisk > defaults ?" (or > something like this, I don't remember exactly). Yeah, that deserved a little clarification. > Hmm, maybe this is too much information for a "quick install guide", I don't know. > Just let me > know what you think about it. And thanks again for you work. > > Sylvain. This is starting to look like a handy little guide, thanks :) -Jeff Step-By-Step Quick Install Guide ----------------------------------------- Documentation: ---------------- 1. What is Unattended http://unattended.sourceforge.net 2. Unattended OS Setup http://unattended.sourceforge.net/os.html 3. Unattended Application Setup http://unattended.sourceforge.net/apps.html 4. Customize Unattended for your site http://unattended.sourceforge.net/advanced.html Assumptions: -------------- a. DHCP server on your network b. Server capable of sharing files c. cygwin is installed [ http://www.cygwin.com ] How to read this document: ---------------------------- a. $ is a command typed from the cygwin bash prompt b. c:\> is a command typed from the CMD prompt 1. Overview - What does unattended do? ---------------------------------------- a. Boot 'clean' and get on the network I. Boot using an Unattended Boot disk II. Load a network card driver III. Obtain an IP via DHCP IV. Map a drive z: to \\servername\sharename b. Prepare the Disk I. Create a partition (optional) II. Format (optional) b. Install Windows I. Run z:\dosbin\install.pl via Perl c. Install Applications I. Map a drive z: to \\servername\sharename II. Make a list of OS Updates and applications to install using todo.pl III. Install OS Updates and Applications, Run z:\bin\todo.pl --go 2. Setup Unattended --------------------- a. Download Unattended main http://prdownloads.sourceforge.net/unattended/ unattended-x.xx.tar.gz b. Unzip the Unattended-x.xx.tar.gz file to c:\unattended *** WARNING - If you dont yet have cygwin installed you cannot use cygwin to extract the archive *** $ tar -xfz unattended-x.xx.tar.gz /cygdrive/c/unattended/ c. Setup the Unattended File Share I. Create the SMB file share for unattended c:\> net share install=c:\unattended\unattended-x.xx\install II. Decide what windows user will authenticate with the server when accessing the share. Keep in mind, you can authenticate with any username / password that has access a. Change the permissions on the files to allow the appropriate user to access it. c:\> set unattendeduser=guest c:\> cacls c:\unattended\unattended-x.xx /T /E /G:%unattendeduser% b. (optional) If you will be using the guest account then make sure it is enabled. c:\> net user guest /ACTIVE:YES /DOMAIN 3. Setup Unattended: Boot Disk -------------------------------- a. DOS Boot Disk I. Download Unattended DOS boot disk http://prdownloads.sourceforge.net/unattended/ unattended-x.xx-dosboot.tar.gz II. Unzip unattended-x.xx-dosboot.tar.gz to c:\unattended\ *** WARNING - If you dont yet have cygwin installed you cannot use cygwin to extract the archive *** $ tar -xfz unattended-x.xx-dosboot.tar.gz /cygdrive/c/unattended/ III. Download djgpp and apps for DOS and extract them to c:\unattended\unattended-x.xx\install\djgpp ftp://ftp.delorie.com/pub/djgpp/current/v2/djdev203.zip ftp://ftp.delorie.com/pub/djgpp/current/v2misc/csdpmi5b.zip ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/perl561b.zip ftp://ftp.delorie.com/pub/djgpp/current/v2apps/pico396b.zip IV. Creating the boot media A workstation an boot into Unattended from CDROM, Floppy or PXE a. Bootable CD the cd image can be found under: \bootdisk\bootdisk.iso b. Bootable Floppy the floppy image can be found under: \bootdisk\images\*.imz c. PXE - "nothing but net" http://unattended.sourceforge.net/os.htm b. Linux Boot Disk (Experimental) I. Download Unattended Linux boot disk http://prdownloads.sourceforge.net/unattended/ unattended-x.xx-linuxboot.tar.gz II. Unzip unattended-x.xx-linuxboot.tar.gz to c:\unattended\ *** WARNING - If you dont yet have cygwin installed you cannot use cygwin to extract the archive *** $ tar -xfz unattended-x.xx-linuxboot.tar.gz /cygdrive/c/unattended/ III. Creating the boot media Unattended's linux boot disk can be booted from CDROM or PXE a. Bootable CD the cd image can be found under: \linuxboot\linuxboot.iso b. PXE - "nothing but net" http://unattended.sourceforge.net/os.html 4. Setup OS Distribution Point -------------------------------- a. Copy OS's to the network share. I. Copy Operating Systems to an appropriately named directory ex1. xcopy d:\ c:\unattended\unattended-x.xx\install\os\win2ksp4 ex2. xcopy d:\ c:\unattended\unattended-x.xx\install\os\winxp ex3. xcopy d:\ c:\unattended\unattended-x.xx\install\os\winxpsp1 note: install.pl knows what os is in the folder based on folder content not on the folder name 5. Download Unattended dependencies ------------------------------------- a. Parse all the scripts located in /scripts for necessary files and download them ********************************************************************************* *** !!Warning ./prepare will by default download ~1000 MB from the Internet!! *** ********************************************************************************* $ cd /cygdrive/c/unattended/unattended-x.xx/install $ ./prepare 6. Test Unattended -------------------- a. Boot a workstation using your chosen boot method (DOS or linux) *************************************************************************** *** !!Warning Unattended can and will destroy data on the workstation!! *** *************************************************************************** follow the prompts create a partition format the hard drive choose what OS to install choose what application set to install b. more documentation goes here 7. Customize Unattended ------------------------- a. Customize Unattended settings for your site according to the instructions from http://unattended.sourceforge.net/advanced.html -------------------------------------------------------- Changelog -------------------------------------------------------- 3/18/2004 Rev 0.04 After recieving comments from Sylvain added section about ./prepare added note to boot disk sections about making floppies/cdrom added note about PXE booting re-organize 2. Unattended Setup, made it more clear that guest was not a requirement add cygwin as a requirement for installation, it makes life so much easier, and allows the ./prepare script to run fix the unzip steps to use cygwin tar 3/17/2004 Rev 0.02 General Cleanup Document restructured 3/13/2004 rev 0.01 Rough Draft - 1st revision dos djgpp perl installation is still a work in progress
Step-By-Step Quick Install Guide ----------------------------------------- Documentation: ---------------- 1. What is Unattended http://unattended.sourceforge.net 2. Unattended OS Setup http://unattended.sourceforge.net/os.html 3. Unattended Application Setup http://unattended.sourceforge.net/apps.html 4. Customize Unattended for your site http://unattended.sourceforge.net/advanced.html Assumptions: -------------- a. DHCP server on your network b. Server capable of sharing files c. cygwin is installed [ http://www.cygwin.com ] How to read this document: ---------------------------- a. $ is a command typed from the cygwin bash prompt b. c:\> is a command typed from the CMD prompt 1. Overview - What does unattended do? ---------------------------------------- a. Boot �clean� and get on the network I. Boot using an Unattended Boot disk II. Load a network card driver III. Obtain an IP via DHCP IV. Map a drive z: to \\servername\sharename b. Prepare the Disk I. Create a partition (optional) II. Format (optional) b. Install Windows I. Run z:\dosbin\install.pl via Perl c. Install Applications I. Map a drive z: to \\servername\sharename II. Make a list of OS Updates and applications to install using todo.pl III. Install OS Updates and Applications, Run z:\bin\todo.pl --go 2. Setup Unattended --------------------- a. Download Unattended main http://prdownloads.sourceforge.net/unattended/ unattended-x.xx.tar.gz b. Unzip the Unattended-x.xx.tar.gz file to c:\unattended *** WARNING - If you dont yet have cygwin installed you cannot use cygwin to extract the archive *** $ tar -xfz unattended-x.xx.tar.gz /cygdrive/c/unattended/ c. Setup the Unattended File Share I. Create the SMB file share for unattended c:\> net share install=c:\unattended\unattended-x.xx\install II. Decide what windows user will authenticate with the server when accessing the share. Keep in mind, you can authenticate with any username / password that has access a. Change the permissions on the files to allow the appropriate user to access it. c:\> set unattendeduser=guest c:\> cacls c:\unattended\unattended-x.xx /T /E /G:%unattendeduser% b. (optional) If you will be using the guest account then make sure it is enabled. c:\> net user guest /ACTIVE:YES /DOMAIN 3. Setup Unattended: Boot Disk -------------------------------- a. DOS Boot Disk I. Download Unattended DOS boot disk http://prdownloads.sourceforge.net/unattended/ unattended-x.xx-dosboot.tar.gz II. Unzip unattended-x.xx-dosboot.tar.gz to c:\unattended\ *** WARNING - If you dont yet have cygwin installed you cannot use cygwin to extract the archive *** $ tar -xfz unattended-x.xx-dosboot.tar.gz /cygdrive/c/unattended/ III. Download djgpp and apps for DOS and extract them to c:\unattended\unattended-x.xx\install\djgpp ftp://ftp.delorie.com/pub/djgpp/current/v2/djdev203.zip ftp://ftp.delorie.com/pub/djgpp/current/v2misc/csdpmi5b.zip ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/perl561b.zip ftp://ftp.delorie.com/pub/djgpp/current/v2apps/pico396b.zip IV. Creating the boot media A workstation an boot into Unattended from CDROM, Floppy or PXE a. Bootable CD the cd image can be found under: \bootdisk\bootdisk.iso b. Bootable Floppy the floppy image can be found under: \bootdisk\images\*.imz c. PXE - "nothing but net" http://unattended.sourceforge.net/os.htm b. Linux Boot Disk (Experimental) I. Download Unattended Linux boot disk http://prdownloads.sourceforge.net/unattended/ unattended-x.xx-linuxboot.tar.gz II. Unzip unattended-x.xx-linuxboot.tar.gz to c:\unattended\ *** WARNING - If you dont yet have cygwin installed you cannot use cygwin to extract the archive *** $ tar -xfz unattended-x.xx-linuxboot.tar.gz /cygdrive/c/unattended/ III. Creating the boot media Unattended's linux boot disk can be booted from CDROM or PXE a. Bootable CD the cd image can be found under: \linuxboot\linuxboot.iso b. PXE - "nothing but net" http://unattended.sourceforge.net/os.html 4. Setup OS Distribution Point -------------------------------- a. Copy OS's to the network share. I. Copy Operating Systems to an appropriately named directory ex1. xcopy d:\ c:\unattended\unattended-x.xx\install\os\win2ksp4 ex2. xcopy d:\ c:\unattended\unattended-x.xx\install\os\winxp ex3. xcopy d:\ c:\unattended\unattended-x.xx\install\os\winxpsp1 note: install.pl knows what os is in the folder based on folder content not on the folder name 5. Download Unattended dependencies ------------------------------------- a. Parse all the scripts located in /scripts for necessary files and download them ********************************************************************************* *** !!Warning ./prepare will by default download ~1000 MB from the Internet!! *** ********************************************************************************* $ cd /cygdrive/c/unattended/unattended-x.xx/install $ ./prepare 6. Test Unattended -------------------- a. Boot a workstation using your chosen boot method (DOS or linux) *************************************************************************** *** !!Warning Unattended can and will destroy data on the workstation!! *** *************************************************************************** follow the prompts create a partition format the hard drive choose what OS to install choose what application set to install b. more documentation goes here 7. Customize Unattended ------------------------- a. Customize Unattended settings for your site according to the instructions from http://unattended.sourceforge.net/advanced.html -------------------------------------------------------- Changelog -------------------------------------------------------- 3/18/2004 Rev 0.04 After recieving comments from Sylvain added section about ./prepare added note to boot disk sections about making floppies/cdrom added note about PXE booting re-organize 2. Unattended Setup, made it more clear that guest was not a requirement add cygwin as a requirement for installation, it makes life so much easier, and allows the ./prepare script to run fix the unzip steps to use cygwin tar 3/17/2004 Rev 0.02 General Cleanup Document restructured 3/13/2004 rev 0.01 Rough Draft - 1st revision dos djgpp perl installation is still a work in progress
