review 12.2 install guide

8/12/2019 Review 12.2 Install Guide

1/24

AVEVA Review 12.2

Installation Guide


2/24

Disclaimer

1.1 AVEVA does not warrant that the use of the AVEVA software will be uninterrupted, error-free or free from

viruses.

1.2 AVEVA shall not be liable for: loss of profits; loss of business; depletion of goodwill and/or similar losses; loss of

anticipated savings; loss of goods; loss of contract; loss of use; loss or corruption of data or information; any

special, indirect, consequential or pure economic loss, costs, damages, charges or expenses which may be

suffered by the user, including any loss suffered by the user resulting from the inaccuracy or invalidity of any data

created by the AVEVA software, irrespective of whether such losses are suffered directly or indirectly, or arise in

contract, tort (including negligence) or otherwise.

1.3 AVEVA's total liability in contract, tort (including negligence), or otherwise, arising in connection with the

performance of the AVEVA software shall be limited to 100% of the licence fees paid in the year in which the user's

claim is brought.

1.4 Clauses 1.1 to 1.3 shall apply to the fullest extent permissible at law.

1.5 In the event of any conflict between the above clauses and the analogous clauses in the software licence under

which the AVEVA software was purchased, the clauses in the software licence shall take precedence.

Copyright

Copyright and all other intellectual property rights in this manual and the associated software, and every part of it

(including source code, object code, any data contained in it, the manual and any other documentation supplied

with it) belongs to, or is validly licensed by, AVEVA Solutions Limited or its subsidiaries.

All rights are reserved to AVEVA Solutions Limited and its subsidiaries. The information contained in this document

is commercially sensitive, and shall not be copied, reproduced, stored in a retrieval system, or transmitted without

the prior written permission of AVEVA Solutions Limited. Where such permission is granted, it expressly requires

that this copyright notice, and the above disclaimer, is prominently displayed at the beginning of every copy that is

made.

The manual and associated documentation may not be adapted, reproduced, or copied, in any material orelectronic form, without the prior written permission of AVEVA Solutions Limited. The user may not reverse

engineer, decompile, copy, or adapt the software. Neither the whole, nor part of the software described in this

publication may be incorporated into any third-party software, product, machine, or system without the prior written

permission of AVEVA Solutions Limited, save as permitted by law. Any such unauthorised action is strictly

prohibited, and may give rise to civil liabilities and criminal prosecution.

The AVEVA software described in this guide is to be installed and operated strictly in accordance with the terms

and conditions of the respective software licences, and in accordance with the relevant User Documentation.

Unauthorised or unlicensed use of the software is strictly prohibited.

Copyright 1992 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved. AVEVA shall not

be liable for any breach or infringement of a third party's intellectual property rights where such breach results from

a user's modification of the AVEVA software or associated documentation.

AVEVA Solutions Limited, High Cross, Madingley Road, Cambridge, CB3 0HB, United Kingdom.

Trademark

AVEVA and Tribon are registered trademarks of AVEVA Solutions Limited or its subsidiaries. Unauthorised use of

the AVEVA or Tribon trademarks is strictly forbidden.

AVEVA product/software names are trademarks or registered trademarks of AVEVA Solutions Limited or its

subsidiaries, registered in the UK, Europe and other countries (worldwide).

The copyright, trademark rights, or other intellectual property rights in any other product or software, its name or

logo belongs to its respective owner.

AVEVA Solutions Limited


3/24

Revision Sheet

Date Version Comments / Remarks

September 2011 12.1.1 Issued

February 2013 12.2 Updates incorporated

AVEVA Review Installat ion Guide


4/24



5/24

AVEVA Review Installation Guide

Contents Page

12.2i


Copyright 1992 to current year.AVEVA Solu tio ns L imi ted and its su bsidiar ies.All rig hts reserved.

AVEVA Review 12.2

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1

Document Convent ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1

Hardware and Software Configurations . . . . . . . . . . . . . . . . . . . . . . 2:1

Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:1Graphics Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2

Hardware Dependent Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2

Graphics Card Driver Set-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2

Software and Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:3

Language Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:3

How to Install Review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1

Review installation from DVD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1

Unattended Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:3

AVEVA Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:4

How to Use Review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1

Setting Additional Env ironment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1

Using Review from a Command Prompt Window . . . . . . . . . . . . . . . . . . . . . . . . 4:1

Accessing Remote Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1

Uninstall and Reinstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:1

Configure Review for Network Access . . . . . . . . . . . . . . . . . . . . . . . 6:1


6/24

12.2A1: ii


Copyright 1992 to current year.AVEVA Solu tions Limi ted and its subsi diar ies.All rig hts reserved.

How Polic ies are Evaluated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1

Configure Database Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1


7/24


Introduction

12.21:1 Copyright 1992 to current year.AVEVA Solu tio ns L imi ted and its su bsidiar ies.All rig hts reserved.

