|Summary: this page describes how to install the standalone CAST Report Generator.|
You can obtain the Report Generator from ExtendNG. Search for "report generator" and choose the Report Generator option:
An exe setup installer file named com.castsoftware.aip.reportgenerator.<version>.exe will be downloaded and can be run by double clicking. Please proceed as described in Installation steps.
You can obtain the CAST Report Generator from the CAST Product Center - this requires a CAST login. A ZIP file will be downloaded - unpack this ZIP file to find the exe setup installer called ReportGeneratorSetup.exe and proceed as described in Installation steps.
To install and use the CAST Report Generator, the following is required:
The CAST Report Generator can be installed on the following Operating Systems:
|Operating System||Supported||Supported by reference||Notes|
|Microsoft Windows 7 SP1 64-bit|
|Microsoft Windows 8 64-bit|
|Microsoft Windows 8.1 64-bit|
|Microsoft Windows 10 64-bit|
|Microsoft Windows Server 2008 R2 SP1 64-bit (Standard edition)|
|Microsoft Windows Server 2012 64-bit (Standard edition)|
|Microsoft Windows Server 2012 R2 64-bit (Standard edition)|
|Microsoft Windows Server 2016||Windows Server 2016 is only supported by CAST when installed in Desktop Experience mode (i.e. with a GUI).|
|Note that the CAST Report Generator is a 32-bit application, and will therefore also install on the equivalent 32-bit versions of the Operating Systems listed above.|
The CAST Report Generator can be configured to work the following combination of CAST RestAPI/CAST Dashboard Services:
|CAST RestAPI version||Dashboard Service version||Report Generator ≥ 1.4.x||Report Generator 1.3.0|
|≥ 1.6.x (standalone)||≥ 7.0.9|
CAST Report Generator requires the following .NET framework to be present on the target machine. If the required .NET framework is not found by the installation setup, you will be prompted to choose whether you want the installer to download/install it as part of the installation process.
|Report Generator version||NET framework|
|1.3.x - 1.4.x||4.0|
CAST Report Generator requires the .NET Core SDK to function correctly:
|Report Generator release||Minimum .NET Core SDK release required||Download||Notes|
≥ 1.15.x: The setup installer will offer to download and install this for you.
1.14.x: This should be installed manually BEFORE or AFTER running the Report Generator setup installer (the setup installer will not install this for you).
This should be installed manually BEFORE or AFTER running the Report Generator setup installer (the setup installer will not install this for you).
Future releases of CAST Report Generator will require .NET Core 3.1.x due to the end-of-life of .NET Core 3.0.x scheduled for 3rd March 2020, therefore CAST recommends installing .NET Core 3.1.x to avoid the need to re-install .NET Core in the future.
|≤ 1.12.0||NOT REQUIRED||-||-|
The SDK can be downloaded as an installer - choose the version that matches your Windows environment:
Click to enlarge
The CAST Report Generator has been "decoupled" from the CAST AIP setup so that it is now entirely "standalone". If you already have previous legacy releases (≤ 1.2.0) of the CAST Report Generator installed on the target workstation originating from the CAST AIP setup, then you can install a standalone release of the CAST Report Generator (≥ 1.3.0) at the same time and the two can co-exist without issue:
Below is a screenshot of the Programs and Features section of the Windows Control Panel displaying two installed versions of the CAST Report Generator, one from the CAST AIP setup (1.2.0) and one as standalone (1.3.0):
Standalone releases of the CAST Report Generator (≥ 1.3.0) are all separate releases and can co-exist on the same machine without issue, i.e. you can have any combination of releases installed at the same time, for example: 1.3.0 and 1.4.0, or 1.3.0, 1.4.0 and 1.4.1:
Before beginning the installation process, please ensure that you have carried out all of the following tasks and that the following requirements have been met:
Ensure that your user login on the target workstation has local "Administrator" privileges.
Make sure that the target workstation can access any necessary network resources (such as the machine hosting the CAST AIP war)
Double click the com.castsoftware.aip.reportgenerator.<version>.exe or ReportGeneratorSetup.exe setup installer. The installation process will then being. Accept the license agreement, then click Next to continue:
The following information is then displayed about the requirement to install Microsoft .NET Core SDK, then click Next to continue:
Choose a location for the CAST Report Generator and click Next to continue - the setup will propose:
Choose a location to store the Template Documents and click Next to continue - the setup will propose: %PROGRAMDATA%\CAST\ReportGenerator\<version>. See Templates below for more information.
Choose the name for the Windows Start Menu folder and click Next to continue - the setup will propose: CAST Report Generator <version>
Choose any additional tasks you want the setup to perform and click Next to continue:
A summary of the proposed installation will then be displayed. Click Install to proceed with the installation:
On completion, CAST Report Generator will be ready for use. The setup will then offer:
If you choose to install the Microsoft .NET Core SDK (≥ 1.15.x only), a command window will open and the SDK will be downloaded. You need to tap ENTER on your keyboard to allow the installation to proceed:
The SDK installer will then launch, click Install to proceed:
The SDK installation will then proceed:
The installation process is now complete.