Installing Utilities and SDK for Subsystem for UNIX-based Applications

Applies To: Windows 7, Windows Server 2008 R2, Windows Server 2012

The download package Utilities and Software Development Kit (SDK) for Subsystem for UNIX-based Applications, available from the Microsoft Web site (https://go.microsoft.com/fwlink/?LinkId=139521), is designed to work with the Subsystem for UNIX-based Applications (SUA) component that ships with Microsoft® Windows Server® 2008 R2.

Components included with download package

The download package contains the following components:

  • Base utilities, GNU utilities, SDK, and UNIX Perl

  • SVR-5 utilities

  • Base SDK

  • Base utilities, GNU utilities, SDK, and UNIX Perl

  • Base utilities, GNU utilities, SDK, and UNIX Perl

  • Base utilities, GNU utilities, SDK, and UNIX Perl

  • Compiler compatibility

In addition to the features provided in Windows® Services for UNIX 3.5, the download package supports 64-bit application development with SUA. The download also enables development and porting of custom UNIX applications by using the Windows Oracle Call Interface (OCI) and Windows ODBC libraries (collectively referred to as "mixed mode" throughout this document).

Base utilities, GNU utilities, SDK, and UNIX Perl

These components include all utilities that formerly installed with Windows Services for UNIX 3.5. This consists of the nearly 300 BSD-based and optional SUA GNU utilities. Many of these utilities (approximately 80) are also available in 64-bit versions.

GNU components include utilities and SDK tools distributed under the terms of the GNU General Public License (GPL).

For a complete listing of base utilities, see the Help and release notes provided with the installation package.

SVR-5 utilities

This set consists of a Korn shell and approximately 150 utilities, most of which support SVR-5. These utilities currently are available in 32-bit versions, and may fail in specific 64-bit scenarios; however, the utilities run on WOW 64-bit platforms.

For a complete listing of SVR-5 utilities, see the Help and release notes provided with the installation package.

Base SDK

The current release supports most of the libraries and headers installed with Windows Services for UNIX 3.5. These support both 32-bit and 64-bit SUA-related software migration and development.

This SDK consists of the following libraries and corresponding header files: Standard C Library, Standard C++ Library, and Math Library. The Standard C++ Library and the Math Library are functional equivalents of those supplied by Microsoft as part of their Microsoft Visual Studio® development system environment. The Standard C Library and the Math Library are available for both 32-bit and 64-bit platforms. The Standard C++ Library is available for both 32-bit and 64-bit binaries, and supports multithreaded applications.

Compiler compatibility

The Base SDK package can be used with either the gcc (GNU C) and g++ (GNU C++) compilers or the Visual Studio 2005 compiler. Linking to shared objects is not supported with the Visual Studio 2005 compiler. The Standard C++ Library supplied with this package is compatible with the Visual Studio 2005 compiler and can be used with c89.

The g++ compiler uses its own library for C++ compilation.

System requirements

The Utilities and SDK for Subsystem for UNIX-based Applications package installs only on Windows server-class operating systems.

The minimum system requirements for installing Utilities and SDK for SUA depend on which components you are installing and the file system of the disk where the components will be installed.

The maximum disk space required to install all Utilities and SDK for SUA components is approximately 350 MB.

Additional requirements

  • To receive product support, you must install the latest Windows service pack before installing Utilities and SDK for SUA, and then continue to install additional Windows service packs as they become available.

  • You must install Utilities and SDK for SUA on a partition that is formatted with the NTFS file system. File system operations on FAT partitions are not supported.

  • We recommend that the computer have at least 16 MB of RAM in addition to the recommended minimum configuration for the operating system.

Installation options

You can choose one of the following installation options when installing Utilities and SDK for Subsystem for UNIX-based Applications:

  • Standard installation

  • Custom installation

The following table shows which components are installed on a computer as part of the standard installation (Standard) and which additional components are available as part of a customized installation (Custom). If you select the customized installation, you can choose not to install components that are automatically installed as part of the standard installation. These components can only be installed on Windows server-class operating systems.

Component Type of Installation

Base utilities

Standard

Base SDK

Standard

SVR-5 utilities

Custom

GNU utilities

Custom

GNU SDK

Custom

UNIX Perl

Custom

Visual Studio Debugger Extension

Custom

Note

If you are upgrading from Windows Services for UNIX 3.5, existing settings are saved during installation on computers running Windows Server 2008 R2 or Windows Server 2008, and are restored during the setup process for Utilities and SDK for SUA.

Installing Utilities and SDK for Subsystem for UNIX-based Applications by using the Windows interface

The following installation options are available:

  • Standard installation

  • Custom installation

Standard installation

To perform a standard installation

  1. Download the Utilities and SDK for Subsystem for UNIX-based Applications from the Microsoft Web site (https://go.microsoft.com/fwlink/?LinkId=139521).

  2. In the Utilities and SDK for Subsystem for UNIX-based Applications Wizard, click Next .

  3. In the User name box, type your name. If the name of your organization does not show in the Organization field, enter the name of your organization.

  4. Read the Microsoft Software License Terms carefully. If you accept the terms of the agreement, click I accept the terms in the License Agreement , and then click Next to continue installation. If you click I do not accept the License Agreement (Exit Setup) , the installation procedure terminates.

  5. To install default Utilities and SDK for Subsystem for UNIX-based Applications components in the default directory, click Standard Installation , and then click Next . To customize your installation, see Custom installation.

Custom installation

To perform a custom installation

  1. Download the Utilities and SDK for Subsystem for UNIX-based Applications from the Microsoft Web site (https://go.microsoft.com/fwlink/?LinkId=139521).

  2. In the Utilities and SDK for Subsystem for UNIX-based Applications Wizard, click Next .

  3. In the User name box, type your name. If the name of your organization does not show in the Organization field, enter the name of your organization.

  4. Read the Microsoft Software License Terms carefully. If you accept the terms of the agreement, click I accept the terms in the License Agreement , and then click Next to continue installation. If you click I do not accept the License Agreement (Exit Setup) , the installation procedure terminates.

  5. To install default Utilities and SDK for Subsystem for UNIX-based Applications components in the default directory, click Standard Installation , and then click Next (see Standard Installation in the preceding section). If you want to specify a different set of components or a different installation location, click Custom Installation , and then click Next .

  6. Select the check boxes for each component that you want to install, and then click the appropriate option. If you do not want to install a component, click the icon next to the component, and then click Entire feature will not be available . When you finish specifying the components to install, click Next .

  7. If you are installing the GNU Software Development Kit (SDK), read the information about the GNU Library General Public License carefully. If you want to install the GNU SDK, click Next to continue installation. To make changes to the components that you have selected, click Back .

Note

After you have installed Utilities and SDK for Subsystem for UNIX-based Applications, you can install additional components or remove installed components.
Utilities and SDK for Subsystem for UNIX-based Applications components cannot be run from a network server. All files must be installed on the local computer.
Standard installation does not provide a complete UNIX development environment. To obtain all of the GNU compilers, build tools, and other SDK components, you must select Custom Installation and then select GNU SDK .
After Utilities and SDK for Subsystem for UNIX-based Applications is installed, setuid behavior is disabled by default. This affects the behavior of certain SUA programs.
In this installation, case sensitivity will not be enabled for object names (such as file names) in non-Win32 subsystems.

Installing Utilities and SDK for Subsystem for UNIX-based Applications by using the command line

Perform the following step to start a command-line installation of the Utilities and SDK for Subsystem for UNIX-based Applications.

To perform a command-line installation

  • At a command prompt, enter the following:

    msiexec /i [path\] setup.msi [ ADDLOCAL=" component[,component...] " ] {/ qb |/ q }

The following table describes the arguments and options for this command.

Argument/Option

Description

path

The fully qualified path of the Utilities and SDK for SUA setup.msi file. If you omit the path, the setup.msi file must be in the current directory.

/qb

Installs Utilities and SDK for SUA with a basic user interface. You must specify either the /q or /qb option; otherwise, the results will be unpredictable.

/q

Installs Utilities and SDK for SUA with no user interface or display. This option allows you to perform an unattended installation. You must specify either the /q or /qb option; otherwise, the results will be unpredictable.

Note

This command completes only a standard installation.
For security purposes, all SUA services (also called daemons) are disabled by default. To manage SUA services, edit the /etc/inetd.conf file.

See Also

Other Resources

Utilities and SDK for Subsystem for UNIX-based Applications in Microsoft Windows Vista RTM, Windows Vista SP1, and Windows Server 2008 RTM