Prime Radiant Release 2020.8.0
Downloads:
- Prime Radiant Full App 2020.8.3
- Prime Radiant Upgrade 2020.8.3
- NSF classic 2020.8.0
- NSF classic no longer contains Prime Radiant
- Expanders Options Zip
- Unpack in
C:\primeradiant\config\data
and run Import User Data
- Unpack in
New Packaging
Starting with version 2020.8.0, Prime Radiant is no longer packaged alongside the classic NSF base. Instead, it exists as a separate application that manages your existing and new NsfBases (NSF directories).
- See Prime Radiant Directory Structure for
C:\primeradiant
structure description. - See NsfBase for
C:\NSF
(nsfBase) directory structure description.
Upgrade
NOTE: 2020.8.x upgrades can only be applied to 2020.8.x+ versions. NOTE: It is not possible to upgrade 2020.7.x or older – see First Installation instead
- Download Prime Radiant Upgrade zip (see links above)
- Unpack the zip somewhere
- Stop Prime Radiant (if running)
- Ensure you don’t have any console/explorer open on directory
C:\primeradiant\dist
or any directory inside (due to Windows locking) - Run (either by double-clicking or from command line)
upgrade.bat
from the downloaded zip - Update Prime Base – see instructions for First Installation
First Installation
NOTE: Prime Radiant 2020.8.0 is not compatible with previous versions. However, it is installed in a different directory, therefore you can keep using your older Prime Radiant in case of any issues.
(Optional) If you don’t have an existing NSF base, download NSF classic (see links above) and unpack it to
C:\NSF
- Download Prime Radiant Full App zip (see links above)
- Unpack the zip to
C:\primeradiant
- you can place the installation directory anywhere; if you choose to do so, modify the next steps accordingly
- Open
C:\primeradiant\config\custom_vars.bat
- Here you can adjust java and maven that will be used by Prime Radiant
- By default it uses system-wide configuration of
JAVA_HOME
, andmvn
available inPATH
. This is the recommended setup. - If you want to use the ones from your NSF directory, uncomment the preconfigured examples and modify as needed
- Adjust the rest of configuration to your liking
- (Optional) Open
C:\primeradiant\config\nsfBases.xml
- Add or modify Nsf Bases to your liking. You can have multiple Nsf Bases, e.g. one for workspace, several for deployment, etc. See NsfBases for more info.
- Run
C:\primeradiant\PrimeRadiant.bat
If you have an existing NsfBase, add the following file C:\NSF\primespace\expansionsPR\expandBase.xml
<expandBase name="Expansions 3.0 - PR">
<baseRoot>expansionsPR</baseRoot>
<useAppId value="false"/>
<description>-</description>
</expandBase>
- Open Prime Radiant in your browser http://localhost:9000/primeRadiant/
- (Optional) If you customized
PRIME_RADIANT_BASE_PORT
incustom_vars.bat
, adjust the url accordingly
- (Optional) If you customized
- Log in
- Navigate to Upgrade page (accessible from Dashboard, or from menu Configuration | PrimeBase, http://localhost:9000/primeRadiant/elements/primeBase/all)
- Select the available PrimeBase and sequentially click all buttons from left to right
- For more information on the individual actions, see PrimeBase.
- Navigate to NsfBase (menu Configuration | NsfBase, http://localhost:9000/primeRadiant/elements/nsfBase/all)
- Here you see all NsfBases configured in
C:\primeradiant\config\nsfBases.xml
, and additionallydist
(Prime Radiant’s internal distribution base).
- Here you see all NsfBases configured in
- Click on Synchronize All
- Synchronize (All) scan NsfBase(s) and looks for all existing sourceBases (projects), expandBases (expansions), and deployBases (servers)
- Prime Radiant console window also lists all found entries
- Rerun this action when you add/remove new entries, such as cloning a new project to your workspace
Your Prime Radiant is now ready.
Major Changes And Fixes
Fixes and Changes:
- Prime Radiant is no longer internally coupled to the NSF directory or its infrastructure
- Fixed expanding with non-semver versions of expanders (e.g. 4.0.8.1 or 4.1.1.1)
- Fixed some edge-cases when (clean) importing (DataFlowTasks, ApplicationDeployments, component dependency order)
- Default expansion directory is now
<applicationInstance.name>/<application.shortName>
(e.g.bookingApp_experimental/bookingApp
)- this addresses issue with clean import changing applicationInstance ids (so e.g.
bookingApp-id20/bookingApp
changed tobookingApp-id50/bookingApp
after import) - the legacy style (
<applicationInstance.shortName>/<application.shortName>
) can be temporarily enabled, however it will be removed completely in a future release
- this addresses issue with clean import changing applicationInstance ids (so e.g.
- Expanding/harvesting/etc. now runs directly on files in your sourceBase (workspace)
- doesn’t eliminate ghost changes (e.g. dataElement removed from disk, but not from PR), but makes it more obvious (because git now sees a new/changed file)
- to export model before expansion, Expand Applications page now has a separate button
- this is a step in direction of having files disk and data in PR be in sync at all times
- For projects using legacy expansion (<4.4.0 expanders / not using PROVIDED), expanderVersion is now automatically created on import if it doesn’t exist
- Fixed some edge cases breaking expansion for <4.4.0 expanders
- oldest tested is
v4.0.8.1
, but in principle we support any4.x
version (and if it doesn’t work, it should be reported as a bug, even for old expanders)
- oldest tested is
Additions and Changes:
- Prime Radiant location, port, infrastructure, etc. can be trivially customized by users
- Upgrades automatically backup previous version of Prime Radiant AND it’s database (so revert should be trivial)
- Added Synchronization of NsfBases to easily manage your projects, expansions, and deployments on disk
- Users can now easily import user data files (custom
fieldOptionTypes
,technologies
, etc.)- future version will support import from jars (to ease usage of additional expanders / expansion resources)
- UI of Expand Applications is now more compact and provides a better overview of the selected instance
- You can select which expansionSettings you want to use for expansion/harvesting/…
- If no expansionSettings are defined, you can create them directly from the Expand Applications page
- All actions now run on model in your workspace, to export data from Prime Radiant, run Export first
- Reorganized menu (note that all dataElement pages are still available and accessible via url)
Expansion Page
The expansion page has been modified to work better with expansionSettings and be more consistent with expanding from disk (cli).
Known Issues
1. Missing Option Types
If you are using rest-expanders or damage-expanders, you are most likely missing various option types.
- Download the Expanders Options Zip (see downloads on top of the page)
- Unpack it to
C:\primeradiant\config\data
- Import User Data in Prime Radiant in PrimeBase page