Historical Install Information

What is it for?

This page contains also orphaned install documentation and maybe this information is not neccessary or correct anymore.
However, lets keep the content and remove it later on ...

Content of this page

This page gives you historial information of what is required to run "rattleCAD 3D" on your PC.

Operating System Environment

rattleCAD is written in Tcl/Tk. To run rattleCAD your Operating System has to provide the required Tcl/Tk environment. The next chapter explain how to configure Tcl/Tk to run rattleCAD properly.

Tcl/Tk on Windows, Linux and MacOS X

... best practice to install Tcl/Tk on your computer is to download and install Tcl/Tk from ActiveState Tcl . Select the package that fits best to your computer and install this package,

Install Recomendation

Suggested Install Location on Windows

C:\Programme (x86)\rattleCAD\
    .\3.2.00\
    .\3.2.xx\
    .\3.2.78.26\
    .\3.3.02.01\ ................ Version/Revision Directories
    .\3.3.06.20\ ................ Version/Revision Directories
    .\3.3.06.36\ ................ Version/Revision Directories
        .\rattleCAD.tcl ......... tcl-Script to use with installed tclTk Environment
        .\rattleCAD.exe ......... standalone runtime
    .\tclkit.ico ................ rattleCAD icon-File
    .\rattleCAD.tcl
    .\rattleCAD.bat ............. version control batch files to start rattleCAD
    
Eigene Dateien\rattleCAD\
    .\components\ ............... users components Library
    .\_your_Project.xml ......... project Files
    .\export\
        .\anyFile.ps ............ exported Postscript File
        .\anyFile.svg ........... exported SVG File
        .\anyFile.dxf ........... exported DXF File
    .\html\
        .\index.html ............ exported HTML File


Suggested Install Location on Linux/Unix and MacOS X

/opt/rattleCAD
    ./3.4.04/ ....................... Version Directory
        ./_plugin ................... Version Plugin Directory
            ./...
        ./rattleCAD_3.4.04.10.kit ... Version/Revision kit-File
        ./rattleCAD_3.4.04.22.kit ... Version/Revision kit-File
    ./3.4.05/ ....................... Version Directory
        ./_plugin ................... Version Plugin Directory
            ./forkReplacement ....... forkReplacement plugin
            ./rattleCAD_3D .......... rattleCAD_3D - plugin
            ./plugin.xml ............ plugin - Config File
        ./rattleCAD_3.4.05.02.kit ... Version/Revision kit-File
        ./rattleCAD_3.4.05.03.kit ... Version/Revision kit-File
        ./...
        ./rattleCAD_3.4.05.24.kit ... Version/Revision kit-File

/home/~/rattleCAD/
    ./components/ ............... users components Library
    ./_your_Project.xml ......... project Files
    ./export/
        ./anyFile.svg ........... exported SVG File
        ./anyFile.dxf ........... exported DXF File
    ./html/
        ./index.html ............ exported HTML File

Run rattleCAD

Windows

C:\Programme (x86)\rattleCAD>
    rattleCAD.tcl ............... if tcl-Interpretor is installed (e.g.: ActiveState)
    rattleCAD.bat ............... run the starkit-Version for Windows

Linux/Unix

... from installation directory

cd /opt/rattleCAD/3.4.05
tclsh ./rattleCAD_3.4.05.24.kit

... from anywhere

tclsh /opt/rattleCAD/3.4.05/rattleCAD_3.4.05.24.kit

Check Tcl/Tk Configuration

... minimum requirement

... version of tcl interpretor ..... -> 8.6 ...... or higher
... required package tdom .......... -> 0.8.3 .... or higher
... required package BWidget ....... -> 1.9.10 ... or higher

... chack environment manually

tclsh .......................... run the tcl interpretor
    % info tclversion ............ get version of tcl interpretor
    % package require tdom ....... test required package tdom
    % package require BWidget .... test required package BWidget

... check environment via supplied script rattleCAD_checkEnv.tcl

    tclsh rattleCAD_checkEnv.tcl

... returns ...


 ====== I N I T ============================


 -- auto_path ----------

      ... C:/Tcl/8.6.6/lib/tcl8.6
      ... C:/Tcl/8.6.6/lib
      ... C:/Program Files (x86)/rattleCAD/3.4.05/lib
      ... C:/Program Files (x86)/rattleCAD


 -- tcl ---------------

     OS ($tcl_platform):
          byteOrder       littleEndian
          engine          Tcl
          machine         amd64
          os              Windows NT
          osVersion       10.0
          pathSeparator   ;
          platform        windows
          pointerSize     8
          threaded        1
          user            yourUserName
          wordSize        4
     tcl:
          8.6.6


 -- tcl-packages ------


   -- common ------------
     tcl package   Tk               8.6.6
     tcl package   BWidget          1.9.10
     tcl package   tdom             0.8.3
     tcl package   TclOO            1.0.5


   --- windows ----------
     tcl package   registry         1.3.2
     tcl package   log              1.3

