Execute Setup

To perform the installation, in version 2.05 only a few simple steps are necessary:

1. Start an open image, most often called something like 'open.mi'
2. Execute the file 'setup.magik' in the 'install' subdirectory. You may do this either from the Magik-prompt by entering

   load_file("c:\model\swlookup\install\setup.magik")

   or by loading the file into the Emacs editor and pressing F2-B.
3. The following window will appear:

   

   Read the hints carefully, and make sure you have sufficient access rights for the installation directories. If necessary, you will be told about access right problems during the installation.
4. On the next screen you may enter the directory and the name of the image file to produce. This image file will be based on the image you just loaded and contain the SW-Lookup® code. The default value of the name is the name of the currently loaded image file, plus the ending '_swl'.

   

   'open.mi' would thus become 'open_swl.mi', for instance. You may change this to whatever you want, but please keep an ending of '.mi'.
5. Then you may choose where the executable files, which are necessary to run the PeerServer, will be placed. This is the file nconvert.exe, which is used for image convertion, and cygwin.dll, a DLL which is used by the ACP.

   

   The choice is limited to the directories in your current search path, because otherwise executable files will not be found. Normally, you may leave this as it is, because the default value is the executable path of your GIS installation. However, you need write access there. If this is not possible, you may choose a local searchpath.
6. The next value to enter is the directory to store the SW-Lookup® ACP, ps_comm_acp.exe. This can normally not be changed, except your SW_ACP_PATH variable contains several entries.:

   

7. At last, you may enter a directory where the setup program should copy your SW-Lookup® dispatcher. If you leave this field blank, the dispatcher is not copied and you may copy it manually.

   

8. On the last setup screen you will find a summation of your entries. Please check these values, and then start the installation by choosing 'Finish'.

   

Now close your GIS session and start again with the new created image. You will see some messages indicating the SEPIA is initialised. On opening the new image, the files SEPIA.DS and SEPIA_MAGIK.DS are created. These files are in the same directory as your GIS dataset.

If you desire to store these databases in a different directory, you have to enter the following after the installation (and save the image again!):
sepia.explicit_view_path << "your_desired_path" (for sepia.ds)
sepia_magik.explicit_view_path << "your_desired_path" (for sepia_magik.ds)

For the usage of SW-Lookup®, only the following steps have to be performed:

• optionally install the ACE
• Create the index

If you want to install a menu entry in your ACE which leads you to the configuration menu, follow these steps:

• Open the ACE menu
• Go to the ACE version control, go to the top alternative and switch to write mode
• Execute the file "install_ace.magik" which is contained in the swlookup module directory. This is done by entering
  load_file("<your-module-directory>/swlookup/install_ace.magik")
  at the magik prompt. This file will create a menu entry in the "system/configuration" menu to start the SW-Lookup® configuration menu.

You can also create the menu entry manually, if you wish so. The method name must be activate_swlookup_menu().

Then you are ready to use SW-Lookup®!