30日間の無料評価版をお試しいただけます。

概要

Yellowfinパッチインストーラーのすべてのテキスト、およびイメージは、メインのインストーラーと同様に、カスタムプロパティファイル、またはコマンドライン引数を使用してカスタマイズすることができます。オプションはすべて、Yellowfinインストールの構成ファイルから読み取られるため、パッチインストーラーには多くのオプションが必要ありません。



パッチインストーラーでは、Yellowfinインストールディレクトリを指定する、特殊なコマンドライン引数をひとつサポートします。これは、カスタムプロパティファイル内のプロパティとしてはサポートされません。

引数

installdir

Yellowfinインストールディレクトリ

ヒント:サイレントインストールの更新が失敗した場合、アップグレードログにエラーが書き込まれます。

使用可能なプロパティ

こちらは、カスタムのプロパティファイル経由、またはコマンドライン引数として、パッチインストーラーで設定できるすべてのプロパティの一覧です。



# text translations

# application name
installer.appname=Yellowfin
installer.productname=${installer.appname} Patch

installer.warn.guionheadless=Headless environment detected, but graphical installer requested.\nIf installation fails, try running the command-line installer.
installer.error=Error
installer.errortitle=Installation Error
installer.errormsg=An error occurred during installation:
installer.installing=Installing
installer.install.complete=${installer.productname} Installation Complete
installer.install.failed=${installer.productname} Installation Failed
installer.quit.title=Are you sure you want to quit?
installer.quit.msg=This will cancel the installation.
installer.title.msg=${installer.productname}
installer.footer.msg=(Yellowfin Pty Ltd (c) - http://www.yellowfinbi.com/)

installer.button.yes=Yes
installer.button.no=No
installer.button.browse=Browse...
installer.button.cancel=Cancel
installer.button.previous=Previous
installer.button.next=Next
installer.button.quit=Quit

# general text for the various installer panels
installer.infopanel.info=Please read the following information:
installer.licencepanel.info=This software product is subject to a licence agreement.
installer.licencepanel.accept=I accept the terms of this licence agreement.
installer.licencepanel.notaccept=I do not accept the terms of this licence agreement.
installer.targetpanel.intro=This patch updates ${installer.appname} to version 6.1.\n\nBefore continuing, please:\n -  Shut down ${installer.appname}.\n -  Backup your ${installer.appname} database.\n\nPlease select the directory where ${installer.appname} is installed.
installer.targetpanel.doesnt.exist=The selected directory does not exist.
installer.targetpanel.notvalid=The selected directory does not appear to be a ${installer.appname} directory.
installer.targetpanel.prompt=Select the installation directory: 
installer.targetpanel.notspecified=Install path not specified
installer.targetpanel.prompt.cmd=Enter the installation directory:
installer.backuppanel.intro=Please select a directory to store backup archives:
installer.backuppanel.doesnt.exist=The selected directory does not exist.
installer.processpanel.title=Installing Update
installer.processpanel.finished=Finished
installer.finishpanel.successful=Installation has completed successfully.
installer.dbpanel.dbtype.empty=Please select the Database Type.
installer.dbpanel.url.empty=Please enter the JDBC URL.
installer.dbpanel.password.nomatch=Passwords do not match.
installer.dbpanel.title=${installer.appname} Database Details
installer.dbpanel.info=Please enter the connection details for the ${installer.appname} configuration database.
installer.dbpanel.dbtypelabel=Database Type:
installer.dbpanel.urllabel=JDBC URL:
installer.dbpanel.usernamelabel=Username:
installer.dbpanel.passwordlabel=Password:
installer.dbpanel.confirmpasswordlabel=Confirm Password:
installer.dbpanel.validate.title=Validate Connection Details
installer.dbpanel.validate.msg=Do you wish to validate the connection details entered?\nThe installer will attempt to connect to the database using the information entered.
installer.dbpanel.conntest.error=Error testing connection:
installer.dbpanel.conntest.success=Connection was successful.
installer.dbpanel.conntest.driver=Unable to load the JDBC Driver:
installer.dbpanel.conntest.conn=Unable to connect:

installer.dbpanel.as400=AS/400 DB2
installer.dbpanel.cachedb=CacheDB
installer.dbpanel.db2=DB2
installer.dbpanel.ingres=Ingres
installer.dbpanel.mysql=MySQL
installer.dbpanel.oracle=Oracle
installer.dbpanel.postgresql=PostgreSQL
installer.dbpanel.progress=Progress
installer.dbpanel.sqlserver=SQL Server / MSDE
installer.dbpanel.sybasease=Sybase ASE
installer.dbpanel.sybaseasa=Sybase SQL Anywhere / IQ
installer.stylepanel.title=Style Updates
installer.stylepanel.info=The ${installer.appname} 6.1 update will apply updated stylesheets and images.\nIf your installation has modified styles, you will need to re-apply them after running this patch.

installer.process.backupdb=Backing up database
installer.process.backupwebapp=Backing up webapp
installer.process.compactdb=Compacting database
installer.process.extractfile=Extracting
installer.process.extractupdate=Extracting update
installer.process.runqueries=Running SQL Queries
installer.process.updateconfigdata=Updating configuration data
installer.process.updatelibs=Updating libraries
installer.process.convertcontent=Converting Report Content
installer.process.shutdowndb=Closing database
installer.process.updatecss=Updating stylesheet
installer.process.updateimages=Extracting new images
installer.process.updatestyle=Updating styles
installer.process.updaterefdata=Updating reference data
installer.process.updateschema=Updating ${installer.appname} Schema
installer.process.upgradetutorial=Upgrading tutorial database
installer.process.copyingfiles=Copying files

# text used in the command-line installer
installer.cmd.dbonly.intro=This patch upgrades a ${installer.appname} database for use with ${installer.appname} 6.1. Only the database will be upgraded. The application update must be applied separately.
installer.cmd.dbtype.prompt=Database type?
installer.cmd.invalidselection=Invalid selection
installer.cmd.applynewstyles.prompt=Apply new styles?
installer.cmd.applynewstyles.info=The updated styles and images will be applied to your installation. Any modifications you have made may be overwritten.
installer.cmd.manualstyles.info=Your current style will be preserved. Styles required for new functionality will be appended to existing stylesheets.

# installation validation messages
installer.buildversion.too.low=This patch upgrades ${installer.appname} from version 3.3 or later to 6.1. Your ${installer.appname} installation is at version {0}.
installer.buildversion.too.high=This patch upgrades ${installer.appname} from version 3.3 or later to 6.1. Your ${installer.appname} installation is at version {0} and does not require this patch.
installer.builddate.too.low=You need to update to a more recent version of ${installer.appname} before applying this patch.
installer.builddate.too.high=Your ${installer.appname} installation does not require this patch.
installer.not.fullversion=Only full version ${installer.appname} installations can be patched.
installer.schemaversion.too.low=You need to update to a more recent version of ${installer.appname} before applying this patch.
installer.schemaversion.too.high=Your ${installer.appname} installation does not require this patch.
# resource locations
resource.infopanel.html=resources/index.html

resource.lhs.infopanel.img=resources/border1.png
resource.lhs.licencepanel.img=resources/border3.png
resource.lhs.targetpanel.img=resources/border5.png
resource.lhs.backuppanel.img=resources/border5.png
resource.lhs.stylepanel.img=resources/border5.png
resource.lhs.processpanel.img=resources/border6.png
resource.lhs.finishpanel.img=resources/border8.png

これらのプロパティは、インストーラーの動作を変更します。

# don't show the style update panel
action.hidestylepanel=true


より詳細な情報は、以下の項目を参照してください。


特定のコンポーネントの更新

サイレントアップデーターを使用することで、Yellowfinの特定のコンポーネントであるファイルシステムやリポジトリデータベース、またはその両者を更新することができます。

例えば、データベースを更新する場合は、以下のようになります。

java -jar update.jar -silent "YFPath" option.upgrade=database

option.upgrade」の部分で、更新するコンポーネントを指定します。Yellowfinのファイルシステムを更新する場合は、「filesystem」をキーワードに使用します。

これには、データベースを指すように、Yellowfinファイルパスを指定しなくてはいけません。この情報はファイルシステム(特に、web.xmlファイル)から取得されるため、この方法はファイルシステムに依存します。

独立したコンポーネントの更新

以下の例は、Yellowfinコンポーネントを独立して更新する方法を示しています。これはつまり、データベース更新時にファイルパスの指定が不要なことを意味します。



条件1:データベースのみを独立して更新する場合は、「jdbcUser」、「jdbcPassword」、「jdbcURL」といった追加のパラメーターを渡す必要があります。以下の例で指定されているjdbcURLは、アップデーターにデータベースのタイプを伝えています。

例:

java -jar yellowfin-20180402-update.jar -silent option.upgrade=database jdbcUser=yellowfin jdbcPassword=password jdbcURL=jdbc:mysql://localhost:3306/yellowfin_74_master
  • option.upgrade:リポジトリデータベースを更新する場合は、これを「database」に設定し、Yellowfinのファイルを更新する場合は「filesystem」に設定します。例:option.upgrade=database
  • jdbcUser:Yellowfinリポジトリデータベースに接続するユーザー名です(ファイルシステムの更新時には要求されません)。
  • jdbcPassword:上記ユーザーのパスワードです(暗号化してはいけません)。
  • jdbcURL:JDBC接続URLです。システムに、データベースのタイプや名前、サーバURLや接続ポートといった詳細を伝えます(ヒント:こちらの情報が不明な場合は、Yellowfinのインストールフォルダーから、「web.xml」ファイルを取得することで、手作業で情報を抽出することができます)。



条件2:異なるドライバーclassを使用する場合や、jdbcURLがアップデーターに認識されない時には、追加でjdbcDriverパラメーターを渡さなくてはいけません。

例:

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
  • jdbcDriver:JDBCドライバーの標準class名を指定します。



条件3:データベース接続時に異なるドライバーを使用する場合や、独自のjarファイルを提供する場合は、使用するドライバーと合わせて、追加のパラメーターも渡さなくてはいけません。アップロードしたデータベースに属するドライバーが、Yellowfinにサポートされていることを確認してください。「java -jar」classパスは使用できないことに注意してください。

例:

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:33




グラフおよびシステム構成のデフォルト設定

Yellowfin 9は、グラフおよびレポートの色、フォント、スタイル、余白、その他の視覚的書式にデフォルト設定をもちます。これらの設定は、さらなるカスタマイズをすることなく、グラフやレポートのデフォルトルックアンドフィールに影響を与えることができます。これらの設定は、アップグレード時に有効にすることができます。詳細は、以下を参照してください。

  • システム構成レベルのデフォルト設定:これらは、レポートおよびグラフの色、フォント、スタイルのデフォルト設定です。システム管理者は、管理コンソールのコンテンツ設定から、これらを手動でアップデートできます。
  • グラフのデフォルト設定:これらは、グラフビルダーで設定するグラフ書式のデフォルト設定です。これには、グラフの軸、凡例、並べかえ、余白、その他視覚的要素が含まれます。



サイレントインストーラーオプション

次のオプションは、サイレントインストーラーを使用してアップグレードする場合に、これらの設定に使用できます。


設定オプション説明
システム構成レベルのデフォルト設定option.migrate9Configuration

Yellowfin 9で導入された、システム構成レベルで制御される、新しいグラフおよびレポート書式のデフォルト設定を適用します。これらは、レポートおよびグラフの色、フォント、スタイルのデフォルト設定です。システム構成の新しいデフォルト設定を適用するには、こちらのオプションをTrueに設定します。このオプションを設定しない場合、デフォルトではfalseになります。

グラフのデフォルト設定option.migrate9ChartDefaults

Yellowfin 9で導入された、グラフビルダーで設定するグラフ書式のデフォルト設定です、これには、グラフの軸、凡例、並べかえ、余白、その他視覚的要素が含まれます。すべてのグラフに新しいグラフ書式のデフォルト設定を適用するには、こちらのオプションをTrueに設定します。このオプションを設定しない場合、デフォルトではfalseになります。



コマンドラインオプション

コマンドラインインストーラーでは、それぞれのオプションに「Y / N」で応答します、詳細は、以下のサンプルをご確認ください。