DRBL-winroll - A MS-Windows extension tool
MS Windows extension tool over DRBL environment
It supports Windows client to accecpt command from DRBL server and to solve related problems via using image clone tool on MS winodws.
*********** Welcome to use drbl-winroll ***********
Free Software Labs , NCHC ,Taiwan
GPL
ceasar _at_ nchc org tw, steven _at_ nchc org tw
*******************************************************
Download Presentation[PDF] [ODP] Installation Other tool Screenshot Documents Language Support Forum Mail List

Page Index

Locations of visitors to this page
drbl-winroll is a tool that enables MS-Windows client to accept commands from DRBL server, and it resolve windows hostname, SID duplication problem via using image clone tool at single local LAN.It can also adjust "workgroup" name and Windows network configuration automatically.

Feature :

  • Adjust Windows hostname, workgroup name, SID automatically
  • Provide network auto-setup function
  • Install sshd service
  • 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
License :
  • drbl-winroll itself is licensed under GNU GPL
  • It incorporates code from wsname and newsid porjects, each of which has its own license terms
  • Standard disclaimers apply

  1. Download

    • Stable Version : [NCHC] [Souceforge]
    • Testing Version: [NCHC] [Souceforge]
    • Use SVN Repository:
      • svn export https://tux.nchc.org.tw/svn/drbl-winroll/trunk drbl-winroll

    • Note :
      • 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 drbl-winroll by winroll.nsi, Please refer to here

  2. Installation

    • EXE:
      1. Download drbl-winroll-setup-x.x.x-setup.exe then execute it
    • ZIP:
      1. Unzip the package : drbl-winroll-x.x.x-setup.zip
      2. Execute the "winroll-setup.bat" , and the program will lead to complete installation
    • Note :
      1. Please install the package with Administrator(s) privelege (Option: Make sure Internet connection is work fine if you need install newsid program from Internet)
      2. Please remove cygwin if you had installed it before; Or, use 『Install over』 option to install
      3. It suports Windows 2000/ Windows XP/Windows 2003/Vista/Windows 7 series OS
      4. For Vista or Windows 7 OS, please refer hereTo Disable UAC function before installation。If you still need UAC function, please re-enable it after installtion.


    Start to install drbl-winroll

  3. How to configure Windows HOSTNAME format via drbl-winroll ?

    4. By default, DRBL-winroll use the last six numbers of IP with one prefix string : "PC" as HOSTNAME for Windows, ex:
    IP is 192.168.1.52 , the its hostname would be : PC-001-052
    You can follow the steps to change HOSTNAME format :
    1. [Programs]-> [Cygwin]-> [drbl_winroll-config] , to edit "winroll.txt"


    2. Find out the follow line then replace the parameter :
      3. 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-"last 8 codes of Mac Adress ", 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-"last 3 codes of IP address", ex: Desktop-192)

    3. Advnaced mode : By config file
      4. DRBL-winroll also provide to setup HOSTNAME by a config file from local. Please edit "HN_WSNAME_PARAM = xxxx " as the follow:
      HN_WSNAME_PARAM = /RDF:C:\cygwin\drbl_winRoll-config\hosts.txt /DFK:$MAC
      Note: /RDF define the path of local file, /DFK define the field for searching key

      A reference format in hosts.txt is : "IP or MAc Address" = "hostname" , the follow for more detail :
      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 )
      Note: Hostname would be assigned as "Student-01" via /DFK:$MAC ; /DFK:$IP it would be "Student-02"

      By 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.



    Windows have to reboot if its HOSTNAME or WORKGROUP be changed

  4. How to configure WORKGROUP name via drbl-winroll ?

    5. DRBL-winroll provides three options :
    1. By fix string , ex: WG
    2. By IP/Netmask, ex: GROUP-$NM
      3. Use Windows IP address compared with Netmask and add a prefix string : "WG" (you can edit it in winroll.conf) as WORKGROUP name, ex :
      ip:192.168.20.2 NM:255.255.255.0=> workgroup will be "GROUP-020"
      ip:172.18.1.5 NM:255.255.0.0 => workgroup will be "GROUP-018-001"
    3. By DNS Suffix : $DNS_SUFFIX
      4. DNS SUFFIX is one of IP information from DHCP service. On this option, drbl-winroll would use the fisrt two string (ex: get "nchc.org" form "nchc.org.tw") then replace "." with "-" (ex: "nchc.org" -> "nchc-org" ). You can use "ipconfig /all" command to show "DNS Suffix " information on Windows OS.
      DNS Suffix Search List. . . . . . : my.org.domain=> WORKGROUP will be "WG-my-org"

      Note :
      drbl-winroll use FIX STRING "WG" as default format for WORKGROUP

  5. How to use auto-setup Network Configuration via drbl-winroll ?

    6. drbl-winroll provide 3 options to setup Windows network automatically. Open [Programs] -> [Cygwin]-> [drbl_winroll-config] , find out the follow parameter and edit it in "winroll.txt" CONFIG_NETWORK_MODE = xxxx
    The parameter guide is as follow :
    CONFIG_NETWORK_MODE = dhcp     (use DHCP method)
    CONFIG_NETWORK_MODE = /RDF:/drbl_winroll-config/client-mac-network.conf    (By config file from local)
    CONFIG_NETWORK_MODE = none    (skip network configuration, even no use dhcp )

    1. drbl-winroll use DHCP as default for Windows clients

    2. Advnaced mode : By config file
      3. Make sure CONFIG_NETWORK_MODE = /RDF:/drbl_winroll-config/client-mac-network.conf in winroll.txt,
      then edit c:\cygwin\drbl_winroll-config\client-mac-network.conf

      The follow is a sample for client-mac-network.conf : 

      _DEFAULT_NETWORK	= 192.168.100.254/24  # assign network and netmask