1 Introduction

This guide explains how to install and set up AVEVA Review on a workstation running the

Microsoft Windows operating systems.

This guide assumes the user is familiar with the concepts of folder/file hierarchies for storing

data on disks and with basic Windows terminology and commands. If the user is not, it will

also need to refer to the operating system documentation while the user does the

installation.

1.1 Document Conventions

In this document, {installpath} means 'the path name where Review 12.2 is installed'.

So, for example, if the user has installed the copy of Review in C:\AVEVA\Review12.2, then

the sentence:

"As an example, if you want to run Review with the stab.rvm provided in

{installpath}\models"

should be read as

"As an example, if you want to run Review with the stab.rvm provided in

C:\AVEVA\Review12.2\models "


8/24

12.21:2


Introduction



9/24


Hardware and Software Configurations


2 Hardware and Software Configurations

This section describes the PC hardware and software configurations that AVEVA Review

requires.

2.1 HardwareRecommended System Requirements (32bit architecture).

Recommended System Requirements (64bit architecture).

Operating System(s) Windows Windows XP + Service Pack 3

or Windows Server 2003 + Service Pack 2

or Windows 7 (Professional or Enterprise Edition)

Processor Type / Speed Intel 32bit architecture - at least 1 GHz.

Memory 1 GB minimum, 3 GB highly recommended.

Hard Disk Storage 40 GB hard drive with at least 15 GB of available space.

Graphics Card A high-specification OpenGL 1.1 compliant graphics card

with overlay plane support.

Network TCP/IP Protocol and related components.

Other CD /DVD drive

2-3 button Scroll mouse

SpaceNavigator input device

Operating System(s) Windows 7 64-bit (Professional or Enterprise Edition)

Processor Type / Speed Intel 64bit architecture - at least 1 GHz.

Memory 2 GB minimum, 8 GB or higher recommended.

Hard Disk Storage 40 GB hard drive with at least 15 GB of available space.

Graphics Card A high-specification OpenGL 1.1 compliant graphics card

with overlay plane support.


10/24

12.22:2




2.1.1 Graphics Cards

Review uses the OpenGL standard for its 3D graphics. For best results, a high performance

3D graphics card with an overlay plane is strongly recommended. It is also possible to run

with a lower standard of 3D performance on some 2D graphics cards.

Due to the continually and rapidly changing availability of hardware accelerated OpenGL

Graphics Cards, an up to date list of supported graphics cards cannot be included in this

document.

However, the AVEVA Web site includes a current list of both tested and supported graphics

cards available. Please contact the support centre for details.

Other graphics cards that fully support the OpenGL standard should also work, but AVEVA

cannot offer assistance in configuring these. The user may also find some problems, for

example when picking items or using some of the special texturing functionality.

A card with overlay planes is strongly recommended: in this case, Review should be set up

using the menu option:

Tools > Options > Preferences > Feedback Rendering

Tick the check box for Enable Overlay Planes

If overlay planes are not enabled, functions such as locator handles will use XOR graphicsinstead of Overlay Planes, with a loss of performance and quality.

Many graphics cards support dual displays: these should pose no particular problem if set

up in accordance with the manufacturers' instructions.

2.1.2 Hardware Dependent Differences

Stereo graphics are available only with appropriate graphics cards and displays.Stereo images will appear to flicker if the display is not capable of 120 Hz refresh. Seenote below about driver set-up.

Multi-screen display features are available only with the nVidia FX3000G GraphicsCard. The cards should be set up in accordance with the manufacturers' instructions.

2.1.3 Graphics Card Driver Set-up

The latest advice on graphics card driver set-up is also on the AVEVA web-site.

There are particular points to note when running Review, especially with stereo graphics.

The Stereo option requires suitable graphics hardware and correct driver settings, which

vary between manufacturers. It has been designed to work on suitable nVidia graphics

cards and uses Quad Buffering. Some other graphics cards claim to be Stereo compatible

but fail to work correctly with Review. Cards shown on AVEVA's web page as supporting

Stereo have been tested.

For stereo graphics using the nVidia driver, the settings required are:

Network TCP/IP Protocol and related components.

Other CD /DVD drive

2-3 button Scroll mouse

SpaceNavigator input device


11/24




Open GL Settings > Additional Open GL Properties menu.

Enable Stereo on Open GL - use on-board DIN connector

Enable Overlay in Open GL - color indexed overlays (8bpp)

Failure to set these options correctly could result in Stereo graphics failing to work or the

Stereooption being greyed-out.

2.2 Software and Conf igurat ions

Supported Operating System (refer to Hardware).

Microsoft DirectX Version 9C (Runtime) (supplied separately on the DVD).

AVEVA Licensing System

MS Office Professional 2003 or 2007.

