WW0653: Using Automated Setup: Setup /H

Last reviewed: May 1, 1997
Article ID: Q92448
3.10 3.11 WINDOWS kbfile kbdisplay kbappnote

The information in this article applies to:

  • Microsoft Windows operating system versions 3.1, 3.11

Microsoft has an Application Note titled "Using Automated Setup: Setup /h" (WW0653) that describes the Windows 3.1 Automated Setup option, SETUP /H (also called Batch Mode Setup). You can use Automated Setup to set up either a shared or nonshared copy of Windows, and you can use it whether you are setting up Windows from a network drive or from the Windows Setup disks.

You can obtain this Application Note from the following sources:

  • Microsoft's World Wide Web Site on the Internet
  • The Internet (Microsoft anonymous ftp server)
  • Microsoft Download Service (MSDL)
  • Microsoft Product Support Services

For complete information, see the "To Obtain This Application Note" section at the end of this article.

THE TEXT OF WW0653

  Microsoft(R) Product Support Services Application Note (Text File)
                WW0653: USING AUTOMATED SETUP: SETUP /H
                                                  Revision Date: 10/92
                                                      No Disk Included

The following information applies to Microsoft Windows(TM) version 3.1.

 --------------------------------------------------------------------
| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY    |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an            |
| Application Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY      |
| KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO    |
| THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A     |
| PARTICULAR PURPOSE. The user assumes the entire risk as to the     |
| accuracy and the use of this Application Note. This Application    |
| Note may be copied and distributed subject to the following        |
| conditions: 1) All text must be copied without modification and    |
| all pages must be included; 2) If software is included, all files  |
| on the disk(s) must be copied without modification [the MS-DOS(R)  |
| utility DISKCOPY is appropriate for this purpose]; 3) All          |
| components of this Application Note must be distributed together;  |
| and 4) This Application Note may not be distributed for profit.    |
|                                                                    |
| Copyright 1992 Microsoft Corporation. All Rights Reserved.         |
| Microsoft and MS-DOS are registered trademarks and Windows         |
| is a trademark of Microsoft Corporation.                           |
| HP and LaserJet are registered trademarks of Hewlett-Packard       |
| Company.                                                           |
 --------------------------------------------------------------------

                    USING AUTOMATED SETUP: SETUP /H
                    ===============================

The Microsoft Windows operating system version 3.1 Automated Setup option (also called Batch Mode Setup) uses information that you define in a system settings file to install Windows quickly and easily, with little or no user interaction. Automated Setup is useful if you have to set up many workstations or if you want users to be able to set up Windows on their own workstations without having to make any system configuration choices, such as hardware components and printers, or choices about which optional Windows components to install.

You can use Automated Setup to set up either a shared or nonshared copy of Windows, and you can use it whether you are setting up Windows from a network drive or from the Windows Setup disks.

  NOTE: Before you run the Setup program, turn off any network
  messaging services or terminate-and-stay-resident programs (TSRs)
  that allow the network or another user to send a message to your
  screen. These pop-up programs can cause Windows Setup to fail if a
  message is received while Windows is being installed.

TO USE THE AUTOMATED SETUP OPTION:

  1. Create a system settings file for each workstation configuration.

    For details, see the following section, "Creating the System Settings File."

  2. Place the system settings file(s) in a directory where users have rights to open and read files. You can also copy the settings file to a user's local drive or to a bootable floppy disk.

  3. If you are setting up Windows from a network, connect to the network drive and change to the directory where the Windows Setup files are located. If you are setting up Windows from the Windows Setup disks, change to the floppy disk drive. You can also set up Windows from the user's workstation.

  4. If you want to run a shared copy of Windows from the network, type

         setup /h:[<path>]<filename> /n
    

    where <filename> is the name of the system settings file that contains details about the system configuration. Include a path if the system settings file is not in the directory where you are setting up Windows.

    For example, connect to the network drive and directory where the Windows Setup files are located. Create a system settings file named SETUPVGA.SHH in the same directory as the Setup program. At the command prompt, type "setup /h:setupvga.shh /n" (without the quotation marks) and press ENTER.

    If you want to run a nonshared copy of Windows from a local drive or a network drive, type:

         setup /h:[<path>]<filename>
    

    For example, create a system settings file named SETUPVGA.SHH in the same directory as the Setup program. At the command prompt type "setup /h:setupvga.shh" (without the quotation marks) and press ENTER.

