Crestron Information Gathering Tool
Last modified by Alexander Mott on 2025/10/30 17:24
The Crestron Information Gathering Tool is a valuable standalone piece of software that allows for easily recording current job-site status, such as online devices, their serial numbers, and their firmware versions. It is good practice to run this tool at the end of project start-up in order to document the project status.
In the event that a Crestron processor or ShowRunnerCLC™ installation behaves unexpectedly, Chief Integrations may ask for detailed logs from the Crestron Information Gathering Tool in order to analyze any issues and report them to Crestron if appropriate.
Steps
- Download and install the Crestron Information Gathering Tool
- The tool is available to download from the Resources tab on the SW-INFOTOOL Product Page
- Alternatively, the tool can be downloaded and installed through the Crestron MasterInstaller by running the MasterInstaller and selecting the "Information Gathering Tool" option
- Connect to the lighting network via Ethernet cable
- Ensure that the connecting computer's Ethernet settings are set to Static and the IPv4 address does not conflict with any devices already on the network
- Open Crestron Information Gathering Tool
- If gathering information for only one device:
- Input the IP address and login credentials for the device
- If no login credentials are necessary, leave username and password at default
- Select the desired output folder for the results
- Default location is "C:\Users\YourName\Documents\Crestron\InformationTool\Results"
- Select the appropriate Command List using the dropdown menu or use a custom command list by clicking "Select" and locating the command list file
- Ensure the PLOGs box is checked if collecting information for a processor (it should be checked by default)
- Press the Start button. It may take a couple of minutes for all the commands to finish running
- Input the IP address and login credentials for the device
- If gathering information for multiple devices:
- Click the "Batch Mode" button at the top of the window to open the Batch Mode window
- At the top of window, use the Devices > Autodiscover drop down menu to automatically add all discovered devices
- If not all devices are discovered (e.g. if there are devices that are only reachable through a router), then devices can be added from an Address Book
- If you do not already have an Address Book for the job, use Device Discovery Tool to perform a Local Search and generate an Address Book
- Then, use Device Discovery to perform a Remote Search and export the results to the same Address Book
- Alternatively, directly edit the Address Book .xadr file in a text editor to manually add any missing devices
- In the Batch Mode window, use the Devices > Import... drop down menu and locate the Address Book .xadr file to import the devices
- Press the "Model Name" column heading to sort devices by model
- For each model of device:
- Input the device credentials or leave the default values if authentication is not enabled for the device
- If the device is a ZUMNET-JBOX or ZUMNET-DIN, make sure the "PLOGs" box is unchecked and the "Connect Type" is set to CTP
- Select the appropriate Command List by clicking the "..." button in the Command List column, clicking "Select", and then locating the Command List file
- Right click anywhere on the device row and select "Copy to Same Model Devices" to apply these settings to all devices with the same model
- Be sure to update the credentials if different credentials were used for different, same-model devices
- Check the box in the "Enable" column to include it when gathering information
- Multiple devices can be enabled at once by ctrl+click, shift+click, or ctrl+A selecting multiple devices and then clicking "Enable Selected" from the right-click menu
- Once all desired devices are selected, press "Start Selected" in the lower right to begin collecting information on those devices
- Once the tool is finished running the commands, double check that no devices failed due to correctable issues (e.g. incorrect credentials) and re-run the tool for those devices if the issues are resolved
- If you have an Internet connection:
- Open the Uploader window by clicking the "Uploader" button at the top of the window
- Ensure all files are selected with a checkbox in the "Enable" column
- Check the "I agree to the Uploader Terms of Service" boxd
- Press "Send to Uploader"
- Share the URL in the "Your download link:" field with Chief Integrations or Crestron support for analysis
- If you do not have an internet connection:
- Navigate to the output folder in File Explorer
- Select all files and add to a .zip file using a tool such as 7-Zip
- Send this .zip file to Chief Integrations or Crestron support for analysis