Search Installation Guide

Search is a set of C and FORTRAN routines that can be launched from R, SAS, SPSS or Stata or run independently using data from many sources. Search is available for computers running the Linux, Mac OS X and Microsoft Windows systems. The SAS implementation runs natively only on Linux and Windows.

Search for Windows

  1. Download the srclib_windows.msi installer file.
  2. Run the installer. The default directory for the installation is “C:\Program Files\Srclib”, but you can put it wherever you want it. The location you choose will replace “~/srclib” in the guides for using Search with R, SAS, SPSS, Stata and Srcware. The installer will create a desktop icon unless you tell it not to.
  3. If the Windows Installer detects an existing installation, it will give you a choice of repairing (updating) the existing installation or removing it. If you want to update Search in its current location, click “Repair.” If you want to change the location, click “Remove” and repeat the installation process.
  4. If you want to save a previous version of Search or have it in more than one location, copy the C:\Program Files\Srclib directory (or wherever you installed it) and paste it where you want it, for example, as C:\Search\Srclib. You could create a desktop icon targetting C:\Search\Srclib\srcshell.exe or run from that address directly.
  5. If you plan to use Srclib with R, SAS, SPSS or Stata and the version you want can’t be invoked by its lower-case name (rscript for R), edit the Srclib\settings.xml file to provide the correct path. You can get the correct path from the properties of the desktop icon for the software.
  6. To verify that Srclib is installed correctly, download the srclib_examples_windows.zip file, extract the Examples directory into an appropriate parent directory. You can put it wherever you want it.
  7. Double-click the Srclib desktop icon, click “File” and then “Open”, navigate to the Examples directory, open an appropriate setup file, for example, ive_examples_srcware.xml, and click “Run”.
  8. Using MS Word or other software, check the *.log files produced by the run to see that there were no errors and compare the *.lst files produced by run with the corresponding *.chk files. They should differ only in the dates.

Search for Linux

  1. Download the srclib_pclinux.tgz file and extract the srclib directory into an appropriate parent directory, such as, /usr/local/ or ~/. You can put it wherever you want it. The location you choose will replace “~/srclib” in the guides for using Search with R, SAS, SPSS, Stata and Srcware.
  2. If you plan to use Srclib with R, SAS, SPSS or Stata and the version you want can’t be invoked by its lower-case name (rscript for R), edit the srclib/settings.xml file to provide the correct path.
  3. To verify that Srclib is installed correctly, download the srclib_examples_pclinux.tgz file, extract the examples directory into an appropriate parent directory. You can put it wherever you want it.
  4. Navigate to the examples directory and use srcexec to run an appropriate setup file, for example, ~/srclib/bin/srcexec ive_examples_sas.xml.
  5. OR run emacs with “-l ~/srclib/srcshell.el” as a command-line or icon option, click “File” and then “Open”, navigate to the Examples directory, open an appropriate setup file, for example, ive_examples_srcware.xml, and press F8.
  6. Using the Linux cat and diff commands or other software, check the *.log files produced by the run to see that there were no errors and compare the *.lst files produced by run with the corresponding *.chk files. They should differ only in the dates.

Search for MacOS

Search for MacOS is a universal binary. It runs without translation on both Intel 64 and ARM 64 Macintosh computers.

  1. Download the srclib_macosx.pkg installer file.
  2. Run the installer. The default directories for the installation are “/Applications/Srcshell.app” for the app and “/Library/Srclib” for the library. The latter will replace “~/srclib” in the guides for using Search with R, SPSS, Stata and Srcware.
  3. You may move or copy /Applications/Srcshell.app and /Library/Srclib to another location, for example, to ~/, your home directory. If you have an existing installation of IVEware in a location other than the default location, uninstall the existing installation before installing a new one.
  4. If you plan to use Srclib with R, SPSS or Stata and the version you want can’t be invoked by its lower-case name (rscript for R), edit the /Library/Srclib/settings.xml file to provide the correct path.
  5. To allow MacOS to run the software properly, follow these instructions to unblock the software, prior to testing the software with the Examples:
  6. 1. Log in as an administrator.

    2. Begin by unblocking srcshell.app. To do this use Finder and navigate to “/Applications/Srcshell.app”.

    3. Right-click on srcshell.app using either control-click or two-finger to “Open”.

    4. Click “Open”.

    5. Repeat steps 3 and 4 (using Finder) for any programs you would like to use in “/Library/Srclib/bin”.

  7. To verify that the software is installed correctly, download the srclib_examples_macosx.tgz file, extract the examples directory into an appropriate parent directory. You can put it wherever you want it.
  8. Double-click the Srcshell.app icon in the Applications folder, click “File” and then “Open”, navigate to the examples directory, open an appropriate setup file, for example, ive_examples_srcware.xml, click “Run” and then “Run Srcexec”.
  9. Using the Mac/Linux cat and diff commands or other software, check the *.log files produced by the run to see that there were no errors and compare the *.lst files produced by run with the corresponding *.chk files. They should differ only in the dates.

Please report problems or send comments via e-mail to IVEware Support: isr-iveware@umich.edu. For more detailed help, please complete and submit this Help Request.