Export (0) Print
Expand All

Installing and Using Utilities and SDK for Subsystem for UNIX-based Applications

Updated: August 22, 2005

Applies To: Windows Server 2003 R2

The download package available from the Microsoft Web site, Utilities and Software Development Kit (SDK) for UNIX-based Applications, is designed to work with the Subsystem for UNIX-Based Applications (SUA) component that ships with Microsoft Windows Server 2003 Release 2 (R2).

Components Included with Download Package

The download package contains the following components:

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

See the Help and release notes provided with the installation package for a complete listing of base utilities.

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.

See the Help and release notes provided with the installation package for a complete listing of SVR-5 utilities.

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 C++ library and the math library are functional equivalents of those supplied by Microsoft as part of their Visual Studio environment. Standard C Library and Math Library are available for both 32-bit and 64-bit platforms. 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 compiler) and g++ (GNU C++ compiler) compilers, or the Visual Studio 2005 compiler. Linking to shared objects is not supported with the Visual Studio 2005 compiler. The 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 2003 R2.

The minimum system requirements for installing Utilities and SDK for Subsystem for UNIX-based Applications depends 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 Subsystem for UNIX-based Applications 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 Subsystem for UNIX-based Applications, and then continue to install additional Windows service packs as they become available.

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

  • It is recommended 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:

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 2003 R2.

 

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

noteNote
If you are upgrading from Windows Services for UNIX 3.5, existing settings are saved during R2 installation, and are restored during the setup process for Utilities and SDK for Subsystem for UNIX-based Applications.

Installing Utilities and SDK for Subsystem for UNIX-based Applications by Using the Windows Interface

The following installation options are available:

Standard Installation

To perform a standard installation
  1. Download the Utilities and SDK for Subsystem for UNIX-based Applications from the Microsoft Web site

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

  3. In the User name text 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 End User License Agreement (EULA) 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 .

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

  3. In the User name text 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 End User License Agreement (EULA) 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. Click to fill 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 are finished 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 you have selected click Back.

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

Once Utilities and SDK for Subsystem for UNIX-based Application 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 Subsystem for UNIX-based Applications setup.msi file. If you omit the path, the setup.msi file must be in the current directory.

/qb

Installs Utilities and SDK for Subsystem for UNIX-based Applications 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 Subsystem for UNIX-based Applications 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.

noteNote
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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft