|
Walnut
>
Documentation
>
Nutshell ground build-up
>
msvc-install.txt
msvc-install.txt
$Id: msvc-install.txt,v 1.1 2002/07/11 12:56:10 maryniak Exp $
Installation and configuration of Microsoft Visual C++ 6.0
for the Nutshell/Walnut Pionier project under Microsoft Windows.
Nutshell is developed with Microsoft Visual C++ 6.0 (Service Pack 3) on
Windows NT 4.0 (SP6a), Windows 2000 (SP1) and Windows 98 ("first edition").
Copyright (C) 2000-2002 University of Amsterdam
Authors: Robert Berg <rjberg@xs4all.nl>
Eric Maryniak <e.maryniak@pobox.com>
The NeuroMod Group on the Web:
http://static/
Introduction
------------
This document describes the necessary steps to install and configure
Microsoft Visual C++ (v. 6.0) in such a way, that you can compile and
build the Nutshell/Walnut software under Microsoft Windows.
Nutshell is developed by various members of the NeuroMod group with
Microsoft Visual C++ 6.0 (Service Pack 3) on these Windows versions:
Windows 98 ("first edition")
Windows NT 4.0 (SP6a, with Internet Explorer 5.5 SP1)
Windows 2000 (SP1)
The procedure will probably work verbatim for Windows 98 Second Edition
and Windows ME (Millenium Edition). It may also work on Windows 95, but
you are advised to install Internet Explorer 5.5 Service Pack 1 (or higher),
first in that case. You should also install IE 5.5 sp1 (or higher) when
using Windows NT (be sure to install Service Pack 6a or higher).
Note that the Nutshell has not been ported to other compilers than
MSVC++, such as Borland Builder C++, under Windows. The detailed
descriptions of the software modules in this document can, however,
be used to get the software to work with other compilers and perhaps
under other operating systems (such as Linux), as well.
Nutshell itself is a Windows application and will not easily port to
other operating systems or platforms, such as Linux or Apple.
The Walnut libraries, however, are platform indenpendent.
Installation and configuration of MSVC++
----------------------------------------
0. Verify the operating system environment and CDs:
o Windows NT 4.0 US/English, service pack 6a (or newer) and
Internet Explorer 5.5 SP1 or higher, or
Windows 2000 Service Pack 1 or
Windows 98.
o Fast Internet connection (for downloading service packs :-)
o Sufficient hardware and memory (at least 128, 256 Mb Ram preferred)
o Microsoft Visual C++ 6.0 UK (professional edition) CD #1
o MSDN Library for Visual Studio 98 (documentation) CD #1 and #2
1. Installation of MSVC++ 6.0 sec
- Become Administrator or a user from the Administrator group
(not applicable to Windows9x)
- Insert MSVC++ 6.0 CD and choose defaults, except:
o Custom installation
o [X] Data Access
[X] Microsoft ODBC Drivers, use only:
[X] Microsoft Access ODBC Driver
[X] Microsoft Excel ODBC Driver
[X] Microsoft Text ODBC Driver
o [X] Register Environment Variables
- Continue with installing MSDN info: ...
[X] Install MSDN
2. Installation of MSDN documentation
- Insert disk #1 (of 2) and choose defaults, except:
o Custom installation, use only:
[X] Full Text Search Index
[X] VC++ Documentation
[X] Platform SDK Documentation
[X] VS Shared Documentation
- Skip installing InstallShield, unless you want to create
distributions of the Nutshell program (not necessary for
paradigm users and developers) and go to step 4.
If you want to install InstallShield, select 'InstallShield'
and then the 'Install' button and go to step 3.
3. Installation of InstallShield
- Insert MSVC++ 6.0 CD again and choose Install.
- Use the (o) Typical installation
- Click Next in "Other Client Tools".
- Continue with registering the software: ...
4. Registering the software
Note: this example applies to John Doe.
UserId: john_doe
Passwd: snafu
URL's:
http://msdn.microsoft.com/visualc/
http://msdn.microsoft.com/vstudio/sp/vs6sp3/default.asp
From these pages, continue with: ...
5. Downloading the Service Packs for MSVC++
- Download the Service Packs for Visual Studio 6.0
- Select:
Full: English (Go)
- On 2000-01-24 the current service pack was 3.
- Do the Multi-Part Download (12 files)
- When all 12 files are downloaded (to a temp dir), extract them
to another temp dir, say C:\Temp (_must_ empty!):
- From C:\Temp, run _in this order_ :
1. mdac_typ.exe (may fail on Windows 2000, this is ok)
2. htmlhelp.exe
3. setupsp3.exe
Oddly enough, the update does not show in the version info
in the About info. Remove the C:\Temp files.
6. Downloading STLport
- Download the latest _stable_ (ie. non-beta) STL (Standard Template
Library) from:
http://www.stlport.org/
(on 2000-01-24 this was version 3.2.1).
Note on 2001-03-16: we have had a lot of problems with STLport 4.0
upto and including Nutshell 1.0.253. We tried to build a statically
linked version of Nutshell, but this failed due to all sorts of
problems with multi-threading and conflicting overloaded new
operators.
Bottomline: better not use STLport 4.0 with Nutshell <= 1.0.253.
Note on 2002-01-07: these problems have not been investigated for
Nutshell version 1.0.255.
- Installation, which is also documented on:
http://static/nutshell/developers.html
is as follows (_use the specified order_!):
1. make an empty temp dir, say C:\temp
2. make a directory 'stl' in:
C:\Program Files\Microsoft Visual Studio\Vc98
3. extract the STL Port archive (eg.: STLport-3.2.1.tar.gz)
to the temp dir
4. in the temp dir, remove file "ChangeLog" and directory "test",
there should remain one (1) directory: stlport
5. move the files and directories from the 'stlport' sub-dir to
the 'stl' sub-directory (in C:\...\Vc98)
7. Configuring MSVC++
- Open MSVC++
- Select Tools|Options, Directories
- Select Platform [Win32], Show Directories for [Include Files]
- Add the STLPort directory to the top of the list
(note: replace 'C:' appropiately if you installed MSVC++ elsewhere):
C:\Program Files\Microsoft Visual Studio\Vc98\stl
C:\Program Files\Microsoft Visual Studio\Vc98\INCLUDE
C:\Program Files\Microsoft Visual Studio\Vc98\MFC\INCLUDE
C:\Program Files\Microsoft Visual Studio\Vc98\ATL\INCLUDE
Please note that this will influence all your own projects, too.
They will all use STLport instead of the Microsoft STL implementation.
If you do not want this, then do not specify the directories here, but
specify all four directories under "Additional include directories"
(Project|Settings menu, C/C++ tab, Category "Preprocessor").
Also select [X] Ignore standard include paths.
You must do this for all the projects: WalnutCore, Components,
Paradigms, Nutshell and all paradigms (Hopfield etc.).
Restart the computer: there should be no errors.
8. Build up the Nutshell Project from the ground (ie. source files) up.
Refer to document: master-ground-buildup.txt
$Source: /home/cvsroot/Walnut/C++/Doc/internal/msvc-install.txt,v $
Other relevant documents:
| 
University of Amsterdam