Directions to install and run MEDM on a PC running Windows98, or newer.

Rev 00  12JUN2001 P. Sichta
Rev 01  13JUN01  PS
Rev 02  16OCT02  ps
Rev 03  18NOV02  ps
Rev 04  26NOV02  ps

Required Software:
1)  Exceed 6.0 or later.  Other x-servers may work. Works with ReflectionX.
2)  WinZIP or similar utility.
3)  PPPL-written MEDM Installation CD with EPICS WIN32 zip file and NSTX-specific EPICS 
application files. See Appendix A for more info.
4)  Windows 'Install_Shield' utility.


Procedure:
1)  If not already done, install Exceed or ReflectionX in the typical fashion. 

2a)  Insert the PPPL-written CD-ROM or download the PPPL Public\EPICS\EPICS_Distribution folder.  

2b) Copy the file EPICS_Distribution\EPICSEx33-win32.exe to your desktop.  

3)  Double-click the EPICSEx33-win32.exe icon on your desktop to install a suite of EPICS applications on your computer.  Use the default/typical settings during the installation.

4)  Delete the EPICSEx33-win32.exe file from your desktop; It is no longer needed.

5)  Copy the folder EPICS_Distribution\NSTX to C: to make the directory C:\NSTX.  If you already have a C:\NSTX folder on your PC, then see Appendix A. 

6)  Navigate to C:\NSTX\epics and make a shortcut to the file C:\NSTX\epics\Exceed_StartMEDM.bat or ReflX_StartMEDM.bat (depends on your X-server program. See your site's EPICS system administrator for other X-Servers) , and place it on your desktop.  You can change the label and the ICON for the shortcut... see Appendix A.

7) Double-click the desktop's StartMEDM shortcut icon to start medm for NSTX!

8) If you make your own medm displays be sure to save them in the C:\NSTX\epics\medm_displays directory.



Other requirements (items 2 and 3 don't apply if you are using the EPICS Gateway):
----------------------------------------------------------------------------------
1) In order to perform EPICS control from your PC,  the ASCF (Channel Access Security) files (used by the IOC's and the EPICS Gateway) will need to be modified to permit your PC to read/write specific EPICS records.  See your EPICS System Admin.

2) If not already done, each IOC will need to be instructed regarding a network route  to your PC.  This usually means specifying a gateway out of the IOC's network. Use the vxWorks routeAdd() function in the st.boot or st.cmd file.

3) Your PC must be given permission through the NSTX firewall. 




########################################################################################
########################################################################################
########################################################################################



Appendix A
----------
Additional Details

1)  MEDM has no licensing restrictions.
2)  In the C:\NSTX\epics folder,  the medm_displays folder was manually ftp'd from the epicsrv computer.  So, your medm display pages will not keep current with all the displays on epicsrv.  See your EPICS  system administrator if this is a problem and/or for an update.
3)  Use the right mouse button to rename the desktop shorcut to StartMEDM.
4)  To change the shorcut icon for StartMEDM:
  a)  Right-mouse click over the shorcut and select Properties.
  b)  Poke the Change Icon button.
  c)  Poke the Browse button.
  d)  Browse to 'C:\Program Files\EPICS WIN32 Extensions' and select medm.exe.  
  e)  Poke the Open button.
  f)  Poke the OK button on the Change Icon window..  
  g)  Poke the OK button on the StartMEDM Properties window.
5)  If you already have a C:\NSTX folder on your PC, then copy the folder NSTX\epics into C:\NSTX directory to make the folder C:\NSTX\epics.



########################################################################################
########################################################################################
########################################################################################


Appendix B
----------
Example-only Listing of the Windows 2000 Batch File to launch MEDM.


rem StartMEDM.BAT
echo off


rem created 12JUN2001 by P. Sichta
rem rev 01 17OCT02  ps


rem ############### ENVIRONMENT ########################################
rem ### Environmental Variables for EPICS Channel Access 
rem for the EPICS Gateway 
set EPICS_CA_ADDR_LIST=198.35.15.132
rem to inhibit PV search network broadcasts
set EPICS_CA_AUTO_ADDR_LIST=NO


rem ### Environmental Variables for Exceed
set Path=C:\Program Files\Exceed.nt;%path%
set DISPLAY=localhost:0
set XAPPLRESDIR=C:\Program Files\EPICS WIN32 Extensions
set XKEYSYMDB=C:\Program Files\EPICS WIN32 Extensions\XKeySymDB
set XLOCALEDIR=C:\Program Files\EPICS WIN32 Extensions\locale
set LOGFILE=C:\Program Files\EPICS WIN32 Extensions\exceed.log
set LOGGING=YES

rem ### search path for medm.exe
set Path=C:\Program Files\EPICS WIN32 Extensions;%path%

rem ### Environmental Variable EPICS_DISPLAY_PATH, search path for medm display (.adl) files
set EPICS_DISPLAY_PATH=C:\NSTX\epics\medm_displays;%EPICS_DISPLAY_PATH%




rem ################### START PROGRAMS ####################################
rem Start exceed Xserver
start exceed.exe

rem Start MEDM with top-level display CE00.adl
start medm.exe  -bigMousePointer -x -displayFont scalable  CE00.adl



echo on
rem exiting StartMEDM.bat

exit


###########################################################################################
###########################################################################################
###########################################################################################