CAST Extend local server includes a text based configuration file that can be used to change some advanced configuration settings that are not exposed in the Administration Center (see Manage CAST Extend local server via Administration Center). This text file is located in the following folder and should exist after starting up the server:
- An identically named file is located in
%PROGRAMFILES%\CAST\Extend- this file should only be used in ≤ 1.3.0-funcrel. If you are using ≥ 2.0.0-funcrel and you make changes to the file in
%PROGRAMFILES%\CAST\Extend,those changes will be ignored.
- When you have made your changes in this file, save the file and then restart CAST Extend local server to ensure the changes are taken into account.
The synchronize action is performed automatically every two hours, Monday to Friday. If you would like to change this schedule (for example to include weekends or to reduce the frequency),to do so, locate the
"SYNC_INTERVAL" entry in the
config.proxy.json file. This governs this automatic schedule - NULL is the default schedule, equal to a synchronization every two hours, Monday - Friday:iI
This option will accept cron tab syntax within quote marks, for example:
- CAST does not recommend scheduling a synchronization at a more regular frequency than every two hours.
- CAST does not usually perform manifest changes at weekends therefore there is no need to schedule synchronization on Saturdays and Sundays.
- If an extension release is required immediately, please use the manual Synchronization button in the Administration Center.
When using CAST Extend local server and CAST Console, some information is sent to CAST (typically anonymous statistical data - see Administration Center - Settings - Allow CAST to collect anonymous statistical data automatically). If you want to block this data at CAST Extend local server level you can do so by using the following section:
|ANALYSIS_REPORT||Set this option to |
You should leave the setting
Extension icon synchronization
When extensions are displayed in the CAST Console interface, ordinarily an icon will be used to distinguish the extension:
These icons are stored in:
- GitHub for Product extensions
- other third-party systems for User Community/Lab extensions
If your environment is heavily firewalled and you do not want to allow CAST Extend local server to fetch these icons from these third party locations, you can configure CAST Extend local server to not download them at all. Use the following section:
|ICONS: SKIP_DOWNLOAD||Set this option to |
This option allows you to prevent the download of an icon for a specific extension ID. It should be used only when
Extension synchronization blacklisting
If you want to blacklist the synchronization of a specific extension entirely (i.e. so it is never downloaded), you can do so using the
SYNCHRONIZATION: EXTENSIONS section at the bottom of the example below:
It can be used as follows:
Synchronization failure retry
In case of a failure during the synchronization process, the following section configures the retry period:
|COUNT||The number of times the synchronization will be attempted after an initial failure.|
|INTERVAL||The time delay (in seconds) between each retry.|
Host name update
If the hostname of the server hosting the CAST Extend Local Service is changed, then you should update the
"PUBLIC_URL" entry to match the new hostname of the server hosting the service:
In addition, you will need to update the CAST Extend URL option with the new hostname, as configured in CAST Console, see Administration Center - Settings - CAST Extend: