# $Id: INSTALL,v 1.3 2002/04/28 09:24:31 issever Exp $



====================================================================== 



			SMM++ Installation Guide
		 	   for windows systems



====================================================================== 

0) Index
--------

0) Index
1) Intro
2) Install itcl 3
3) Install SMM++
4) Troubleshooting

5) Upgrading from SMM++ V3.x 



====================================================================== 

1) Intro
--------

SMM is installed mainly in two steps:

  1. install itcl 3.1
  2. install SMM

The next sections will give more detailed information about each step.

An installation instruction is also available on the WWW, from which
you can directly download all needed packages. From the SMM++ homepage 
just follow the download link.

If you follow these instructions, the following directories will be 
created:

 - c:\smmxxx
 - c:\smmuser ; this one will be created on the first startup of SMM
 - c:\Program Files\Tcl

You may install SMM and itcl in any other directory, but you have to 
change the paths where it is necessary and edit a configuration file. 

Remarks on virus': I develop and package SMM under unix. So there 
should be no windows virus in the SMM sources itself, but please 
pay attention on the tcl sources. Sorry for the inconviences!

If you encounter any problem (e.g. download links don't work), 
please leave me a message! Thanks a lot!

1.a) Utility programs
---------------------

You will need at least a zip utility to unpack SMM++. I provide a
zip utility on the SMM website. Please check the 'Downlad SMM+: win'
web page.

====================================================================== 

2) Install itcl 3.1
-------------------
If you already have itcl 3.1 on your system, you can skip this step.

First of all: dont be afraid of itcl! It _is_ a standart extension to
tcl/tk, which again is a standart!

To be complete: SMM needs itcl/itk/iwidgets all together and at least
iwidgets in version 3, which again means itcl version 3.

Anyways,.. 

!!! You can skip this step, if you have itcl3.1 installed already. All 
!!! upgrading from SMM++ V3.x have to do this step too! For SMM++ V3.x 
!!! only itcl3.0 was provided.

1) Get the package: <a href="http://www.Physik.Uni-Dortmund.DE/~issevers/downloads/win/itcl82.exe">itcl82.exe</a>
2) Doubleclick on it. Installion will start.
3) If asked, choose all the packages provided: check all checkboxes.
4) Enter the path to where tcl/tk and itcl should be installed to.
   Preferable 'c:\Program Files\Tcl', otherwise you need edit
   the config file. The path you enter here, is the tcl path you are
   asked to give in the config file.

====================================================================== 

3) Install SMM++
----------------

1) Get SMM: smm.zip
2) Download it to C:.
   If you download it to any other directory, the directory
   smmxxx will be created in the other directory. So you will need to 
   edit the config file.
3) Unzip it there.

   Edit config file
-------------------
   If you choose any other directories for SMM and/or itcl, edit
   the file smm.itk in the smm\INSTALL.win directory.
   There you have to set each of the directories to the choosen ones.

   If you encounter problems, please drop me a line.

   Bind SMM++ and itkwish together
-----------------------------------
   You can skip this step, if you have done this step already 
   in a former installation
   (if you didnt need to install itcl3.1, you dont need to 
   do this too).
    
1) Hold the 'Shift' button pressed and right-click on the file smm.itk.
2) A window with "Open With" as title will pop up.
3) Click 'other'.
4) Type in 'c:\Program Files\Tcl\bin\itkwish31.exe'.
   (You might need to enter another path, if you did not use the
   default settings.)
   You can also browse in to the itcl directory, then go to 'bin'
   and finally choose 'itkwish31' from there.
5) Press open
6) Check the checkbox 'Always use this program...'.
7) click OK.
8) SMM++ will startup.
	
   Starting SMM++
-----------------
   From now on you can start SMM++ just by doubleclicking onto
   smm.itk (it now should have the toaster icon).


!!! If you encounter problems, please drop me a line.



====================================================================== 

4) Troubleshooting
------------------

Problem 1:
==========
smm.dat file
----------
After first installation; when trying to startup SMM++,
it complains 'smm.dat no such file or directory'.

Here is the bug report:
-----------------------
I've been trying to get SMM++ to work on my computer, Windows 95. 
I've already messed with smm.itk changing SMMPATH to g:\smm where 
the whole thing is installed and SMMSRCPATH to g:\smm\smm4r2 and
the TCLPATH to c:\Program Files\Tcl 

When I run smm.tlk it blows up claiming smm.dat no file or directory...
heck there is no smm.dat file cause this is the first run!!! What is the
problem?

Solution:
---------
Prior the fist startup of SMM++ the userdirectory may not 
exist! This is the way how smm detects that it has to build 
up the initial structure. As the smm sources are installed in 
g:\smm\smm4r2 the directory g:\smm exists. If you want to keep 
all smm related stuff in one directory, use the following approach: 

source dir: g:\smm\smm4r2 
user dir:   g:\smm\smmuser 




====================================================================== 

5) Upgrading from SMM++ V3.x 
----------------------------
You have to install the new version of itcl. Up to now itcl3.0 was
installed, now you should use itcl3.1.

If you follow the installation instructions, you just install itcl3.1
in parrallel to itcl3.0. There is nothing wrong with that, besides the
fact that it takes unnecessary disk space.

For removing itcl3.0: 
It is more natural to do this step before installing itcl3.1.
In the itcl3.0 directory you will find an uninstaller. It is
called 'unwise'. Just double click on it and start the deinstallation.



# ##############################################################################
# ### LOG MESSAGES
# ### As suggested by the CVS-manual this region is put to the end of the file.
# ##############################################################################
#
# $Log: INSTALL,v $
# Revision 1.3  2002/04/28 09:24:31  issever
# The startup file smm.tcl has been moved into the subsir sources/main.
#
# Revision 1.2  2001/08/19 12:25:42  issever
# Added the cvs keywords Id at start of the file
# and Log at the end of the file
#
#