CREATING THE SYSTEM SETTINGS FILE

Windows comes with a system settings template file called SETUP.SHH, which you can copy or modify to create a custom system settings file. The SETUP.SHH file is located on Microsoft Windows 3.1 Disk 1 and is copied to the shared Windows directory when you use SETUP /A. You can modify this file with any text editor (such as Notepad) that can save unformatted text (ASCII) files.

  NOTE: When you create the .SHH file, use only ANSI characters;
  characters that may be included in any other code page character set
  currently installed on your system are not supported.

The sections in the system settings file are summarized in the following table. Valid entries for each section are described after this table.

  Section         Purpose
  ------------------------------------------------------------------

  [sysinfo]       Species whether the System Information screen is
                  displayed during Setup

  [configuration] Specifies the various devices on the user's system

  [windir]        Specifies where to put Windows files

  [userinfo]      Specifies the user and company name

  [dontinstall]   Specifies components that should not be installed

  [options]       Specifies various Setup options such as viewing
                  README files, setting up existing applications, and
                  starting the Windows tutorial

  [printers]      Specifies printers to set up

  [endinstall]    Specifies whether Setup modifies the CONFIG.SYS and
                  AUTOEXEC.BAT files and whether the system is
                  rebooted after Windows is installed

Many of the entries require values from the Windows SETUP.INF, CONTROL.INF, and WIN.INI files. When you use SETUP /A to place Windows files on a network server, the SETUP.INF, CONTROL.INF, and WIN.INI files are copied to the shared Windows directory. The master WIN.INI and SYSTEM.INI files are called WIN.SRC and SYSTEM.SRC in this directory. You can also find SETUP.INF on Microsoft Windows 3.1 Disk 1. You can print or view all of these text files with any text editor.

[sysinfo]

The System Information screen gives users the option of confirming or changing system configuration settings before continuing with Setup. Specify showsysinfo=yes to display the screen, or showsysinfo=no if you don't want to display the screen. (The default is no.)

[configuration]

If an entry for a device is not included in this section, Windows will use the detected or default device. The following table describes valid device settings. Each of these settings requires information from the SETUP.INF file.

  Use            To
  -----------------------------------------------------------------

  machine=       Specify the type of machine by using a profile
                 string from the [machine] section of SETUP.INF.
                 Example: machine=ibm_compatible.

  display=       Specify the type of display by using a profile
                 string from the [display] section of SETUP.INF.
                 Example: display=vga.

  mouse=         Specify the type of pointing device by using a
                 profile string from the [pointing.device] section
                 of SETUP.INF. Example: mouse=ps2mouse.

  network=       Specify the type of network and the version number.
                 Use a profile string from the [network] section of
                 SETUP.INF to specify the network . Example:
                 network=lanman.

                 If there is a [<network_version>] section in
                 SETUP.INF--for example, [lanman.versions]--use a
                 number from that section to specify the version for
                 your network. Separate the version number from the
                 network type with a slash (/). Example:
                 network=lanman/01020000 sets up Microsoft LAN
                 Manager version 2.0 Enhanced.

                 If you do not specify a version number and your
                 network software is loaded when you run Setup,
                 Windows sets up the version that it detects.

  keyboard=      Specify the type of keyboard by using a profile
                 string from the [keyboard.types] section of
                 SETUP.INF. Example: keyboard=t4s0enha.

  language=      Specify the language by using a profile string from
                 the [language] section of SETUP.INF. Example:
                 language=enu.

  kblayout=      Specify the keyboard layout by using a profile
                 string from the [keyboard.tables] section of
                 SETUP.INF. Example: kblayout=nodll.

