ST-Developer Windows Installation

Platform Requirements

ST-Developer supports Windows 7, Vista and XP and is available in 32bit and 64bit versions. It supports C++ development with Visual Studio 2010 (VC10), Visual Studio 2008 (VC9), Visual Studio 2005 (VC8), as well as the Microsoft Visual C++ v6.0 compiler.

You must install ST-Developer using an account with administrator privileges. After the installation is complete, you can run the tools under any user account. Under Windows 2000, you must have "Power User" privileges.

The ST-Developer distribution is split into two MSI installers. The first contains the base system and commonly-used AP libraries, while the second contains less frequently used AP libraries. A complete base installation requires 2.7 gigabytes (Windows 32bit) or 2.8 gigabytes (Windows 64bit) of disk space. Installing the less-frequently used AP libraries adds another 2 gigabytes. You can reduce disk usage by selecting "Custom" install and omitting components for application protocols that you do not intend to use.

Remove Earlier Versions

1. If you are upgrading from ST-Developer v10 or earlier with Visual Studio plug-ins, use the Start | Programs | ST-Developer | Visual C++ Integration tool to "unintegrate" the Visual Studio plug-ins. Do this for each ST-Developer user.

2. On Vista and Windows 7, go to the Start | Control Panel | Programs and Features item. On Windows XP, go to the Start | Settings | Control Panel menu item, then select Add/Remove Programs. To uninstall, choose ST-Developer entry from the list of packages.

Installation Procedure

1. If you have been given a URL for the ST-Developer installer, download the ST-Developer MSI to your local disk. If you have received a CD-ROM or DVD-ROM, insert the disk into your drive. Double click on stdev.msi. file to begin the installation.
2. The installer will guide you through the installation process. If you wish to omit parts of ST-Developer, or specify where it is installed, select a custom installation when prompted, otherwise select typical installation.
3. Request a license key when prompted. Click Register and follow the instructions in the web form. If you wish to request a key later, select STEP Tools | Request License Key on the Start menu. We will send the key by e-mail and you can install it as described in Software License Keys.
4. The base installer contains libraries for AP203 (first and second editions) AP209, AP214, AP215, AP216, AP218, AP224, AP232, AP238, CIS, and IFC2x3. To install other AP libraries, double click on stdev_aplibs.msi and follow the instructions.

ST-Developer is now installed. You can verify the environment settings on your machine and test the ST-Developer tools as described in the following sections.

Visual Studio and Environment Settings

The ST-Developer installer sets several environment variables used by the Visual Studio project files and makefiles for the sample programs to find programming libraries, header files, and tools.

To check these, start a command prompt and type set, or bring up the Environment tab of the System control panel. Verify that each has an accurate value:

%ROSE%

ST-Developer installation directory, also set under Software\STEP Tools, Inc.\ST-Developer in the registry.

%ROSE_BIN%

Directory containing ST-Developer executables. Usually %ROSE%\bin. This is added to your %PATH% variable.

%ROSE_INCLUDE%

Directory containing the ST-Developer C++ header files. Usually %ROSE%\include. Used by project files.

%ROSE_LIB%

Directory containing the ST-Developer C++ libraries. Usually a subdirectory under %ROSE%\lib. Used by project files.

%ROSE_CONFIG%

Location of the makefile configuration file. This is a file in the %ROSE%\config directory that defines settings for the demo makefiles.

ST-Developer includes libraries built for newer and older versions of Visual C++ as well as multi-thread, static (/MT flag) and multi-thread, dynamic (/MD flag) link conventions. By default, the ROSE_LIB variable points to the libraries for Visual Studio 2005 with the /MD flag. To use a different version, change ROSE_LIB as below:

    ST-Developer for 32bit Windows:
    <stdev-install-dir>\lib\i86_win32_vc10_md    Visual Studio 2010 with /MD
    <stdev-install-dir>\lib\i86_win32_vc10_mt    Visual Studio 2010 with /MT

    <stdev-install-dir>\lib\i86_win32_vc9_md     Visual Studio 2008 with /MD
    <stdev-install-dir>\lib\i86_win32_vc9_mt     Visual Studio 2008 with /MT

    <stdev-install-dir>\lib\i86_win32_vc8_md     Visual Studio 2005 with /MD
    <stdev-install-dir>\lib\i86_win32_vc8_mt     Visual Studio 2005 with /MT

    <stdev-install-dir>\lib\i86_win32_vc6_md     Visual C++ 6 with /MD
    <stdev-install-dir>\lib\i86_win32_vc6_mt     Visual C++ 6 with /MT
     
     
    ST-Developer for 64bit Windows:
    <stdev-install-dir>\lib\x64_win64_vc10_md    Visual Studio 2010 with /MD
    <stdev-install-dir>\lib\x64_win64_vc10_mt    Visual Studio 2010 with /MT

    <stdev-install-dir>\lib\x64_win64_vc9_md     Visual Studio 2008 with /MD
    <stdev-install-dir>\lib\x64_win64_vc9_mt     Visual Studio 2008 with /MT

    <stdev-install-dir>\lib\x64_win64_vc8_md     Visual Studio 2005 with /MD
    <stdev-install-dir>\lib\x64_win64_vc8_mt     Visual Studio 2005 with /MT

You can also specify one of these explicitly as a /LIBPATH in your project settings if you need alternate versions.

If you write code that executes in multiple threads, be aware that the ST-Developer libraries are not reentrant. You must ensure that only one thread calls an ST-Developer library function at any point in time.

Verify the Installation

You can test the various components of ST-Developer using the following steps:

1. Select STEP Tools | Documentation on the Start menu to open the ST-Developer online manuals. The manual home page is located at the following URL within the installation directory:

    file:/<stdev_install_dir>/docs/index.html

2. Open a command prompt and use the rose file utility to list the installed system resource files. This verifies that the path, registry, and environment settings are properly configured. If you have problems, make sure that the %ROSE_BIN% directory is in your search path.

    C:\> rose ls

It should return something like the following:

    Total number of designs::  100
     
     In C:\Program Files\STEP Tools\ST-Runtime 14\schemas\*.*
     ?      ap239_product_life_cycle_support_mim_lf.rose
            ap239_product_life_cycle_support_mim_lf_EXPX.rose
     ?      associative_draughting.rose
            associative_draughting_EXPX.rose
     ?      automotive_design.rose
            automotive_design_EXPX.rose
     ?      building_design_schema.rose
            building_design_schema_EXPX.rose
            [ . . . files ommitted . . . ]

3. Go to the Start menu and open the ST-Developer online manuals. You will see a list of links to pre-installed schemas (AP201, AP202, etc). Go to one of them and compile one of the sample programs.

   For each sample program you will see a Windows project link. Right-click on the link to save the project zip file. Unpack the zip file and open the project file within with Visual Studio.

   If you prefer to work from the command line, there is also a makefile within the zip that you can build with nmake. If you may need to first run the vcvars32.bat file supplied with Visual Studio to put the cl compiler into your command line search path.