isc:upgrade-reify-onsite
Full name:
com.isomorphic:isc-maven-plugin:1.5.0:upgrade-reify-onsite
Description:
Downloads and unpacks a Reify OnSite distribution and uses it to upgrade the existing Reify OnSite deployment at targetDir
without affecting your settings or data. Note that the current version of this goal only supports the SmartClient version of Reify OnSite. Isomorphic does also provide a version of Reify OnSite packaged as a SmartGWT application, but that is outside the scope of this plugin.
Note that Reify OnSite is NOT a Maven project, This goal upgrades the actual product in the target directory you specify; it does not install files to any Maven cache or repository.
Attributes:
- Executes by direct invocation only.
- The goal is not marked as thread-safe and thus does not support parallel builds.
Required Parameters
| Name | Type | Since | Description |
|---|---|---|---|
<buildNumber> |
String |
1.0.0 |
The Isomorphic version number of the specified com.isomorphic.maven.mojo.AbstractPackagerMojo.product
. e.g., 13.1p, 15.0d. Used to determine both remote and local file locations.User Property: buildNumber |
<targetDir> |
String |
1.5.0 |
Path to an existing installation of Reify OnSite. If the directory does not exist, or does not contain an installation of Reify OnSite, this goal will fail. User Property: targetDir |
Optional Parameters
| Name | Type | Since | Description |
|---|---|---|---|
<buildDate> |
String |
1.0.0 |
The date on which the Isomorphic build was made publicly available at http://www.smartclient.com/builds /, in yyyy-MM-dd format. e.g., 2025-10-13. Used to determine both remote and local file locations. Note that if no value is provided, and com.isomorphic.maven.mojo.AbstractPackagerMojo.skipDownload
is not true, an attempt is made to discover the date of the latest distribution currently published to the Isomorphic build server. Default value is: The date of the most recent distribution (with caveats).User Property: buildDate |
<license> |
License |
1.0.0 |
Technically the license should be "ENTERPRISE", but there is no need to specify it (and indeed it will be ignored if you do). ENTERPRISE is implied for the Reify OnSite goals, so we force it to that setting Default: ENTERPRISEUser Property: license |
<overwrite> |
Boolean |
1.0.0 |
If true, any file previously downloaded / unpacked will be overwritten with this execution. Useful in the case of an interrupted download. Note that this setting has no effect on unzip operations. Default: falseUser Property: overwrite |
<product> |
Product |
1.0.0 |
Technically the product should be "REIFY_ONSITE", but there is no need to specify it (and indeed it will be ignored if you do). REIFY_ONSITE is implied for the Reify OnSite goals, so we force it to that setting Default: REIFY_ONSITEUser Property: product |
<serverId> |
String |
1.0.0 |
The id of a server configuration containing authentication credentials for the smartclient.com website, used to download licensed products. Not strictly necessary for unprotected (LGPL) distributions. Default: smartclient-developerUser Property: serverId |
<skins> |
String |
1.5.0 |
By default, this goal upgrades just the skins it finds installed in the existing installation it is upgrading. If you would like the upgrade to also install additional skins from the downloaded package, name them in this parameter. So, if the existing installation contains skins Enterprise, Stratus and ToolSkin, and you set this parameter like -Dskins=Tahoe,Obsidian, the Reify Online installation will have five upgraded skins after the goal completes: Enterprise, Stratus, ToolSkin, Tahoe and Obsidian.User Property: skins |
<skipDownload> |
Boolean |
1.0.0 |
If true, no attempt is made to download any remote distribution. Files will be loaded instead from a path constructed of the following parts (e.g., C:/downloads/SmartGWT/PowerEdition/4.1d/2013-12-25/zip):
Default: falseUser Property: skipDownload |
<workdir> |
File |
1.0.0 |
The path to some directory that is to be used for storing downloaded files, working copies, and so on. Default: ${java.io.tmpdir}/${project.artifactId}User Property: workdir |
Parameter Details
<buildDate>
The date on which the Isomorphic build was made publicly available at
http://www.smartclient.com/builds /, in yyyy-MM-dd format. e.g., 2025-10-13. Used to determine both remote and local file locations.
Note that if no value is provided, and
Default value is:
Note that if no value is provided, and
com.isomorphic.maven.mojo.AbstractPackagerMojo.skipDownload
is not true, an attempt is made to discover the date of the latest distribution currently published to the Isomorphic build server.
Default value is:
The date of the most recent distribution (with caveats).
- Type:
java.lang.String - Since:
1.0.0 - Required:
No - User Property:
buildDate
<buildNumber>
The Isomorphic version number of the specified
com.isomorphic.maven.mojo.AbstractPackagerMojo.product
. e.g., 13.1p, 15.0d. Used to determine both remote and local file locations.
- Type:
java.lang.String - Since:
1.0.0 - Required:
Yes - User Property:
buildNumber
<license>
Technically the license should be "ENTERPRISE", but there is no need to specify it (and indeed it will be ignored if you do). ENTERPRISE is implied for the Reify OnSite goals, so we force it to that setting
- Type:
com.isomorphic.maven.packaging.License - Since:
1.0.0 - Required:
No - User Property:
license - Default:
ENTERPRISE
<overwrite>
If true, any file previously downloaded / unpacked will be overwritten with this execution. Useful in the case of an interrupted download. Note that this setting has no effect on unzip operations.
- Type:
java.lang.Boolean - Since:
1.0.0 - Required:
No - User Property:
overwrite - Default:
false
<product>
Technically the product should be "REIFY_ONSITE", but there is no need to specify it (and indeed it will be ignored if you do). REIFY_ONSITE is implied for the Reify OnSite goals, so we force it to that setting
- Type:
com.isomorphic.maven.packaging.Product - Since:
1.0.0 - Required:
No - User Property:
product - Default:
REIFY_ONSITE
<serverId>
The id of a
server configuration containing authentication credentials for the smartclient.com website, used to download licensed products.
Not strictly necessary for unprotected (LGPL) distributions.
- Type:
java.lang.String - Since:
1.0.0 - Required:
No - User Property:
serverId - Default:
smartclient-developer
<skins>
By default, this goal upgrades just the skins it finds installed in the existing installation it is upgrading. If you would like the upgrade to also install additional skins from the downloaded package, name them in this parameter. So, if the existing installation contains skins Enterprise, Stratus and ToolSkin, and you set this parameter like
-Dskins=Tahoe,Obsidian, the Reify Online installation will have five upgraded skins after the goal completes: Enterprise, Stratus, ToolSkin, Tahoe and Obsidian.
- Type:
java.lang.String - Since:
1.5.0 - Required:
No - User Property:
skins
<skipDownload>
If true, no attempt is made to download any remote distribution. Files will be loaded instead from a path constructed of the following parts (e.g., C:/downloads/SmartGWT/PowerEdition/4.1d/2013-12-25/zip):
com.isomorphic.maven.mojo.AbstractPackagerMojo.workdircom.isomorphic.maven.mojo.AbstractPackagerMojo.productcom.isomorphic.maven.mojo.AbstractPackagerMojo.licensecom.isomorphic.maven.mojo.AbstractPackagerMojo.buildNumbercom.isomorphic.maven.mojo.AbstractPackagerMojo.buildDate- "zip"
- Type:
java.lang.Boolean - Since:
1.0.0 - Required:
No - User Property:
skipDownload - Default:
false
<targetDir>
Path to an existing installation of Reify OnSite. If the directory does not exist, or does not contain an installation of Reify OnSite, this goal will fail.
- Type:
java.lang.String - Since:
1.5.0 - Required:
Yes - User Property:
targetDir
<workdir>
The path to some directory that is to be used for storing downloaded files, working copies, and so on.
- Type:
java.io.File - Since:
1.0.0 - Required:
No - User Property:
workdir - Default:
${java.io.tmpdir}/${project.artifactId}