Survey Methodology Program

IVEware Installation Guide

IVEware 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. IVEware is available for computers running the Linux, Mac OS X and Microsoft Windows systems. The SAS implementation runs natively only on Linux and Windows.

IVEware 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 IVEware 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 IVEware 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 IVEware 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:\IVEware\Srclib. You could create a desktop icon targetting C:\IVEware\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.

IVEware 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 IVEware 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.

IVEware for MacOS

IVEware 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 IVEware 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”.

  6. 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.
  7. 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”.
  8. 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.

© The Regents of the University of Michigan, 2024. All rights reserved. Permission is granted to use, copy and redistribute this software for any purpose, so long as no fee is charged and so long as the copyright notice above, this grant of permission, and the disclaimer below appear in all copies made; and so long as the name of the University of Michigan is not used in any advertising or publicity pertaining to the use or distribution of this software without specific, written prior authorization. Permission to modify or otherwise create derivative works of this software is not granted. This software is provided as is, without representation as to its fitness for any purpose, and without warranty of any kind, either express or implied, including without limitation the implied warranties of merchantability and fitness for a particular purpose. The regents of the University of Michigan shall not be liable for any damages, including special, indirect, incidental, or consequential damages, with respect to any claim arising out of or in connection with the use of the software, even if it has been or is hereafter advised of the possibility of such damages.