(Click to open topic with navigation)

You are here: 1 – Setup > 1.2 Viewpoint installation and setup > Upgrade implications

Upgrade implications

The 7.2.10 version of Viewpoint has been enhanced to create an easier setup and maintenance experience. Because the Viewpoint internal structure has been modified, there is no upgrade path from Viewpoint 7.1.x—only a clean installation of version 7.2.10. However, there are some upgrade implications that you should be aware of.

Upgrade process

To upgrade to Viewpoint7.2.10

  1. Back up and remove the contents of the $VIEWPOINT_HOME directory. This will allow the new files to be created when you start Tomcat with the new 7.2.10Viewpoint.
  2. Once you have removed the old contents of the $VIEWPOINT_HOME directory, simply install the new 7.2.10moab.war file and start it up. For more information, see Installing Viewpoint.
  3. Viewpoint no longer depends on MySQL™ or Oracle® databases that have been used in previous versions. Viewpoint now uses a new embedded database called "h2." Database files are automatically created within your $VIEWPOINT_HOME directory under data/h2/. This database holds only the current configuration from the Viewpoint Configuration page.

    4. In previous versions of Viewpoint, user information was stored in the Viewpoint MySQL or Oracle database. Now users and groups are stored in LDAP. You will need to move users and groups over to OpenLDAP™ or Microsoft Active Directory®. For more information, see Setting up OpenLDAP on CentOS 6.

    Once you have installed and setup Viewpoint7.2.10, you can remove or keep a backup of the previous database.

    The MySQL or Oracle database you used for previous versions of Viewpoint is not the same as the MySQL database you use for Moab. Do not remove the Moab database.

  4. Permissions and roles (previously stored in core.xml) are now stored in MWS. Use the "Role Management" page in Viewpoint to create as many roles (groups of permissions) as you need (for details, see About role management). Then use the "Principal Management" page to assign the permission roles to your LDAP users and organizational units (for details, see About principal management).
  5. You no longer configure your MWS connection in the ViewpointConfig.groovy file. When you upgrade, go to the Viewpoint Configuration page and set up your MWS connection configuration. For more information, see Setting the MWS configuration. (This configuration will then be stored in the h2 database.)
  6. The Moab connection configuration—now only needed if you intend to use Moab Accounting Manager quoting in Viewpoint—is no longer stored in core.xml. When you upgrade, go to the Viewpoint Configuration page and set up your Moab connection configuration. For more information, see Setting the Moab connection (for quoting). (This configuration will then be stored in the h2 database.)

For information about using the Viewpoint Configuration page, see About configuration.

New and updated files with 7.2.10 release

This list includes some new files that are included with the 7.2.10 release and also describes some changes that have been made to existing files.

File Description
navigation.xml New navigation configuration file. For more information, see Customizing navigation components.
homepage.xml New configuration file for Homepage gadgets. For more information, see Configuring Homepage gadgets.
reporting.xml

Configuration for report permissions has been updated.

Reporting is an Adaptive Computing Professional Services-enabled feature only.
DataviewConfig.groovy New configuration file for Viewpoint dataview pages. For more information, see Customizing Viewpoint with the DataviewConfig.groovy file.
ViewpointConfig.groovy Updated so that MWS configuration has been removed and billing section has changed. For more information, see Configuring Viewpoint for quoting.
log4j.groovy New configuration file for specifying what to show in the viewpoint.log file. For more information, see Customizing logging.
data/h2 directory New h2 embedded database for Viewpoint. Contains encrypted files used to store Viewpoint configuration information.

Files removed in 7.2.10 release

The following files have been removed from Viewpoint with the 7.2.10 release:

File Description
core.xml Previously stored Moab connection, permissions, roles, etc.
help.xml Previously provided custom help links to configure or setup aspects of Viewpoint.
hibernate.cfg.xml Previously the database configuration file for MySQL or Oracle database. (Deprecated with the addition of the h2 database.)
jobs.xml Previously used for the GWT page that has been replaced.
nodes.xml Previously used for the GWT page that has been replaced.
vcs.xml Previously used for the GWT page that has been replaced.
reservations.xml Previously used for the GWT page that has been replaced.
vpcs.xml Previously used for the GWT page that has been replaced.
market.properties Previously used for GWT pages that have been replaced.

Related topics 

© 2015 Adaptive Computing