Microsoft .NET Framework 4.0.

Adobe Reader 8 or above to view PDF files exported from Review.

Updated versions of the Microsoft components above may become available from time to

time. Review should continue to work with these: please refer to the AVEVA support web-

site for the latest recommendations.

2.3 Language Support

Review can in general support any character set supported by PDMS. By default, PDMS

projects can use any language whose characters are contained within the Latin-1 character

set. However, it can also support other character sets: at the time of writing these are:

Latin-2 Latin-Cyrillic

Far Eastern (Chinese, Japanese & Korean)

PDMS projects need to be set up correctly to work with character sets other than Latin-1.

For details, please refer to the AVEVA Software Installation Guide.

Please note that the PDMS Export function will by default export data for Review in the

correct format only for Latin-1. For other languages, it is necessary to use the command

EXPORT ENCODING UTFEight to set Unicode (UTF-8) encoding. For details, please refer

to the AVEVA DESIGN Reference Manual - Utilities.


12/24

12.22:4





13/24


How to Install Review


3 How to Install Review

3.1 Review instal lation from DVD

1. In order to use AVEVA Review and ReviewShare add-in, it is necessary to installMicrosoft .Net Framework 4.0. This can be downloaded from the Microsoft web site orinstalled from the DVD.

2. In order to generate video output in AVI format or use the space navigator input device,it is necessary to install the DirectX Version 9c Runtime. This can be downloaded fromthe Microsoft web site or installed from the DVD.

3. To install Review from DVD - insert the DVD into the DVD-ROM drive. If the user hasAutoPlay enabled for the drive, the installation starts automatically. Otherwise, runStart.htm on the disk.To install Review from the network - Click Start > Runon the Windows taskbar andtype the path to the Start.htm file on the network.

4. Click on Contents of DVD and select the product that needs to be installed (in this caseAVEVA Review 12.2). Before installing, click product release notes link, as the usermay have to install other programs or change system settings etc.

5. From the "Select a product to review release notes and install" form, select the AVEVAReview 12.2 product.

6. Click INSTALL. Then click OKon any confirmation forms that appear.

7. On the File Download form, select Run this program from its current location (InternetExplorer 5.0) or Open (Internet Explorer 5.5 or later) to install the program files directlyfrom their current location onto the hard disk.Select Yes on the Security Warning query about an Authenticode signature.

8. The Windows Installer application, which will lead the user through the installationprocess.

It is recommended that the user accept the default locations for folder paths. The user must

not use embedded spaces in folder path names.

The process needs at least 250 MB of free disk space for a full installation of all options. TheInstaller checks that there is enough space available before it starts, and warns the user if

there is not.


14/24

12.23:2




9. After the Installer has finished installing the Review files, the user will be prompted tospecify the path to an existing AVEVA Plant or AVEVA Hull & Outfitting application.

10. Select an entry from the list of Detected Installationsand then click OK. Alternatively

click Browseto select the path to an installation.11. Click Cancelif the user does not want to use Review with another AVEVA product.

Now the user has to set up theAVEVA licensing systembefore Review can be used.

To set up the AVEVA licensing system the user needs a Command Prompt window,

preferably with scroll bar and 'cut and paste' enabled:

Open an Command Promptwindow, and select Propertiesby right clicking anywherein the window title bar.

On the Optionstab, check QuickEdit Modefor cut and paste using the right mousebutton;

On the Layouttab, increase the Screen Buffer Sizesettings (if they are not alreadylarger than their 80 x 25 default) to produce scroll bars on the window;

OK the Properties form, then check Save properties for future windows with sametitle on the resultingApply Propert ies form.

The user can choose an AVEVA Plant install that has been shared over the network.

If selecting a shared network folder then the user must first set up Review to use a Code

Access Security Policy (CASPOL). Refer to Configure Review for Network Access.

If the CASPOL has not been set up in Review, the following error will be shown.


15/24




3.2 Unattended Installation

The user can conduct an unattended installation of Review.

Open a command prompt window by clicking Start > Runand type cmd then click OK.

Navigate to the install media, for example type d: at the command prompt to switch to the

disk drive.

Now navigate to the Review folder cd review, on the command window type:

cd r evi ew

The user must navigate to the components sub cd components, on the command window

type:

cd component s

In the components folder the user can make use of the MSI file to conduct an unattended

installation of Review.

To do so the user must utilise the windows MSIEXEC command.

For example to install Review silently with no prompts to the end user the administrator can

use the following command:

msi exec / i Revi ew12. 2. msi / qn / l c: \ r evi ewi nst al l . l og


16/24

12.23:4




The /i parameter instructs MSIEXEC to install Review12.2.msi. The /qn parameterSets user

interface level to No UI.

The /l parameter will write a verbose log to c:\reviewinstall.log

The user can also make use of the MSIEXEC command to conduct other types of

