Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
bgColor#FFFFCE
installdir=~/Applications/Echo360/Personal\ Capture.app

...

  • The installation file has been downloaded and you know the directory to which the executable was saved.
  • The directories identified in the configuration file can be created on the target computer.
  • You know and can include the fully qualified path to the configuration file.

If you are not familiar with the standard installation process, see Install Personal Capture Software.

To perform an unattended install:

  1. Create and save a configuration file as described above.
  2. Download the installation executable package (EchoSystemPersonalCaptureForMac.zip) from the ESS Downloads page, then unzip it.
    Note the following:
    • If you have multiple ESSs, be sure the installer you use is from the same ESS with which the Personal Capture installation will be used.
    • Be sure to note the location of the executable. You will need to run the installation command from this location.
     
  3. Open the Terminal.
  4. Navigate to the directory where the installation executable was saved.

    Code Block
    cd ~/Downloads/Echo360PersonalCaptureInstaller.app/Contents/MacOS 
  5. Enter the following commands to adjust the permissions needed for this procedure.

    Code Block
    chmod +x Echo360\ Personal\ Capture && chmod +x osx-intel && chmod +x installbuilder*
  6. Run the installation using the configuration file parameters. Be sure to use the fully qualified path to the configuration file. The example command shown below assumes the configuration file is saved on the Academic Staff member's desktop on the target computer. Replace ~/Desktop/ with the appropriate directory/path.

    Code Block
    ./installbuilder.sh --mode unattended --optionfile ~/Desktop/config.txt


  7. When the installer is finished, close the Terminal window.

Troubleshooting the Installation

If you have problems with the installation, you can turn on a higher level of error messaging by adjusting the "debuglevel" option in the configuration file and specifying the location of the debug results. The most "verbose" debug level is level 4, and should provide you with sufficient information. 

An example configuration file for additional debug logging (The example file that is shown below assumes the debug file name being created is debug.txt and that it is being saved on the Academic Staff member's desktop on the target computer. Replace debug.txt with the appropriate filename and ~/Desktop/ with the appropriate directory/path):

Panel
bgColor#FFFFCE

installdir=~/Applications/Echo360/Personal\ Capture.app

debugtrace=~/Desktop/debug.txt

debuglevel=4

Next Steps

For Personal Capture installations, inform the Academic Staff members of the new or upgraded program. You can point users to Personal Capture for Academic Staff online documentation, or instruct them to click the Help link in the interface for a PDF containing instructions for use.

If you upgraded Personal Capture installations for Mac users, you may want to inform staff of the new interface, and of the following:

  • Existing recordings will appear in the new version. If users do not see them, have them navigate to the Settings page and check or edit the path to their recordings folder.
  • Staff will NOT be able to use the new Personal Capture to edit previous recordings that have two visual inputs (A/D/V or A/V/V).
  • Instead, staff users can publish their previous version's A/D/V or A/V/V personal captures, then edit them through the ESS.