If you are updating Windows, Setup ignores some of these entries and uses the devices that are already installed. If you want to override an installed device, precede the machine=, display=, mouse=, and network= values with an exclamation point (!)--for example, display=!vga. Any keyboard=, language=, or kblayout= values specified will automatically override and update the currently installed device.

[windir]

This section specifies where to place the user's Windows files. If Windows is already installed in the directory specified here, Setup updates the Windows files. For example, if you want to install Windows in the WINDOWS directory on drive C, specify "c:\windows" (without the quotation marks) in this section. This setting overrides the value of defdir= in the [data] section of SETUP.INF. If you do not specify a directory here, or if the directory you specify is not valid, a dialog box appears during Setup asking for the directory where you want to set up Windows.

[userinfo]

This section specifies the user and company name. The first line specifies the user name. This line is required unless you are setting up a shared copy of Windows by using SETUP /N (see "Note," below). The second line specifies the company name and is optional. Each name can be up to 30 characters long and must be enclosed in double quotation marks (" ") if it includes blank spaces. For example:

   "Susan Smith"
   "My Company"

If you do not specify a user name, a dialog box appears during Setup to ask for the name.

  NOTE: If you use SETUP /N to set up a shared copy of Windows, the
  [userinfo] section is ignored because the information was supplied
  when you used SETUP /A to copy Windows files to the server.

[dontinstall]

This section specifies optional Windows components that you do not want Windows to set up. If this section is not present or is empty, all optional components are set up. You can choose not to install the components listed in the following table:

  Specify        If you do not want Windows to install
  --------------------------------------------------------

  readmes        Readme files.

  accessories    Accessories (however, WRITE.EXE is always
                 installed).

  games          Games.

  screensavers   Screen savers.

  bitmaps        Background wallpapers.

[options]

This section specifies whether a user can set up applications during Setup and whether to start the Windows Tutorial at the end of Setup. If you don't want any of these options, omit this section. Valid entries for this section are shown in the following table:

  Specify        To
  ------------------------------------------------------------------

  setupapps      Set up applications interactively during Setup. The
                 Add/Remove File dialog box appears during Setup so
                 the user can choose which applications to install.

  autosetupapps  Automatically set up all applications found on the
                 user's hard disk.

  tutorial       Start the Windows Tutorial at the end of Setup.

You should not specify both setupapps and autosetupapps, but if you do, Windows sets up all applications it finds on the hard disk.

[printers]

This section specifies which printers to install during Setup. To install a printer, specify a printer name and a port. Use one of the descriptive strings found in the [io.device] section of the CONTROL.INF file to specify the printer name. The printer name must be enclosed in double quotation marks (" ") if it contains blank spaces. Use one of the values found in the [ports] section of the WIN.INI file to specify the port. The printer name and the port must be separated by a comma. For example, to specify the HP(R) LaserJet(R) III printer connected to port LPT1, include this entry:

   "HP LaserJet III",LPT1:

If you don't want to install any printers during Setup, omit this section.

[endinstall]