installation maintenance such as uninstalling the application silently:

msi exec / uni nst al l r evi ew12. 2. msi / qn

This will uninstall review while suppressing any user intervention.

3.3 AVEVA Licensing

The user will need to contact AVEVA Solutions Limited supplying information about the

machine on which the user wants to use Review. AVEVA will send back a license file, which

the user will edit and install.

Please now read the AVEVA Licensing System, provided in the Review manual set by using

the Adobe Reader.


17/24


How to Use Review


4 How to Use Review

Each user of Review has to configure some aspects of the Windows interface prior to using

Review.

Set Windows parameters.

Make sure the License Manager Daemon is running. Set environment variables relating to AVEVA Licensing System.

The user can then run Review by clicking on any Review shortcuts or icons it may haveset up, which will set up the remaining environment variables required.

4.1 Setting Addit ional Environment Variables

Before running Review the user needs to set an environment variable to allow the user to

use the product, refer to AVEVA Licensing System for further information.

4.2 Using Review from a Command Prompt WindowIn a Command Prompt window, run the batch file Review.bat in {installpath} with the

appropriate arguments e.g:

{installpath}\review -m {ins tallpath}\models\stab.rvm

(The user may copy Review.batelsewhere on the file system, as long as it lies in the PATH,

because the installation directory {installpath}\review12.2is stored inside Review.bat).

Review.bat sets up all the environment variables needed by the Review program. It does

this by calling {installpath}\review_evars.bat, which sets up the following environment

variables:

4.3 Accessing Remote Data

Review can access remote data through ODBC using AVEVA's QUERY product. The user

must install QUERY after installing Review in order to make use of this functionality.

Environment Variable Purpose

ReviewEXE Executable directory

Review_SCALEMAN Review's Scale Man


18/24


19/24


Uninstall and Reinstall


5 Uninstall and Reinstall

To uninstall AVEVA Review:

1. Click Starton the Windows taskbar and select Settings > Contro l Panel.

2. Click theAdd/Remove Programs icon.

3. Select the Install/Uninstalltab.

4. Select Review from the list displayed and click on theAdd/Removebutton. This willstart Installer to offer the options: Modify, Repair, Remove.

Modifyallows the user to install additional components.

Repairwill attempt to correct a damaged installation.

Removewill remove the Review installation directory and the shortcuts set up duringinstallation. If files are left behind then they must be deleted by hand. For instance, filesor shortcuts not created at installation time cannot be removed by a un-installation. Theshortcuts may not be deleted.

To reinstall Review, just rerun the installation procedure.


20/24

12.25:2


Uninstall and Reinstall



21/24


Configure Review for Network Access


6 Configure Review for Network Access

Applications that run across a local network require the proper permission to do so and as

such authorisation must be added on the client machine to grant such permission.

Note: Changing security policies requires administrative privileges on the machine being

configured.

6.1 How Policies are Evaluated

.NET assemblies may be digitally signed with a key which can be used to evaluate its

authenticity and discover its point of origin (e.g. AVEVA).

AVEVA Review makes use of this signing and comprises of two keys:

AVEVA (Component is produced by AVEVA)

Infragistics (A third party suite of rich UI controls used by Review)

Using these keys, security policies can be added to authorise any assembly signed with a

particular key to have unrestricted access to local resources (network, disk, etc.).

This means that no matter where the product is installed, as long as it is correctly signed it

will be authorised to run across the network.

6.2 Configure Database Access

1. Run Review Database Configuration and select the network installation of Plant/Marine(e.g. \\myserver\Plant\PDMS12.1.SP2 or E3D1.1.0).


22/24

12.26:2




.

Open the Review.bat file in a text editor such as Notepad. The Review.bat file is located in

the following folder C:\AVEVA\Review{version}. Where {version} is the version of Review

that has been installed.

2. Make sure that the pdms_installed_direnvironment variable is set in Review.bat file topoint to the network install of Plant/Marine (e.g. \\myserver\Plant\PDMS12.1.SP2 orE3D1.1.0).

set pdms_ i nst al l ed_di r =\ \ myserver \ PDMS12. 1. SP2

3. Insert the following line in the Review.bat file directly below the previously edited line.

set PDMSWK=%TEMP%

Open the evars.bat file located on the machine that AVEVA Plant has been installed to using

a text editor such as Notepad.

4. Make sure that the projects_direnvironment variable is set in the evars.bat file to pointto the network path of the project folder (e.g \\ukcamd3594\PDMS12.0.SP5\project).

set pr oj ect s_di r =\ \ ukcamd3594\ PDMS12. 1. SP2\ pr oj ect


23/24




Important: On the machine that AVEVA Plant has been installed to make sure that the

Shared folder has full Read/Write permissions (Full Control).


24/24



review 12.2 install guide

Documents