Microsoft KB Archive/92448
WW0653: Using Automated Setup: Setup /H
Last reviewed: May 1, 1997
3.10 3.11 WINDOWS kbfile kbdisplay kbappnote The information in this article applies to:
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:
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:
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.
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.)
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.
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.
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.
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.
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.
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.
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
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
Last reviewed: May 1, 1997