Page History
Anchor | ||||
---|---|---|---|---|
|
Overview
Styleclass | ||
---|---|---|
| ||
All text and images in the Yellowfin patch installer are customisable in the same way as the main installer, using a custom properties file, or by command-line arguments. The patch installer does not require many options, as these are all read from the Yellowfin installation’s configuration files.
The patch installer supports one special command-line argument, to specify the Yellowfin installation directory. This is not supported as a property in the custom properties file:
Argument | Value |
---|---|
| The Yellowfin Installation Directory |
Tip: If a silent installation update is unsuccessful, you will be able to find errors written into the upgrade log.
Available Properties
Styleclass | ||
---|---|---|
| ||
This is a list of all properties that can be set in the Patch Installer via the custom properties file or as command-line arguments.
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
These properties change the behaviour of the installer.
See below for further information. |
Anchor | ||||
---|---|---|---|---|
|
Updating a Specific Component
You can use the Silent updater to upgrade a specific component of Yellowfin, that is the filesystem or the configuration database, or both.
For instance, upgrading the database:
java -jar update.jar -silent "YFPath" option.upgrade=database
Where, option.upgrade specifies the component to be upgraded. You can use the keyword ‘filesystem’ to update the Yellowfin file system.
This requires specifying the Yellowfin file path to point to the database. Since this information is extracted from the file system (specifically the web.xml file), this method is dependent on the file system.
Independent component upgrade
The following examples demonstrate how to independently update a Yellowfin component. This means when upgrading the database, you will not need to specify the file path.
Condition 1: Independent upgrade of only the database. Requires passing additional parameters, such as jdbcUser, jdbcPassword and jdbcURL. The jdbcURL specified here will let the updater know the database type.
Example:
java -jar yellowfin-20180402-update.jar -silent option.upgrade=database jdbcUser=yellowfin jdbcPassword=password jdbcURL=jdbc:mysql://localhost:3306/yellowfin_74_master
Where,
option.upgrade - set this to the keyword ‘database’ to update the configuration database, or ‘filesystem’ to update Yellowfin files. For example, option.update=database.
jdbcUser - username to connect to the Yellowfin configuration database (not required when updating the file system.)
jdbcPassword - the password to the above (should not be encrypted)
jdbcURL - the JDBC connection URL. Lets the system know specific database details, such as its type and name, server URL, connection port. (Tip: if you do not know this, you can manually retrieve this from the web.xml file from your Yellowfin folder.)
Condition 2: If you want to use a different driver class, or if the jdbcURL is not recognised by the updater, then an additional jdbcDriver parameter must be passed.
For example,
java -jar yellowfin-20180402-update.jar -silent option.upgrade=database jdbcUser=yellowfin jdbcPassword=password jdbcURL=jdbc:mysql://localhost:3306/yellowfin_74_master jdbcDriver=com.mysql.jdbc.Driver
where,
jdbcDriver - specifies the canonical class name for the JDBC Driver.
Condition 3: You want to use a different driver to connect to the database, or provide your own jar file. This requires passing the driver to be used, in conjunction with the other parameters. Ensure that the driver you upload belongs to a database supported by Yellowfin. Note that you will not be able to use the java -jar classpath.
Example:
java -cp mysql-connector-java-5.1.25-bin.jar:yellowfin-20180402-update.jar com.hof.patch.PatchInstaller -silent option.upgrade=database jdbcUser=yellowfin jdbcPassword=password jdbcURL=jdbc:mysql://localhost:3306/yellowfin_74_master jdbcDriver=com.mysql.jdbc.Driver
horizontalrule |
---|
Styleclass | ||
---|---|---|
| ||