*********** Welcome to use drbl-winRoll installation *************

       NCHC Free Software Labs  , NCHC ,Taiwan
       GPL      
       ceasar _at_ nchc org tw ,steven _at_ nchc org tw
  *********************************************************

Feature :

• Change MS Windows hostname, "workgroup" name automatically
• Assign a random SID for Windows, setup sshd service automatically
• Compatible with other image clone tool (like: Clonezilla, ghost, Acronis True Image, .etc) to be able to restore large-scale windows system by utilizing one template image

• drbl-winRoll itself is lincesed under GNU GPL.
• It incorporates code from wsname and newsid projects, each of which has its own licence terms. Standard disclaimers apply.

1. Download 
   * The last version -[v200707.1]
   

   

   - Released 25-July.-2007
   - Size: 18.1 MB
   - MD5SUMS

   * Other versions: [NCHC@Taiwan]
   

   Installer 
    
	[Sourceforge]
	[NCHC]
   

   Zip

	[Souceforge]
	[NCHC]
   
   
      -- If you need md5sum check tool for Windows: md5summer
      -- If you need unzip tool for Windows,  we suggest 7-zip
      -- If you need NSIS to repackage  a new winroll.nsi , Please refer to here

2. Note :
   1. Please install the package with Administrator(s) privelege and make sure Internet connection is work fine.
   2. Please remove cygwin if you had installed it before
   3. The installation can works fine on Windows 2000, Windows XP, Windows 2003 serial operation system
	[More information]

3. Installation :
  EXE format:
   1. Only need to execute the download file
  ZIP format:
   1. Unzip the package: drbl-winRoll_xxxxxx.zip
   2. Execute the "winRoll-setup.bat", and the program will lead to complete installation.
   

4. How to change the MS-Windows hostname format via drbl-winRoll tool ?
   DRBL-winRoll's defalut is to name the hostname by using the last six  IP numbers with prefix "PC", ex:
   Its IP is 192.168.1.52, then its hostname would be : PC-001-052
   You can follow the steps to change hostname format as you like:
   
   1. Start to configure:
   [Programs] -> [Cygwin] -> [drbl_winRoll-config] , to edit  "winRoll.txt" 
   HN_WSNAME_PARAM = xxxx 
    
   2. find out the line and replace its parameter :
   HN_WSNAME_PARAM = xxxx
   
   The parameter guide is as follow :

   #	HN_WSNAME_PARAM = /N:PC-$MAC		PC-"Mac Adress" ，ex: PC-000C294EEF53
   #	HN_WSNAME_PARAM = /N:PC-$MAC[+8]	MYPC-"Mac Adress the last 8  characters", ex: MYPC-000C294E
   #	HN_WSNAME_PARAM = /N:PC-$IP		My-"IP address"，ex: My-192-168-001-052
   #	HN_WSNAME_PARAM = /N:PC-$IP[3+]		Desktop-" IP the first 3 characters"，ex: Desktop-192

   3. Advnace configuartion: By a local file
   You may want to name the hostname by a local file, edit "HN_WSNAME_PARAM = xxxx "
   like the follow:
   HN_WSNAME_PARAM = /RDF:C:\cygwin\drbl_winRoll-config\hosts.txt /DFK:$MAC
   /RDF define the path of local file，/DFK define the field for searching key

   A sample for hosts file: "IP or MAc Address" = "hostname", ex:
   000C294EEF53 = Student-01	(Assign "Student-01" as hostname if its MAC address is 000C294EEF53 )
   192-168-001-012 = Student-02	(Assign "Student-02" as hostname if its IP address is 192.168.1.12 )

   if it use /DFK:$MAC, Windows would be assigned as "Student-01"，/DFK:$IP it would be "Student-02"

   In this way, mananger can define hostname free! But we suggest you to collect all MAC address 
   in template macine first. The other cloned machines would be named hostname automatically.

   PS:
   In drbl-winRoll, it changes the hostname by wsname tool.  So the  format of hostname we provide
    is fully consistent  with wsname tool so far.

   ** It would need to reboot during machine boot if computer change its hostname
   

5. Any steps need to do after install drbl-winRoll ?
   If you want to your windows clients can accept the commands from DRBL server, please follow 
   the step:
   1. Create teh root's ssh keys (private and public key) , and press [Enter] during ask "passphrase "
      during the process.
     $ ssh-keygen -d
     Generating public/private rsa key pair.
     Enter file in which to save the key (/root/.ssh/id_rsa):
     Enter passphrase (empty for no passphrase):
     Enter same passphrase again:
     Your identification has been saved in /root/.ssh/id_rsa.
     Your public key has been saved in /root/.ssh/id_rsa.pub.
     The key fingerprint is:
     fe:56:XX:XX:XX:XX:XX:XX:XX:XX:83:ff:42 root@drbl-server

   2. It would create the root' ssh keys: id_dsa id_dsa.pub , as the follow:
     $  ls /root/.ssh
     id_dsa  id_dsa.pub
     
   3. Transmit the file "id_dsa.pub" to the directory (c:\cygwin\home\administrator\.ssh) in windows 
    and save the file  as "authorized_keys" 
   Ex:  copy [path-of-id_dsa.pub] c:\cygwin\home\administrator\.ssh\authorized_keys
     
     As the follow illustrator: 
      
   4. After step 3, you can test to send a command from drbl server to MS-client. It would not ask for
     password if you setup the above steps correctly ,ex:
     $ ssh  administrator@[win-client-ip]  ipconfig

   5. After all, you can send a command to clients from DRBL server, ex:

6. How to name "workgroup" ?
   Please ssigned by three parameters
	-1. fix string , ex: WG
	-2. By IP/Netmask, ex: GROUP-$NM
		ip:192.168.20.2	NM:255.255.255.0 => Workgroup: GROUP-020
		ip:172.18.1.5	NM:255.255.0.0 => Workgroup: GROUP-018-001
	-3. By DNS suffix , ex :WG-$DNS_SUFFIX
		DNS Suffix Search List. . . . . . : my..org.domain  => WG-my-org
	It use fix string "WG" as default parameters.

   let us know if any suggestion !!

7. How to renew Windows SID ?
   1. Service would record the NIC mac address, it would give a new SID if service discover a new one mac address.
   2. For security reason , SID should be given randomly, And service would encode the mac address what it discover via md5sum. 

8. Other toolkits
   [Stable]
   * EZ command sender : EZ-commands
   	Description: A easy toolkit to send commands from windows client to server 
   [Testing]
   * User desktop recover tool : winroll-recover
   	Description: Windows user desktop recover tool. More detail please read inside document.


9. Multi-language support
  * The installation suppport the follow language , and thanks the people's effort in language transaltion and testbed report !!
    - Traditional Chinese
    - English
    - French	: joel_at_gondouin_net
    - Dutch : Dave Haakenhout (Almere, Netherlands)

  * Help us to translate !!
   [How to]

** History
   [ English ]
    

• drbl-winRoll FAQ [ English ] [ Chinese ]