_DEFAULT_GATEWAY	= 192.168.100.254		# assign default gateway
_DEFAULT_DNS		= 168.95.1.1	# DNS, it could be empty, one or many values (use SPACE as separated ) 
_DEFAULT_WINS		= 192.168.100.1	# WINS, it could be empty, one or many values (use SPACE as separated ) 
_DEFAULT_DNS_SUFFIX	= # DNS_SUFFIX, it could be empty,

subnet 10.0.2.0/8 {
	THIS_GATEWAY	= 10.0.2.2 # use 10.0.2.2 as default gateway for this network
	THIS_DNS	= 10.0.1.1	# use 10.0.1.1 as default DNS for this network
	THIS_WINS	= 		# Use nothing as  _DEFAULT_WINS value
	# This subnet would inherit the "_DEFAULT_DNS_SUFFIX" value form global settings
	# because no set value for it in this session
}

subnet 192.168.0.0/24 {
	THIS_GATEWAY		= 192.168.0.254
	THIS_DNS			= 192.168.0.1
	#THIS _WINS
	#  This subnet would inherit "_DEFAULT_WINS" and 
	# "_DEFAULT_DNS_SUFFIX" value form global settings 
}

[IP Address]
00-00-00-00-00-01 = 192.168.100.11
00-00-00-00-00-02 = 10.0.2.30  # it would use settings of subnet 10.0.2.0/8
00-00-00-00-00-03 = 192.168.0.7  #  it would use settings of subnet 192.168.0.0/24
00-00-00-00-00-04 = dhcp  # uses dhcp
00-00-00-00-00-05 = none  # skip this NIC
    3. There two samples for network cofiguration in c:\cygwin\drbl_winroll-doc\sample\

  6. How to renew MS Windows SID ?

    1. Service would record NIC mac address of Windows machine, 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

      3. Note: Some news about "NewSid Retired ?" [1] [2]

  7. How to make Windows clients to accept the commands form DRBL server automatically ?

    8. If you want to your windows clients can accept the commands from DRBL server, please follow the step:
    1. Switch to root in your DRBL serer. Make sure do "id_rsa" and "id_rsa.pub" exist in /root/.ssh , jump to stpe 3 if yes.
    2. Create root's ssh keys (private and public key) , and press [Enter] when it asks "passphrase " ( mean no passphrase)
      3. $ 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
    3. It would create "id_rsa" and "id_rsa.pub" in /root/.ssh, ex:
      4. $ ls /root/.ssh
      id_dsa id_dsa.pub
    4. "Copy" (ex: use "scp" command or usb flash) id_rsa.pub from DRBL server to Windows and save the file name as "authorized_keys" in Administrator's .ssh folder of cygwin home directory (c:\cygwin\home\administrator\.ssh), ex :
      5. c:\your\windows\path> copy [path-of-id_dsa.pub] c:\cygwin\home\administrator\.ssh\authorized_keys
      Or use "ssh-copy-id" command on DRBL server to transmit
      sudo ssh-copy-id -i ~/.ssh/id_rsa.pub administrator@[win-client-ip]

      Store public key in c:\cygwin\home\administrator\.ssh named as "authorized_keys"

    5. you can test the result via to send a command from drbl server to MS-client. It would not ask password if you setup the above steps correctly ,ex:
      6. $ ssh administrator@[win-client-ip] ipconfig
    6. After all, you can send a command to clients from DRBL server via "/opt/drbl/sbin/dcs" command.

  8. Language Support

    • DRBL-winroll suppports the follow languages, 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]

  9. Other

    • Text FAQ : [ Chinese ][English ]
    • Web FAQ : Readhere
    • History : Read here
    • Other Tools
      • [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.