Cygwin Installation:

(For PC's running Microsoft OS.)

CSIM, by its nature, requires a compiler and development libraries. Although Unix/Linux PC's tend to contain all necessary functions, Microsoft systems tend to lack development tools. Fortunately they can be added without additional costs from the Cygwin libraries.

To install CSIM on a Microsoft Windows PC under Cygwin, you must have Cygwin installed and you must be in a Cygwin or an Xterm window. Cygwin is a freely available package of libraries that bring powerful development capabilities to MS-windows. You can burn your own installation CD from cygwin_cd.iso [725-MB] (right-click to save-as). (Note that this file is a complete CD-rom image. You need to burn it as an ISO image; not just a data-disk containing containing the iso file.) Then CAREFULLY follow Cygwin installation procedure directly below. For other options, see Other Advanced Cygwin Options.

Cygwin installation is straightforward. It is driven by the installation manager, which you open first. It enables you to control which packages you download and install. We recommend installing ALL cygwin packages, which requires about 1.9 GB free space.

Note: We have found that on some newer centrally administered Microsoft platforms (ex. corporate administered), whomever wants cygwin installed must be granted temp Admin rights to install it. Then take away the privileges when finished and test-run for the first time.

Cygwin Installation Procedure:                                                                                    

CAUTION: You MUST follow these step-by-step instructions CAREFULLY -- ESPECIALLY STEP 7   !!!!!!!!!.
  1. Insert Cygwin Installation CD, and open file browser on it. It should look like this.
    Open the Install directory by double-clicking on it.

  2. Invoke the Cygwin setup.exe file by double-clicking:  


    This brings up the Cygwin installer that you will use for installing Cygwin.


    Click Next.

  3. Select: Install from local directory.
    Then click Next.

  4. The next screen is titled: Select Root Install Directory
    Where it says: Where you want to install:
    leave this as: C:\cygwin
    or whatever drive/directory you want to install Cygwin TO.
    (Note that a limitation of Microsoft's registry-based file-system is that only one copy of Cygwin can be actively registered.)
    Click Next.

  5. The next screen is titled: Select Local Package Directory
    Even though it says:   Where you want Setup to store ...,   you should pick the drive containing the Cygwin-setup CD.
    (When installing from CD, point this at the CD's install directory.)
    Click Next.

  6. Watch Progress. You will see Checking Package: as each of many packages go by, and a progress bar. This may take a few minutes.
    (Nothing is actually being installed yet. It is just checking all the packages.)

  7. Finally you will see the screen for Select Packages.
    At the top, there will be:       ... Which must be changed.

    It is important that you click only the up-down () arrow symbol.
    Wait for it to respond. It may take a few seconds to toggle the selection (to the right) on each click.
    ===>>   You should click it ONCE to toggle Default to Install  <<===.

    The key here is that you want to it to say:   .

    (Caution:   Default - does NOT equal - ALL !!!>     Specifically, Default does NOT install the X-server and development libraries needed by CSIM.)


    (Common mistakes at this critical point are:
    1. Selecting install-default. This does *NOT* install all;
    2. Clicking the + sign or clicking the round-arrows too fast and clicking next too soon so that the wrong selection is taken.
    )

    Click Next.

  8. You will then see the Progress Page
    Go get a cup of coffee. You will see three progress bars. It may take a few minutes.

  9. On the finish screen, it asks about creating a Cygwin icon. Click Finish and then OK.

Post Install:
Now that Cygwin is installed, make a short-cut (desktop icon) to:   {cygwin_root}\usr\X11R6\bin\startxwin.bat
Where {cygwin_root} is the location where you placed the cygwin directory. Ex.   c:cygwin
See Cygwin Setup for additional info about setting up your Cygwin environment.

Invoke Cygwin:
Click the startxwin.bat icon, or invoke startxwin.bat from a DOS window. You must do this to start the X-server. You need to do this only once per session of using Cygwin (for example, after re-booting your PC).

You should now have a terminal window, and you can run X-window programs. Complete the installation from step (2) below.

Note: If your cygwin installation process was not successful or you wish to start-over, you should re-invoke setup.exe and run through the steps (as if you were installing) until you hit step 6, then select un-install. The Cygwin installer and Microsoft's registry attempt to maintain information about the Cygwin installation. If the installation state becomes corrupted for any reason, such as a mis-install or a downloading hangup, it may be necessary to edit the registry file with Regedit to delete all instances of Cygwin entries before trying to install again.

Complete the CSIM installation steps 1-4 under the CSIM Install Instructions

You must work do these from within a Cygwin X-window, such as the one started from startxwin.bat. After completing the CSIM installation and sourcing CSIM's setup file, test CSIM by invoking the CSIM GUI. After sourcing the CSIM setup file in the Cygwin X-terminal window, type gui. If it fails to bring up a window:

Additional Cygwin installation notes can be found at:

For questions, contact: 

	E-Mail: chein@atl.lmco.com