You are on page 1of 24

AVEVA Review 12.

2 Installation Guide

AVEVA Solutions Limited

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 or electronic 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 Review Installation Guide

Revision Sheet

Date

Version

Comments / Remarks Issued Updates incorporated

September 2011 12.1.1 February 2013 12.2

AVEVA Review Installation Guide

AVEVA Review Installation Guide

AVEVA Review Installation Guide

Contents

Page

AVEVA Review 12.2


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1

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


Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:1
Graphics 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 Environment 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

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

12.2

AVEVA Review Installation Guide

How Policies are Evaluated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1 Configure Database Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1

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

A1:ii

12.2

AVEVA Review Installation Guide


Introduction

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"

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

1:1

12.2

AVEVA Review Installation Guide


Introduction

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

1:2

12.2

AVEVA Review Installation Guide


Hardware and Software Configurations

Hardware and Software Configurations


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

2.1

Hardware
Recommended System Requirements (32bit 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 Memory Hard Disk Storage Graphics Card Network Other Intel 32bit architecture - at least 1 GHz. 1 GB minimum, 3 GB highly recommended. 40 GB hard drive with at least 15 GB of available space. A high-specification OpenGL 1.1 compliant graphics card with overlay plane support. TCP/IP Protocol and related components. CD /DVD drive 2-3 button Scroll mouse SpaceNavigator input device Recommended System Requirements (64bit architecture). Operating System(s) Processor Type / Speed Memory Hard Disk Storage Graphics Card Windows 7 64-bit (Professional or Enterprise Edition) Intel 64bit architecture - at least 1 GHz. 2 GB minimum, 8 GB or higher recommended. 40 GB hard drive with at least 15 GB of available space. A high-specification OpenGL 1.1 compliant graphics card with overlay plane support.

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

2:1

12.2

AVEVA Review Installation Guide


Hardware and Software Configurations

Network Other

TCP/IP Protocol and related components. CD /DVD drive 2-3 button Scroll mouse SpaceNavigator input device

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 graphics instead 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. See note below about driver set-up. Multi-screen display features are available only with the nVidia FX3000G Graphics Card. 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:

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

2:2

12.2

AVEVA Review Installation Guide


Hardware and Software Configurations

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 Stereo option being greyed-out.

2.2

Software and Configurations


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 website 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.

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

2:3

12.2

AVEVA Review Installation Guide


Hardware and Software Configurations

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

2:4

12.2

AVEVA Review Installation Guide


How to Install Review

3
3.1

How to Install Review


Review installation from DVD
1. In order to use AVEVA Review and ReviewShare add-in, it is necessary to install Microsoft .Net Framework 4.0. This can be downloaded from the Microsoft web site or installed 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 from the 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 has AutoPlay enabled for the drive, the installation starts automatically. Otherwise, run Start.htm on the disk. To install Review from the network - Click Start > Run on the Windows taskbar and type 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 case AVEVA Review 12.2). Before installing, click product release notes link, as the user may 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 AVEVA Review 12.2 product. 6. Click INSTALL. Then click OK on any confirmation forms that appear. 7. On the File Download form, select Run this program from its current location (Internet Explorer 5.0) or Open (Internet Explorer 5.5 or later) to install the program files directly from 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 installation process. 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. The Installer checks that there is enough space available before it starts, and warns the user if there is not.

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

3:1

12.2

AVEVA Review Installation Guide


How to Install Review

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

10. Select an entry from the list of Detected Installations and then click OK. Alternatively click Browse to select the path to an installation. 11. Click Cancel if the user does not want to use Review with another AVEVA product. Now the user has to set up the AVEVA licensing system before 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 Prompt window, and select Properties by right clicking anywhere in the window title bar. On the Options tab, check QuickEdit Mode for cut and paste using the right mouse button; On the Layout tab, increase the Screen Buffer Size settings (if they are not already larger 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 same title on the resulting Apply Properties 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.

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

3:2

12.2

AVEVA Review Installation Guide


How to Install Review

3.2

Unattended Installation
The user can conduct an unattended installation of Review. Open a command prompt window by clicking Start > Run and 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 review
The user must navigate to the components sub cd components, on the command window type:

cd components
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:

msiexec /i Review12.2.msi /qn /l c:\reviewinstall.log

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

3:3

12.2

AVEVA Review Installation Guide


How to Install Review

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:

msiexec /uninstall review12.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.

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

3:4

12.2

AVEVA Review Installation Guide


How to Use Review

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 have set up, which will set up the remaining environment variables required.

4.1

Setting Additional 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 Window


In a Command Prompt window, run the batch file Review.bat in {installpath} with the appropriate arguments e.g: {installpath}\review -m {installpath}\models\stab.rvm (The user may copy Review.bat elsewhere on the file system, as long as it lies in the PATH, because the installation directory {installpath}\review12.2 is 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: Environment Variable ReviewEXE Review_SCALEMAN Purpose Executable directory Review's Scale Man

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.

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

4:1

12.2

AVEVA Review Installation Guide


How to Use Review

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

4:2

12.2

AVEVA Review Installation Guide


Uninstall and Reinstall

Uninstall and Reinstall


To uninstall AVEVA Review: 1. Click Start on the Windows taskbar and select Settings > Control Panel. 2. Click the Add/Remove Programs icon. 3. Select the Install/Uninstall tab. 4. Select Review from the list displayed and click on the Add/Remove button. This will start Installer to offer the options: Modify, Repair, Remove. Modify allows the user to install additional components. Repair will attempt to correct a damaged installation. Remove will remove the Review installation directory and the shortcuts set up during installation. If files are left behind then they must be deleted by hand. For instance, files or shortcuts not created at installation time cannot be removed by a un-installation. The shortcuts may not be deleted.

To reinstall Review, just rerun the installation procedure.

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

5:1

12.2

AVEVA Review Installation Guide


Uninstall and Reinstall

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

5:2

12.2

AVEVA Review Installation Guide


Configure Review for Network Access

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).

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

6:1

12.2

AVEVA Review Installation Guide


Configure Review for Network Access

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_dir environment variable is set in Review.bat file to point to the network install of Plant/Marine (e.g. \\myserver\Plant\PDMS12.1.SP2 or E3D1.1.0).

set pdms_installed_dir=\\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_dir environment variable is set in the evars.bat file to point to the network path of the project folder (e.g \\ukcamd3594\PDMS12.0.SP5\project).

set projects_dir=\\ukcamd3594\PDMS12.1.SP2\project

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

6:2

12.2

AVEVA Review Installation Guide


Configure Review for Network Access

Important: On the machine that AVEVA Plant has been installed to make sure that the Shared folder has full Read/Write permissions (Full Control).

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

6:3

12.2

AVEVA Review Installation Guide


Configure Review for Network Access

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

6:4

12.2

You might also like