How to upgrade LiveView Web in a StreamBase 10 Live Datamart project

How to upgrade LiveView Web in a StreamBase 10 Live Datamart project

book

Article ID: KB0083607

calendar_today

Updated On:

Products Versions
TIBCO Streaming 10
TIBCO LiveView Web 1.3 and later

Description

StreamBase 10.1 includes the LiveView Web product (Rights to use in Production are determined by your purchase and sales agreement). The version of LiveView Web will be what was current at the time of the StreamBase release, but LiveView Web is also updated independently of StreamBase and you may wish to upgrade it to a newer release within an older StreamBase installation.

 If you wish to revert to an older version of LVWeb after trying the newer version, before upgrading make a complete back-up of your project, including the lv-systemdata/ folder.

Newer versions of LVWeb will read all page and card configuration created by older versions of LVWeb. The newer version of LVWeb will upgrade page and card storage formats, so it will not be possible to revert to an older version of LVWeb after a newer version has accessed the configuration.

Issue/Introduction

Add the lvweb.war to your Maven repository and update the project dependency.

Resolution

Follow these steps to upgrade LVWeb:

1). Download LiveView Web from TIBCO's software distribution service (https://edelivery.tibco.com). Install it as required by your OS.

Note that if you do not see LiveView Web offered after logging into eDelivery, then you may not have licensed it and will need to discuss this with your TIBCO Account Representative.

2). Use the Maven install command to install the new lvweb.war file in your local repository. Use the same instructions as for an external JAR file found in the StreamBase Help documentation here:
  TIBCO StreamBase Documentation > Getting Started > Using External JAR Files

The command-line will look like this (example, line breaks added for clarity):
mvn install:install-file 
  -Dfile="fully-qualified-path-to-new/lvweb.war"
  -DgroupId=com.tibco.ep
  -DartifactId=lvweb
  -Dversion=1.3.0
  -Dpackaging=war
  -DgeneratePom=true
Note that this step requires running the mvn command from the command-line. For instructions how to obtain the mvn command, see Help page: 
  TIBCO StreamBase Documentation > Installation Guide > Installing Command Line Maven

3). Rebuild your local repository's index according to the Help page:
  TIBCO StreamBase Documentation > Getting Started > Using External JAR Files
under heading Rebuild the Repository Index.

4). From the project POM editor, on the Dependencies tab, remove any existing dependency to lvweb.war.

5). Using project context menu: Maven > Add Dependency, in the dialog search for "lvweb". You should now see both the older version and your newly installed version. You may alternatively add the dependency from the Dependencies tab in the POM editor.

6). Select the new version of lvweb.war (version 1.3.0 in the example above).

7). Run the project and confirm that lvweb is functioning. If not, then one additional step is necessary: Copy the lvweb.war into the project's src/main/liveview/lv-user-webapps/ folder (you may need to create this folder if it is not present) and if the .war file has been renamed, change its name back to lvweb.war.

When run, the project will now be using the new LVWeb version.