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
ceasar _at_ nchc org tw, steven _at_ nchc org tw
Download Installation Other tool Screenshot Documents i18n Forum Mail List Credits

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
  • Provide auto-add to AD domain functionNEW from v1.3.0
  • Prodive system monitor service in Windows clientsNEW from v1.3.1
  • 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
  2. Support : Windows 2000/ Windows XP/Windows 2003/Vista/Windows 7/Windows 2008

    • Note :
      • If you need md5sum check tool for Windows : md5summer
      • If you need unzip tool for Windows, we suggest 7-zip
      • This project use NSIS to package as executable installer. The winroll.nsi file is stored in ~/drbl-winroll/tool

  3. 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. For Vista or Windows 7/2008 OS, please refer here to disable UAC function before installation。If you still need UAC function, please re-enable it after installtion.

    Start to install DRBL-Winroll

  4. How to configure Windows HOSTNAME format via DRBL-Winroll ?
  5. By default, DRBL-winroll use the last six numbers of IP with one prefix string : "PC" as HOSTNAME for Windows, ex:
    IP is , 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.conf"

    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-$ZFIP[3+]    (Last IP (ex: 3 chars with zero-filled, got:'PC-052'. Due to IP string became to '192-168-001-052';As default vaule.)
      # HN_WSNAME_PARAM = /N:PC-$ZFIP[4+]    (Last IP 4 chars with zero-filled, got:'PC--052')

      # ----- Other common parameters
      # HN_WSNAME_PARAM = /N:PC-$MAC    (ex: PC-000C294EEF53)
      # HN_WSNAME_PARAM = /N:PC-$MAC[+8]    (First 8 codes of Mac Adress ", ex: PC-000C294E)
      # HN_WSNAME_PARAM = /N:PC-$IP[3+]    (Last 3 characters of IP, got: 'PC--52'. Due to IP string became to '192-168-1-52')
      # HN_WSNAME_PARAM = /N:PC-$IP[4+]    (Last 4 characters of IP, got: 'PC-1-52')

    4. Advaced mode : By config file
    5. 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.conf /DFK:$MAC
      Note: /RDF define the path of local file, /DFK define the field for searching key

      A ref erence format in hosts.conf is : "IP or MAc Address" = "hostname" , the follow for more detail :
      00-0C-29-4E-EF-53 = Student-01     # (Assign "Student-01" as hostname if its MAC address is 000C294EEF53 )
      192-168-1-12 = Student-02  # (Assign "Student-02" as hostname for IP address is client. Replace dot '.' symbol with dash '-')
      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.

    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

  6. How to configure WORKGROUP name via DRBL-Winroll ?
  7. 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: NM:> workgroup will be "GROUP-020"
      ip: NM: => workgroup will be "GROUP-018-001"
    4. By DNS Suffix : $DNS_SUFFIX
    5. 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

  8. How to use auto-setup Network Configuration via DRBL-Winroll ?
  9. 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.conf" CONFIG_NETWORK_MODE = xxxx
    The parameter guide is as follow :
    CONFIG_NETWORK_MODE = dhcp     (use DHCP method)
    CONFIG_NETWORK_MODE = /RDF:C:\cygwin\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. Advanced mode : By config file
    3. Make sure CONFIG_NETWORK_MODE = /RDF:C:\cygwin\drbl_winroll-config\client-mac-network.conf in winroll.conf,
      then edit c:\cygwin\drbl_winroll-config\client-mac-network.conf

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

      _DEFAULT_NETWORK	=  # assign network and netmask
      _DEFAULT_GATEWAY	=		# assign default gateway
      _DEFAULT_DNS		=	# DNS, it could be empty, one or many values (use "comma"(,) as separated ) 
      _DEFAULT_WINS		=	# WINS, it could be empty, one or many values (use "comma"(,) as separated ) 
      _DEFAULT_DNS_SUFFIX	= # DNS_SUFFIX, it could be empty,
      subnet {
      	THIS_GATEWAY	= # use as default gateway for this network
      	THIS_DNS	=	# use 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 {
      	THIS_GATEWAY		=
      	THIS_DNS			=
      	#THIS _WINS
      	#  This subnet would inherit "_DEFAULT_WINS" and 
      	# "_DEFAULT_DNS_SUFFIX" value form global settings 
      [IP Address]
      00-00-00-00-00-01 =
      00-00-00-00-00-02 =  # it would use settings of subnet
      00-00-00-00-00-03 =  #  it would use settings of subnet
      00-00-00-00-00-04 = dhcp  # uses dhcp
      00-00-00-00-00-05 = none  # skip this NIC
    4. There two samples for network cofiguration in c:\cygwin\drbl_winroll-doc\sample\

  10. How to setup auto-add to AD domain function ?
    1. Follow the installation step and input necessary information (AD domain name, valid user account and password)
    2. After mass deployment, clients would show the message of domain modification and reboot by themself. As the right image show :

    Explanation :

    • What to setup : After it added the audo-add to AD function, system would add a batch file "add2ad.bat" in 'c:\cygwin\drbl_winroll-config\'. The contents as the follow:
      netdom join %computername% /domain:[DOMAIN] /userd:[USER] /passwordd:[PASSWORD] /reboot:8
    • How to work :Client will execute the batch file untill system is ready (it means to already done for hostname fix, network environment...). If it succeeds, system would delete the batch file automatically for security issue (due to user account and password) and create a new file "c:\cygwin\drbl_winroll-config\add2ad.md5". It records a value that the md5sum result for this machine's phyical address of NIC

    Note :

    • System use netdom.exe command to do the auto-add to AD function. So, please make sure netdom.exe is ready in it. (Suggest to test if netdom.exe command works under command mode)
    • Windows XP : please refer here
      Windows Vista : please refer here
      Windows 7/Server 2008 : please refer here
    • For do the mass deployment, please DO NOTadd to AD domain before you image it as a template. It also avoid to reboot it into Windows system after DRBL-winroll installation (Because that will lead to client add to AD domain too)
    • Need to renew SID ? Clients don't need to renew SID if it use Windows 2003 (or later) as AD server. It can work fine that clients have different hostname but the same SID in domain. Of course, DRBL-winroll can do it after clients renew SID if necessary

  11. How to setup system monitor service for Windows clients ?
  12. DRBL-winroll integrate Munin Win32 project as system monitor/ tool. Munin is a networked resource monitoring tool with server-client architecture. The explanations of insatllation and configuration would be presented in two parts : client site and server site.
    • Client site
      1. During installing, it would query if to install system monitor service. Please type "y" then press [Enter] (default by 'No'). The "Munin Node for DRBL-winroll" installer will popup and start to install daemon, show as follow:

        Munin Node for DRBL-winroll Installer
      2. Follow the steps to complete installation

    • Server site
      1. For example : use Ubuntu Lucid, suggest to pre-install apache2 to easy view the reports of clients system via web, then install munin package, as the follow
      2. sudo apt-get install apache2 munin munin-node
      3. Download DRBL-winroll Server-site package server-site-*.tgz then unpack it.Excute gen_munin_clients_conf.sh to collect clients' informaction as configuration file. As the follow :
      4. $ tar xzf server-site-v167.tgz ; cd server-site ; sudo ./gen_munin_clients_conf.sh
      5. Script would get ip/hostname of clients for report via user assignment, then output to a configuration for Munin, named: "munin-winroll-clients.conf" . It would help user to configure and restart crontab in server for supported Linux distribution. As the follow:
        Get ip list from DRBL server [Y/n]y
        Domain name [domain.localdomain]
        Set domain name as : domain.localdomain ...
        Get clients hostname via Munin service ? Default from local /etc/hosts [N/y]
        Still to keep the record if get hostname fail (to use ip as hostname) [N/y]
        get hostname of '' :PC101
        get hostname of '' :PC102
        get hostname of '' :PC103
        Total 3 record(s) done in 'munin-winroll-clients.conf'
        Please copy the file into correct folder for Munin (ex: /etc/munin/munin-conf.d) then restart munin daemon (ex: $ sudo -u munin munin-cron)
      6. If need, please copy the configuration file into correct directory for Munin server (ex: /etc/munin/munin-conf.d in Ubuntu Lucid ) then restart munin-cron to create necessary data for report. As the follow:
        $ sudo cp munin-winroll-clients.conf /etc/munin/munin-conf.d ; sudo -u munin munin-cron

    • Where to view report
    • It would be easy to view the report by web page via http://localhost/munin on monitor server. By default, Munin report web only be accessible from localhost. Please refer Munin document for details about remote access and security issue.

    Note :

    • Acknowledge :Thansk to Munin Nodes win32 project. DRBL-winroll do repackage the installer via NSIS. Users can refer the NSIS configuration in ~/drbl-winroll/tool/munin-node-winroll.nsi if needs

  13. How to renew MS Windows SID ?
    1. Please choose (and pre-download) your renew sid tool that support to run as command mode, ex:NewSID v4.10; Answer 'y' to setup "SID-check" service, give the full path of tool (an executable file) and the appropriate parameters for it(ex: use '/a /n' for newsid.exe). As the follow :

    2. Setup 'SID-check' service
    3. Service would record NIC mac address of Windows machine, it would give a new SID if service discover a new one mac address.
    4. For security reason , SID should be given randomly, And service would encode the mac address what it discover via md5sum
    5. DRBL-Winroll would startup first time after installation finished if you did setup 'SID-check' service. Please wait until system reboot by itself.

    6. Firt time to start SID-check service after installation and wait until system reboot by itself
      Note: Some news about "NewSid Retired ?" [1] [2]

  14. How to make Windows clients to accept the commands form DRBL server automatically ?
  15. 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:

    4. It would create "id_rsa" and "id_rsa.pub" in /root/.ssh, ex:
    5. $ ls /root/.ssh
      id_dsa id_dsa.pub

    6. "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 :
      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]

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

    8. 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:
    9. $ ssh administrator@[win-client-ip] ipconfig

    10. After all, you can send a command to clients from DRBL server via "/opt/drbl/sbin/dcs" command.

    Note :

    • Except Windows NT and Windows XP, DRBL-winroll would create a new account "cyg_server" as ssh daemon runner. So, please DO NOT change its password or disable it. That would lead to ssd daemon be out of service.
    • For security issue, its password be created by random with 8 strings and be stored in "C:\cygwin\drbl_winroll-config\SSHD_SERVER_PW.txt" file。

  16. Language Support
    • DRBL-winroll suppports the follow languages, and thanks the people's effort in language transaltion and testbed report !!
      • Traditional Chinese
      • English
      • French : Joël Gondouin (joel_at_gondouin_net)
      • Dutch : Dave Haakenhout (Almere, Netherlands)
      • Swedish : Yngve Spång (Systemkonsult AB)
      • Spanish : Artz Neo (artzneo_at_linuxmail_org)
    • Help us to translate !![How to]

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