INSTALLATION OVERVIEW - SUMMARY


INTERACTIVE POWER-FLOW (IPF) - SOFTWARE PACKAGES

IPF 3.27 - 3.31

Ver 1.00 -- 1-June-2002



LINUX SYSTEM: new, first-time install


1.  Redhat Linux 5.0, 5.1, 5.2, 6.0, 6.1, 6.2, 7.0, 7.1, 7.2  [do not use 7.3, yet]

a.  Use "Custom Installation"

b.  Install "Everything"

c.  Login as "root".

d.  With "User Manager" create IPF-version user accounts for:

  ipf327user

  ipf331user


2.  Install Metrolink Motif Complete! Release 1.0, 1.2, or 1.5 

a.  Choose Motif 1.2.4 and 2.0 as the versions and libraries to install

b.  Install both Runtime and Development packages/libraries


3.  Copy the file, IPF-LinuxFULLPKG-327-331.tar.gz, to the top directory /.


4.  Unzip and untar IPF-LinuxFULLPKG-327-331.tar.gz .


5.  Compile the IPF-3.27, TSP-6.07, SFAP-1.01 set of programs, first.

a.  Change to the /update-disk subdirectory; 

b.  Copy the "sample.bash_profile..." files to the /root directory.

c.  Replace the default .bash_profile with the correct "sample" file.

d.  Use "sample" file for IPF 3.27 matching your version of Linux.


6.  Logout completely, and log back in as "root", to activate new .bash_profile.


7.  Change to the /shr directory, and type "make" to compile the programs.


8.  Install Adobe Acrobat reader, using the included "adobe405.tar.gz" file.


9.  If you are using Redhat Linux 6.2 or earlier, install the later version of 

     Ghostscript using the included file Ghostscript650.tar.gz, and follow the

     special directions described in, Ghostscript650onRedhat62_howto.PDF.


10.  Compile version 3.31 of the IPF program.

a.  Change to the /root subdirectory; 

b.  Replace the default .bash_profile with the correct "sample" file.

c.  Use "sample" file for IPF 3.31 matching your version of Linux.


11.  Logout completely, and log back in as "root", to activate new .bash_profile.


12.  Change to the /shr/ipf-3.31 directory, and type "make" to compile IPF-3.31.


13.  For future updates or re-compiles, make sure you are using the correct version  

      of .bash_profile, selected from the "sample" files, to match your version of Linux

      and to match the version of the IPF set of programs you want to recompile.


14.  Recompile:

a.  Recompile the entire /shr directory with the new /shr directory containing all 

              new source code; change directory to /shr and type "make clean" followed

     by "make" to recompile and update all the executables


b.  Recompile individual subdirectories under /shr, for /ipf-3.27, /tsp-6.07, 

              /sfap-1.01, /ipf-3.31, or later versions of these;  change to the appropriate

     subdirectory, /shr/ipf-3.27, /shr/tsp-6.07, /shr/sfap-1.01, /shr/ipf-3.31, or later

     and type "make clean" followed by "make" to recompile and update the

       executables.


15.  Read detailed installation steps in the included files, "SystemRH62-Install3d.PDF", 

       "ipf-3.27-install-howto3d.pdf", "IPF-InitialOperation.PDF", and

       "ipf_motif_usersetup.tar.gz".


16.  Logout and log back in as either "ipf327user" or "ipf331user" for access to a

     Motif Window Manager Desktop and customized "FrontPanel" with pop-up

     menus and pop-up help, how-to files, to run the IPF Graphic User Interface (GUI),

     or any of the batch versions of the IPF programs.  You can customize the FrontPanel

     pop-up menus by editing the file .fpanelrc residing in the ipf user directory 

     /home/ipfxxxuser  You can customize the X-applications for the initial MWM 

     Desktop by editing the file, .xinitrc residing in the ipfuser directory, /home/ipfxxxuser.


17.  You can open an Xterm terminal window and create subdirectories for specific

     projects.  Then change to those subdirectories with "cd", and run any of the IPF

     programs from the command line, for example, "gui &", "gui331 &", "bpf &", 

     "bpf331 &, "ipfbat &", or "ipfbat331 &".  The default commands are for IPF-3.27

     and should be run from the "ipf327user" login account.  The "xxx331 &" versions

     of the commands are for the specific IPF-3.31 version, which still does not have the

     other programs, TSP or SFAP, adapted for use with IPF-3.31, as they are for IPF-3.27.


18.  When you run the GUI from a subdirectory for a specific project, the default file

     opening paths of the GUI default to the subdirectory you are in.


19.  Important Note for running the IPF GUI:   Frequently there will be a pop-up

     window appearing saying "ERROR MESSAGE".  This is NOT really an error.  

     It is really just "User Information", and should not be considered as critical.

     This should be re-labeled as "INFORMATION MESSAGE", however it is hard-

     coded as part of a Motif widget, and will be changed at some time in the future.












LINUX SYSTEM:  update install


1.  For future updates, copy the newversion.tar.gz file containing the new /shr 

     directory to the top directory /. 


If you want to retain the existing /shr, rename it by typing "mv ./shr  /shr-old"


If not, remove the existing /shr by typing "rm -fR ./shr".


2.  Update:

a.  replace the entire /shr directory with the new /shr directory containing all 

              new source code; change directory to /shr and type "make clean" followed

     by "make" to recompile and update all the executables


b.  replace individual subdirectories under /shr, for /ipf-3.27, /tsp-6.07, 

              /sfap-1.01, /ipf-3.31, or later versions of these;  change to the appropriate

     subdirectory, /shr/ipf-3.27, /shr/tsp-6.07, /shr/sfap-1.01, /shr/ipf-3.31, or later

     and type "make clean" followed by "make" to recompile and update the

       executables.


3.  For updates and the latest information about the IPF programs, see:


http://www.interactivepowerflow.com/


MS-WINDOWS SYSTEM: 
  new, first-time install


1.  Copy the file, "cygnus_ipf_genericNT4-2K.PDF" or 

     "cygnus_ipf_genericW9X.PDF, to the C:\ drive, and read it in detail.


2.  Copy the file, Cygnus_IPF-3.27.18b_genericPKG_W95-98-NT.zip, to the C:\ drive and unzip it.


3.  Follow the installation directions described in Item-1, above.


4.  Copy the file, IPF-CygnusFULLPKG-327-332.tar.gz, to a directory on the C:\

     drive, and using the Cygwin terminal window, unzip and untar it.


5.  Unzip the file containing the IPF-3.32 updated executables, and use the 

     windows file manager to copy the updated executables to the /bin directory.


6.  The Cygnus version of IPF is "command-line only".  A Graphic User Interface

     (GUI) for the Cygnus version of IPF is not yet available.


7Also read detailed instructions in the included files,

     "SystemRH62-Install3d.PDF", "ipf-3.27-install-howto3d.pdf",

     "IPF-InitialOperation.PDF", and "ipf_motif_usersetup.tar.gz".




MS-WINDOWS SYSTEM:   update install


1.  Unzip the file containing the IPF-xx.xx updated executables, and use the 

     windows file manager to copy the updated executables to the /bin directory,

     replacing the older, previous versions.


2.  For updates and the latest information about the IPF programs, see:


http://www.interactivepowerflow.com/