This section specifies what should happen after Windows is successfully installed. You can specify whether Setup should modify the CONFIG.SYS and AUTOEXEC.BAT files, and then whether to exit to MS- DOS, restart Windows, or restart the system.

  Specify             If you want Setup to
  -----------------------------------------------------------------------

  configfiles=modify  Make all changes to CONFIG.SYS and AUTOEXEC.BAT.
                      When Setup changes these files, the previous
                      CONFIG.SYS and AUTOEXEC.BAT files are saved as
                      CONFIG.OLD and AUTOEXEC.OLD in the root directory.
                      (If CONFIG.OLD or AUTOEXEC.OLD are already present,
                      the previous file will be renamed CONFIG.000 or
                      AUTOEXEC.000, or the next number that does not
                      conflict with an existing file.) If you are setting
                      up Windows on a diskless workstation, Setup
                      disregards this entry.

  configfiles=save    Save proposed changes to CONFIG.SYS and
                      AUTOEXEC.BAT in alternate files (CONFIG.WIN and
                      AUTOEXEC.WIN) stored in the Windows directory. The
                      CONFIG.SYS and AUTOEXEC.BAT files are not changed;
                      you must make these changes later. (If CONFIG.WIN
                      or AUTOEXEC.WIN are already present, the previous
                      file will be renamed CONFIG.000 or AUTOEXEC.000, or
                      the next number that does not conflict with an
                      existing file.)

  endopt=exit         Return to MS-DOS on completion of Setup.

  endopt=restart      Restart Windows on completion of Setup.

  endopt=reboot       Restart the user's system on completion of Setup.
                      If this setting is specified and the user uses
                      SETUP /N to install Windows, Setup will return to
                      MS-DOS without rebooting after completing the
                      installation.

SAMPLE SYSTEM SETTINGS FILE

The following system settings file installs Windows on a PC-compatible computer with these characteristics:

    - The system includes a VGA display, a Microsoft Mouse, LAN
      Manager 2.0 Enhanced local area network software, and a 101-key
      U.S. keyboard.

    - The System Information screen is displayed for confirmation, and
      Windows files are placed in the C:\WINDOWS directory.

    - The games are not installed.

    - An HP LaserJet III printer is installed on LPT1.

    - The CONFIG.SYS and AUTOEXEC.BAT files are modified by Setup.

    - After Setup is complete, Windows is restarted.

   [sysinfo]
   showsysinfo=yes

   [configuration]
   machine=ibm_compatible
   display=vga
   mouse=ps2mouse
   network=lanman/01020000
   keyboard=t4s0enha
   language=enu
   kblayout=nodll

   [windir]
   c:\windows

   [userinfo]
   "user's name"
   "company name"

   [dontinstall]
   games

   [options]

   [printers]
   "HP LaserJet III",LPT1:

   [endinstall]
   configfiles=modify
   endopt=restart

TO OBTAIN THIS APPLICATION NOTE

You can find WW0653.EXE (size: 21096 bytes) 
                       , a self-extracting file, on the following
services:
  • Microsoft's World Wide Web Site on the Internet

          On the www.microsoft.com home page, click the Support icon.
          Click Knowledge Base, and select the product.
    
          Enter kbfile WW0653.EXE (size: 21096 bytes) 
                                 , and click GO!
          Open the article, and click the button to download the file.
    
    
  • Internet (anonymous FTP)

          ftp ftp.microsoft.com
          Change to the Softlib/Mslfiles folder.
          Get WW0653.EXE (size: 21096 bytes) 
    
  • Microsoft Download Service (MSDL)

          Dial (425) 936-6735 to connect to MSDL
          Download WW0653.EXE (size: 21096 bytes) 
    

For additional information about downloading, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q119591
   TITLE     : How to Obtain Microsoft Support Files from Online
               Services

  • If you are unable to access the source(s) listed above, you can have this Application Note mailed or faxed to you by calling Microsoft Product Support Services Monday through Friday, 6:00 A.M. to 6:00 P.M. Pacific time at (425) 637-7098. If you are outside the United States, contact the Microsoft subsidiary for your area.


  • KBCategory: kbfile kbdisplay kbappnote
    KBSubcategory:
    Additional reference words: appnote win31 3.10
    Keywords : kbappnote kbdisplay kbfile
    Version : 3.10 3.11
    Platform : WINDOWS


    THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

    Last reviewed: May 1, 1997
    © 1998 Microsoft Corporation. All rights reserved. Terms of Use.