...sorry, that This is a windows result ... maybe someone can supply me a linux result ;)

... install missing packages

sudo apt-get install BWidget
sudo apt-get install tdom


Linux/Unix Version ... 3.4.02 and older

Suggested Install Location

/opt/rattleCAD
    ./3.2.00/
    ./3.2.xx/
    ./3.2.78.26/
    ./3.3.02.01/ ................ Version/Revision Directories
    ./3.3.06.20/ ................ Version/Revision Directories
    ./3.3.06.36/ ................ Version/Revision Directories
        ./rattleCAD.tcl ......... tcl-Script to use with installed tclTk Environment
    ./rattleCAD.tcl ............. version control
    
/home/~/rattleCAD/
    ./components/ ............... users components Library
    ./_your_Project.xml ......... project Files
    ./export/
        ./anyFile.ps ............ exported Postscript File
        ./anyFile.svg ........... exported SVG File
        ./anyFile.dxf ........... exported DXF File
    ./html/
        ./index.html ............ exported HTML File

... check tcl Configuration

/opt/rattleCAD>
    tclsh ...................... test the tcl interpretor
    info tclversion ............ get version of tcl interpretor (8.5 or more)
    package require tdom ....... test required package tdom
    package require BWidget .... test required package BWidget

... run rattleCAD

/opt/rattleCAD>
    tclsh ./rattleCAD.tcl ...... if tcl-Interpretor is installed

Tcl/Tk on Ubunto Linux (14.04)

    new in rattleCAD 3.4.01.66 and improved in rattleCAD 3.4.01.67

  1. extract rattleCAD-zip file as described above
  2. check Tcl/Tk-installation
    1. open a terminal-Window (xterm, ...)
    2. goto installed rattleCAD-Version directory
    3. cd /opt/rattleCAD/3.4.01.67
    4. run test-Script
    5. tclsh ./rattleCAD_checkEnv.tcl
    6. check output of test-Script
    7. ====== I N I T ============================


       -- auto_path ----------
            ... /usr/share/tcltk/tcl8.6
            ... /usr/share/tcltk
            ... /usr/lib
            ... /usr/local/lib/tcltk
            ... /usr/local/share/tcltk
            ... /usr/lib/tcltk/i386-linux-gnu
            ... /usr/lib/tcltk
            ... /usr/lib/tcltk/tcl8.6
            ... /samba/rattleCAD/dev/3.4.01.66/lib
            ... /samba/rattleCAD/dev


       -- tcl-packages ------

            unix


      -- common ------------
            tcl package Tk 8.6.1
            tcl package BWidget n/a
            tcl package tdom n/a



      ====== E R R O R ==========================

          ... missing packages

            BWidget          -> sudo apt-get install BWidget
            tdom             -> sudo apt-get install tdom

    8. install missing packages
    9. sudo apt-get install BWidget
      sudo apt-get install tdom
    10. run test-Script
    11. tclsh ./rattleCAD_checkEnv.tcl
    12. check output of test-Script
    13.    ...

      ====== O K ================================

          ... all required packages installed!

    14. run rattleCAD
    15. /opt/rattleCAD
          tclsh ./rattleCAD.tcl

Tcl/Tk on Linux Mint

    thanks to hammertownhead

  1. Open "Synaptic Package Manager"
  2. In the search type "tcl"
  3. Select and install "tcl8.5"
  4. In the search type "tk"
  5. Select and install "tk8.5"
  6. In the search type "bwidget"
  7. Select and install "bwidget"
  8. In the search type "tdom"
  9. Select and install "tdom"
  10. Open up a command prompt and enter

  11. sudo update-alternatives --config tclsh

    and you will see the following

    There are 3 choices for the alternative tclsh (providing /usr/bin/tclsh).
    Selection Path Priority Status
    ------------------------------------------------------------
    * 0 /usr/bin/tclsh-default 10000 auto mode
      1 /usr/bin/tclsh-default 10000 manual mode
      2 /usr/bin/tclsh8.4 841 manual mode
      3 /usr/bin/tclsh8.5 840 manual mode
    Press enter to keep the current choice[*], or type selection number:

  12. You will be prompted with several options, type the number which selects "tclsh8.5"
  13. Download and install RattleCAD to your home directory.
  14. To run rattleCAD from the command prompt type navigate to

  15. /home/{yourusername}/RattleCAD/

    and then type

    tclsh rattleCAD.tcl