Command Line Installation of Classroom Capture and Personal Capture Windows

On this page: Hide

Workflow

Command line installation for Personal Capture Windows

Remove CCAP and reinstall via command line

Create the configuration file

Run the command line installation

Troubleshooting the installation

Classroom Capture (CCAP) and Personal Capture (PCAP) for Windows allows for command line installation of the software on the target Windows PC. Classroom Capture and Personal Capture Windows are supported on Windows 7, Windows 8.1, or Windows 10. Classroom Capture requires Microsoft .NET 4.6.1, though Personal Capture Windows still supports .NET 3.5.

A configuration file provides the installation parameters, and the same configuration file can be used for all installations of the same product (either Classroom Capture or Personal Capture).

For Classroom Capture installations, you will need to note the MAC address of each PC on which it is installed. You can typically find the MAC address printed on a label on the PC, or you can launch CCAP after installation and open the Settings page. The MAC address is shown in the Serial Number field of the CCAP Settings page.

Previous Versions MUST be Removed First: If you are using a previous version of Classroom Capture, you must include a parameter to remove the old version before installing the new version.

Workflow

  1. Create a configuration file to use for all of the classroom installations.
  2. Identify the classroom computers where you want to install Classroom Capture, and verify they are running either Windows 7, Windows 8.1, or Windows 10, and have Microsoft .NET 4.6.1 installed.
  3. Download the installer.
  4. Run the installation command.
  5. Note the MAC address and location of each PC on which CCAP is installed.
  6. Attach the cameras and/or microphones to be used as capture input devices.
  7. Assign the CCAP devices to rooms.
  8. Configure each Room, selecting which devices to use for each type of input (audio, display, primary and secondary video).

Command line installation for Personal Capture Windows

The instructions provided here are specific to installing CCAP, but can also be used for command line installations of Personal Capture for Windows. The only differences are:

Remove CCAP and reinstall via command line

If Classroom Capture is not performing correctly and Customer Support has suggested you perform a fresh installation, uninstall the existing instance and restart the PC before re-installing. To do this via the command line rather than the UI, you have the following options:

BEFORE REMOVING THE PROGRAM, perform the following steps

  1. Be sure all captures have been published to the server, OR be sure to back up any captures currently resident on the PC. All content is removed on uninstallation.
  2. If necessary, back up any Classroom Capture log files resident on the classroom PC.
    All log files are removed on uninstallation.
  3. If removing the program separately from the installation, it is recommended that you reboot the PC. You can then use the instructions on this page to perform a command line installation of Classroom Capture.

Create the configuration file

The configuration file contains the same information you would normally enter via the installation wizard, and includes the following parameters:

Create the configuration file and save it. You can name the file anything you want; the instructions on this page assume the name of the configuration file is config.txt.

You can use the same configuration file for multiple installations of each software application.

An example configuration file for Classroom Capture installation:

prefix=c:\Program Files\Echo360

pre=c:\ProgramData\Echo360\Client

An example configuration file for Personal Capture installation:

prefix=c:\Program Files\Echo360\Personal Capture

pre=c:\ProgramData\Echo360\Personal Capture

Run the command line installation

The installation procedure provided below assumes the following:

To install CCAP via command line:

  1. Create and save a configuration file as described above.
  2. Log into the target classroom PC as a user with administrator rights.
  3. Log into Echo360 as an administrator.
  4. Download the installation executable from the Downloads page (Settings > Downloads). Be sure to note the location of the saved executable.
  5. Open a DOS command window. (Start Menu > Run > type cmd)
  6. Navigate to the directory where the installation executable was saved.
  7. Enter the following command, including the fully qualified path to the configuration file. The example command shown below assumes the configuration file is saved at the root of a USB drive recognized as the F: drive by the target PC. Replace F:\ with the appropriate directory/path.

    Echo360ClassroomCaptureForWindows.exe --mode unattended --optionfile F:\config.txt
  8. Press Enter to execute the command.
  9. When the installer is finished, close the DOS window.
  10. Note the MAC address of the PC. If necessary, launch Classroom Capture and open the Settings page; the MAC address appears in the Serial Number field.

For CCAP installations, you can now assign the device to a room and schedule the room for captures.

NOTE: If you are using these instructions to install Personal Capture for Windows, the executable file called by the command line is: Echo360PersonalCaptureForWindows.exe

Troubleshooting the installation

If you have problems with the installation, you can turn on a higher level of error messaging by adding the "–debuglevel 4" option in the installation command. This is the most "verbose" debug level and should provide you with sufficient information. Enter the command as follows:  

Echo360ClassroomCaptureForWindows.exe --debuglevel 4 --mode unattended --optionfile F:\config.txt