1# $Id: INSTALL,v 1.3 2002/04/28 09:24:31 issever Exp $ 2 3 4 5====================================================================== 6 7 8 9 SMM++ Installation Guide 10 for windows systems 11 12 13 14====================================================================== 15 160) Index 17-------- 18 190) Index 201) Intro 212) Install itcl 3 223) Install SMM++ 234) Troubleshooting 24 255) Upgrading from SMM++ V3.x 26 27 28 29====================================================================== 30 311) Intro 32-------- 33 34SMM is installed mainly in two steps: 35 36 1. install itcl 3.1 37 2. install SMM 38 39The next sections will give more detailed information about each step. 40 41An installation instruction is also available on the WWW, from which 42you can directly download all needed packages. From the SMM++ homepage 43just follow the download link. 44 45If you follow these instructions, the following directories will be 46created: 47 48 - c:\smmxxx 49 - c:\smmuser ; this one will be created on the first startup of SMM 50 - c:\Program Files\Tcl 51 52You may install SMM and itcl in any other directory, but you have to 53change the paths where it is necessary and edit a configuration file. 54 55Remarks on virus': I develop and package SMM under unix. So there 56should be no windows virus in the SMM sources itself, but please 57pay attention on the tcl sources. Sorry for the inconviences! 58 59If you encounter any problem (e.g. download links don't work), 60please leave me a message! Thanks a lot! 61 621.a) Utility programs 63--------------------- 64 65You will need at least a zip utility to unpack SMM++. I provide a 66zip utility on the SMM website. Please check the 'Downlad SMM+: win' 67web page. 68 69====================================================================== 70 712) Install itcl 3.1 72------------------- 73If you already have itcl 3.1 on your system, you can skip this step. 74 75First of all: dont be afraid of itcl! It _is_ a standart extension to 76tcl/tk, which again is a standart! 77 78To be complete: SMM needs itcl/itk/iwidgets all together and at least 79iwidgets in version 3, which again means itcl version 3. 80 81Anyways,.. 82 83!!! You can skip this step, if you have itcl3.1 installed already. All 84!!! upgrading from SMM++ V3.x have to do this step too! For SMM++ V3.x 85!!! only itcl3.0 was provided. 86 871) Get the package: <a href="http://www.Physik.Uni-Dortmund.DE/~issevers/downloads/win/itcl82.exe">itcl82.exe</a> 882) Doubleclick on it. Installion will start. 893) If asked, choose all the packages provided: check all checkboxes. 904) Enter the path to where tcl/tk and itcl should be installed to. 91 Preferable 'c:\Program Files\Tcl', otherwise you need edit 92 the config file. The path you enter here, is the tcl path you are 93 asked to give in the config file. 94 95====================================================================== 96 973) Install SMM++ 98---------------- 99 1001) Get SMM: smm.zip 1012) Download it to C:. 102 If you download it to any other directory, the directory 103 smmxxx will be created in the other directory. So you will need to 104 edit the config file. 1053) Unzip it there. 106 107 Edit config file 108------------------- 109 If you choose any other directories for SMM and/or itcl, edit 110 the file smm.itk in the smm\INSTALL.win directory. 111 There you have to set each of the directories to the choosen ones. 112 113 If you encounter problems, please drop me a line. 114 115 Bind SMM++ and itkwish together 116----------------------------------- 117 You can skip this step, if you have done this step already 118 in a former installation 119 (if you didnt need to install itcl3.1, you dont need to 120 do this too). 121 1221) Hold the 'Shift' button pressed and right-click on the file smm.itk. 1232) A window with "Open With" as title will pop up. 1243) Click 'other'. 1254) Type in 'c:\Program Files\Tcl\bin\itkwish31.exe'. 126 (You might need to enter another path, if you did not use the 127 default settings.) 128 You can also browse in to the itcl directory, then go to 'bin' 129 and finally choose 'itkwish31' from there. 1305) Press open 1316) Check the checkbox 'Always use this program...'. 1327) click OK. 1338) SMM++ will startup. 134 135 Starting SMM++ 136----------------- 137 From now on you can start SMM++ just by doubleclicking onto 138 smm.itk (it now should have the toaster icon). 139 140 141!!! If you encounter problems, please drop me a line. 142 143 144 145====================================================================== 146 1474) Troubleshooting 148------------------ 149 150Problem 1: 151========== 152smm.dat file 153---------- 154After first installation; when trying to startup SMM++, 155it complains 'smm.dat no such file or directory'. 156 157Here is the bug report: 158----------------------- 159I've been trying to get SMM++ to work on my computer, Windows 95. 160I've already messed with smm.itk changing SMMPATH to g:\smm where 161the whole thing is installed and SMMSRCPATH to g:\smm\smm4r2 and 162the TCLPATH to c:\Program Files\Tcl 163 164When I run smm.tlk it blows up claiming smm.dat no file or directory... 165heck there is no smm.dat file cause this is the first run!!! What is the 166problem? 167 168Solution: 169--------- 170Prior the fist startup of SMM++ the userdirectory may not 171exist! This is the way how smm detects that it has to build 172up the initial structure. As the smm sources are installed in 173g:\smm\smm4r2 the directory g:\smm exists. If you want to keep 174all smm related stuff in one directory, use the following approach: 175 176source dir: g:\smm\smm4r2 177user dir: g:\smm\smmuser 178 179 180 181 182====================================================================== 183 1845) Upgrading from SMM++ V3.x 185---------------------------- 186You have to install the new version of itcl. Up to now itcl3.0 was 187installed, now you should use itcl3.1. 188 189If you follow the installation instructions, you just install itcl3.1 190in parrallel to itcl3.0. There is nothing wrong with that, besides the 191fact that it takes unnecessary disk space. 192 193For removing itcl3.0: 194It is more natural to do this step before installing itcl3.1. 195In the itcl3.0 directory you will find an uninstaller. It is 196called 'unwise'. Just double click on it and start the deinstallation. 197 198 199 200# ############################################################################## 201# ### LOG MESSAGES 202# ### As suggested by the CVS-manual this region is put to the end of the file. 203# ############################################################################## 204# 205# $Log: INSTALL,v $ 206# Revision 1.3 2002/04/28 09:24:31 issever 207# The startup file smm.tcl has been moved into the subsir sources/main. 208# 209# Revision 1.2 2001/08/19 12:25:42 issever 210# Added the cvs keywords Id at start of the file 211# and Log at the end of the file 212# 213# 214