Command Line Installation of Classroom Capture and Personal Capture Windows
On this page: ShowHide
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.
- Create a configuration file to use for all of the classroom installations.
- 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.
- Download the installer.
- Run the installation command.
- Note the MAC address and location of each PC on which CCAP is installed.
- Attach the cameras and/or microphones to be used as capture input devices.
- Assign the CCAP devices to rooms.
- 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:
- The command line must identify the Personal Capture for Windows executable.
- The configuration file will identify different installation and data directory names than for Classroom Capture. The defaults are shown in the below instructions.
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:
- Add the line UninstallPreviousVersions=true to the configuration file. This removes the existing version before proceeding with the new version installation.
- Add the option –UninstallPreviousVersions true to the command line you execute to launch installation.
- Perform separate command line uninstallation by running the following command:
<installation directory>\Uninstall_Echo360ClassroomCapture.exe --mode unattended.
This option can be performed for any version of Classroom Capture.
BEFORE REMOVING THE PROGRAM, perform the following steps
- 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.
- If necessary, back up any Classroom Capture log files resident on the classroom PC.
All log files are removed on uninstallation.
- 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:
- prefix - This is the directory to which the program is installed. The directory shown in each example below is the default directory used by the installation wizard. You can identify any location you want.
- pre - This is the directory to which the software data files are written. It should be a volume with at least 20 GB of space. The directory shown in each example below is the default directory used by the installation wizard. You can identify any location you want.
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:
An example configuration file for Personal Capture installation:
prefix=c:\Program Files\Echo360\Personal Capture
Run the command line installation
The installation procedure provided below assumes the following:
- The directories identified in the configuration file can be created on the target PC.
- You know and can include the fully qualified path to the configuration file.
To install CCAP via command line:
- Create and save a configuration file as described above.
- Log into the target classroom PC as a user with administrator rights.
- Log into Echo360 as an administrator.
- Download the installation executable from the Downloads page (Settings > Downloads). Be sure to note the location of the saved executable.
- Open a DOS command window. (Start Menu > Run > type cmd)
- Navigate to the directory where the installation executable was saved.
- 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
- Press Enter to execute the command.
- When the installer is finished, close the DOS window.
- 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