Installation Guide Version 11.5 Windows 2000 and Windows XP pdms1151/man1/doc1 issue 010403 PLEASE NOTE: AVEVA Solutions has a policy of continuing product development: therefore, the information contained in this document may be subject to change without notice. AVEVA SOLUTIONS MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS DOCUMENT, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. While every effort has been made to verify the accuracy of this document, AVEVA Solutions shall not be liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance or use of this material. This manual provides documentation relating to products to which you may not have access or which may not be licensed to you. For further information on which Products are licensed to you please refer to your licence conditions. Copyright 1991 through 2003 AVEVA Solutions Limited All rights reserved. No part of this document may be reproduced, stored in a retrieval system or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without prior written permission of AVEVA Solutions. The software programs described in this document are confidential information and proprietary products of AVEVA Solutions or its licensors. For details of AVEVA's worldwide sales and support offices, see our website at http://www.aveva.com AVEVA Ltd, High Cross, Madingley Road, Cambridge CB3 0HB, UK Contents 1 Introduction.................................................................................................... 1-1 1.1 2 Contents of this Guide ........................................................................ 1-1 Hardware and Software Requirements........................................................ 2-1 2.1 2.2 Hardware............................................................................................. 2-1 2.1.1 Graphics Cards ...................................................................... 2-1 Software and Configuration ............................................................... 2-2 3 Installing PDMS ............................................................................................. 3-1 3.1 3.2 3.3 3.4 Basic Installation ................................................................................ 3-1 Uninstalling and Reinstalling ............................................................ 3-2 FLEXMAN License Manager ............................................................. 3-2 Remote Installation............................................................................. 3-2 4 Setting Up the Windows Environment......................................................... 4-1 4.1 4.2 4.3 4.4 4.5 4.6 4.7 Windows Control Panel ...................................................................... 4-1 Graphics Board Settings..................................................................... 4-2 Setting the License File Location....................................................... 4-2 PDMS Environment Variables ........................................................... 4-3 Running PDMS from a Command Prompt Window.......................... 4-5 Customising PDMS Start-Up ............................................................. 4-5 Plotting ................................................................................................ 4-7 5 Language Support......................................................................................... 5-1 5.1 Preparing Windows to Use Supported Languages ............................ 5-2 5.1.1 Windows 2000........................................................................ 5-2 5.1.2 Windows XP ........................................................................... 5-2 Preparing PDMS to Use Latin-1, Latin-2 or Latin-Cyrillic Languages ............................................................................................................. 5-3 Preparing PDMS to Use a Far Eastern Language ............................ 5-3 5.2 5.3 6 Running PDMS under Windows ................................................................... 6-1 6.1 6.2 6.3 Spaces in Windows pathnames .......................................................... 6-1 Linking to Microsoft Excel.................................................................. 6-1 Windows Parameters .......................................................................... 6-2 VANTAGE PDMS Installation Guide Version 11.5 contents-i Contents 7 PDMS Projects............................................................................................... 7-1 7.1 The Sample Project............................................................................. 7-1 7.1.1 Copying Project SAM to Your User Area ............................. 7-1 7.1.2 Users and Teams in the Sample Project .............................. 7-2 7.1.3 MDBs in the Sample Project ................................................ 7-2 Creating PDMS Projects .................................................................... 7-3 7.2.1 The Sample Project and Your Own Projects ........................ 7-4 7.2 8 Installing AutoDRAFT ................................................................................... 8-1 8.1 8.2 8.3 8.4 Compatibility ...................................................................................... 8-1 The AutoDRAFT Software ................................................................. 8-1 Configuring AutoDRAFT with AutoCAD .......................................... 8-2 Installing and Configuring AutoCAD ................................................ 8-2 8.4.1 AutoCAD R2000i ................................................................... 8-3 8.4.2 AutoCAD R2002 .................................................................... 8-3 Getting Started with AutoCAD.......................................................... 8-4 Application Macros for Use with PDMS DRAFT .............................. 8-4 8.5 8.6 9 10 Upgrading Projects to Version 11.5............................................................. 9-1 Troubleshooting...........................................................................................10-1 10.1 10.2 10.3 10.4 10.5 General...............................................................................................10-1 License Manager Errors ....................................................................10-1 Entering PDMS .................................................................................10-2 Starting Appware in DESIGN/DRAFT/ISODRAFT/ PARAGON/SPOOLER/ADMIN.........................................................10-3 Problems with Graphics ....................................................................10-3 contents-ii VANTAGE PDMS Installation Guide Version 11.5 1 Introduction This guide explains how to install and set up PDMS Version 11.5 on a workstation running the Microsoft Windows 2000 or Windows XP operating system (hereafter referred to jointly as 'Windows'). Local Administrator rights are required to perform the installation. This guide assumes you are familiar with the concepts of folder/file hierarchies for storing data on disks and with basic Windows terminology and commands. If you are not, you may also need to refer to your operating system documentation while you carry out the installation. The guide also assumes that you have already gained access to the PDMS installation files via a CD, from the AVEVA Web site, or by some other route. 1.1 Contents of this Guide Hardware and software requirements are described in Chapter 2. For completely up-to-date information, please see the AVEVA Website at http://www.aveva.com/engineeringit and refer to the Customer Support Hardware pages. The Web pages also give hints on ways of setting up and running PDMS on different computers in order to achieve the most efficient performance. Chapter 3, Installing PDMS, describes how to install PDMS 11.5 and license the software. Chapter 4, Setting Up the Windows Environment, explains how to configure the Windows operating system before you run PDMS. Chapter 5, Language Support, describes how to set up the Windows Environment to use PDMS with different Language options. Chapter 6, Running PDMS under Windows, gives some advice on using PDMS in a Windows environment. Chapter 7, PDMS Projects, describes the sample project that is supplied as part of PDMS, and how to set up your own projects. Chapter 8, Installing AutoDRAFT, describes how to install and configure PDMS AutoDRAFT. VANTAGE PDMS Installation Guide Version 11.5 1-1 Introduction Chapter 9, Upgrading Projects to Version 11.5, describes how to upgrade your existing PDMS 11.3 or 11.3SP1 projects for use with PDMS 11.5. No upgrade process is required to use PDMS 11.4 projects with PDMS 11.5. Chapter 10, Troubleshooting, describes some of the errors that you could encounter when running PDMS. 1-2 VANTAGE PDMS Installation Guide Version 11.5 2 Hardware and Software Requirements This section describes the hardware and software configurations that PDMS requires to run under Windows. 2.1 • • • Hardware The following list gives a minimum specification for your computer. Processor Memory Hard disk Intel Pentium family, or equivalent. 128MB minimum; 256MB recommended. At least 670MB free space for a full installation; more free space is recommended to allow for projects etc. See below. CD-ROM will be used for media distribution. Three-button mouse strongly recommended. • • • Graphics Card CD drive Mouse 2.1.1 Graphics Cards PDMS uses standard OpenGL for its 3D graphics. Due to the continuously and rapidly changing list of hardware accelerated OpenGL graphics cards commercially available, an up-todate list of supported graphics cards cannot be included in this document. However, the AVEVA Web pages (http://www.aveva.com/engineeringit) contain a current list of both tested and supported graphics cards. Other graphics cards which fully support the OpenGL standard should also work, but AVEVA cannot offer assistance in configuring these. You may also find some problems, for example, when picking items in PDMS. VANTAGE PDMS Installation Guide Version 11.5 2-1 Hardware and Software Requirements 2.2 Software and Configuration The following software should be installed and configured on your computer to enable PDMS 11.5 to run. • PDMS 11.5 is fully supported under: • • Windows 2000 with Service Pack 2 Windows XP Professional • • Note that Windows 2000 and Windows XP Service Packs and Hot Fixes from Microsoft are required for PDMS to run effectively. Please refer to the AVEVA Support web site, or contact the AVEVA Support team for details of the latest recommended Windows 2000 and Windows XP environment for PDMS. PDMS 11.5 databases must be on an NTFS File System: FATC partitions are not supported. The license manager must have a drive called C: available for writing temporary information. In the case of double boot machines, where D: is the system disk for Windows XP/2000 and C: is used for an earlier version of Windows, the license manager will still work, since it does not require NTFS. Optionally, you can have Microsoft Excel installed for outputting reports. • 2-2 VANTAGE PDMS Installation Guide Version 11.5 3 3.1 Installing PDMS Basic Installation Local Administrator rights are normally required to install PDMS. 1. To install PDMS from CD – Insert the CD into your CD-ROM drive. If you have AutoPlay enabled for the drive, the installation starts automatically. Otherwise, run Start.htm on the CD. If you are installing PDMS from the network – Click Start>Run on the Windows taskbar and type the path to the Start.htm file on your network. Click on CD CONTENTS and select the product which you want to install (in this case PDMS Version 11.5), then click INSTALL. Click OK on any confirmation forms which appear. On the File Download form, select Run this program from its current location (IE 5.0) or Open (IE 5.5 later) to install the program files directly from their current location onto your hard disk. Select Yes on the Security Warning query about an Authenticode signature. This starts the InstallShield® Wizard, which will lead you through the rest of the installation process. 2. 3. 4. During the installation sequence, follow the on-screen instructions as they appear. You will be given a choice between two levels of installation: • Full installation: Installs all available product components (recommended for a new installation unless there are good reasons for restricting the options available to end users). • Custom installation: Presents you with a list of all available product components from which you can select those to be installed. It is recommended that you use the default settings for folder paths etc. unless you have good reasons for doing otherwise. You must not use embedded spaces in folder path names. The process needs at least 670MB of free disk space for a full installation of all options. InstallShield checks that there is enough space available before it starts, and warns you if there is not. VANTAGE PDMS Installation Guide Version 11.5 3-1 Installing PDMS When the process is complete, select Start>Programs/Aveva/VANTAGE PDMS 11.5 to reach the Run PDMS, Make PDMS project and PDMS manuals options. 3.2 Uninstalling and Reinstalling If InstallShield detects an existing PDMS installation, it will display the options for modifying/repairing/removing the files rather than simply offering the standard installation options. To remove installed components from your hard disk, or to add additional components to an existing installation, select Start>Settings>Control Panel and use the Add/Remove Programs tool. As an alternative procedure, repeat Steps 1 to 4 of the installation sequence detailed above. The InstallShield® Wizard will detect your existing installation and will give you the following options: • Modify: Displays the same list of options as the Custom installation. Select new components to be added and/or deselect any currently installed components to be removed. • • Repair: Reinstalls all currently installed components (to correct any corrupted files etc.). Remove: Removes all currently installed components. 3.3 FLEXMAN License Manager You must install and set up the FLEXMAN license system before PDMS can be used. See the FLEXMAN Installation Guide. 3.4 Remote Installation If you wish to have one server installation of PDMS accessed from remote workstations, you must ensure that the Windows system DLLs on each remote workstation are upgraded to a suitable version for running the PDMS 11.5 application programs. You can achieve this by installing PDMS 11.5 itself in minimal form; that is, select the Custom Installation type and then deselect everything except 'PDMS Core Components'. 3-2 VANTAGE PDMS Installation Guide Version 11.5 Installing PDMS In addition, this release includes a stand-alone 'Thin Client' installer which can be used on individual workstations to update the necessary Windows system DLLs, and which also provides start menu shortcuts to the main PDMS installation. The Thin Client installer is a self-extracting Installshield® executable which is held in the C:\AVEVA\PDMS11.5\thin_client_installer\ subfolder. It is applicable when the main PDMS 11.5 product is installed either from the 'Full Installation' option, or the 'Custom Installation' option with the 'Thin Client Installer' component selected. VANTAGE PDMS Installation Guide Version 11.5 3-3 Installing PDMS 3-4 VANTAGE PDMS Installation Guide Version 11.5 4 Setting Up the Windows Environment This chapter describes how to configure the Windows operating system before you run PDMS. Following installation of PDMS, you should perform the following steps: • • • • Check the settings for your graphics board: See Section 4.2. Ensure the FLEXMAN License Manager daemon is running, and set environment variables relating to FLEXMAN: See Section 4.3. Configure Windows parameters for PDMS: see Section 4.4. You can then run PDMS by clicking on the PDMS shortcut or icon, which will set up the remaining environment variables required. Note: In the following instructions it is assumed that PDMS 11.5 has been installed in folder C:\AVEVA. If it has been installed elsewhere, substitute C:\AVEVA with the name of the installation folder. 4.1 Windows Control Panel The Windows Control Panel contains tools that are used to change the way Windows looks and behaves. This Install Guide describes how to use Control Panel tools to configure Windows to run PDMS. Open the Control Panel as follows: Windows 2000 Click Start, point to Settings, and then click Control Panel Windows XP If your computer is set up with the Classic Start menu, click Start, point to Settings, and then click Control Panel. If your computer is set up with the standard Start menu, click Start and then click Control Panel. VANTAGE PDMS Installation Guide Version 11.5 4-1 Setting Up the Windows Environment 4.2 Graphics Board Settings You should set your display to a resolution of at least 1024 x 768 and the colour depth to True colour or 16.7 million colours. This can be set by opening the Control Panel. Select Display and select the Settings tab. Make the appropriate selections on the form for your graphics card. Due to the rapidly changing list of hardware accelerated OpenGL graphics cards commercially available, an up-to-date list of supported graphics cards, graphics device drivers and recommended device driver configuration cannot be included in this document. However, the AVEVA Support Web pages (http://www.aveva.com/engineeringit) contain a current list of both tested and supported graphics cards, along with advice on configuration of graphics device drivers. 4.3 Setting the License File Location Before you can use PDMS, you must set up the FLEXMAN license system and connect to the FLEXMAN License Manager daemon (see the FLEXMAN Installation Guide),. Each User needs to set a license path that defines the location of the license file or service. For earlier versions of FLEXMAN, setting the environment variable LM_LICENSE_FILE did this. However, this applied to all software using FLEXlm. You can now set CADCENTRE_LICENSE_FILE instead that applies only to software using our Vendor License Manager Daemon. To avoid users having to repeatedly set such an environment variable, FLEXlm itself now remembers the current setting in the Windows Registry. This Registry setting will initially come from the value of the corresponding environment variable, but cannot then be modified by changing the environment variable – you must use the FLEXlm utility lmtools or the new command-line lmpath to query or set the license path. The environment variable can be set in one of three ways, either in the PDMS entry script, as a User Environment Variable in the Control Panel or manually in a command window. To set manually or in the PDMS entry script, type the following in a command window or in the entry script before starting PDMS: set CADCENTRE_LICENSE_FILE=Port@Computername 4-2 VANTAGE PDMS Installation Guide Version 11.5 Setting Up the Windows Environment To set automatically: Windows 2000 and Windows XP • • • • Open the Control Panel. Select System, and pick the Advanced tab Click on the Environment Variables button Set the CADCENTRE_LICENSE_FILE user environment variable to the location of the license obtained from AVEVA (Port@Computername). For example: CADCENTRE_LICENSE_FILE 744@licserv To confirm the licence environment variable setting, open a command window and type the command SET. You should see a list of environment variables, including: CADCENTRE_LICENSE_FILE=Port@Computername or to check the Registry setting, type lmpath –status You should see an output including the following: lmpath - Copyright (C) 1989-2002 Globetrotter Software, Inc. Known Vendors: cadcentre: ... 744@licserv 4.4 PDMS Environment Variables PDMS uses Windows Environment variables to locate folders containing PDMS system files and users project data. This allows you to locate these folders anywhere on the file system. The default location for PDMS system files is C:\AVEVA\PDMS11.5, but the location of the pdms11.5 folder can be changed if desired when PDMS is installed. PDMS is supplied with a file evars.bat in the PDMS executables folder (C:\AVEVA\pdms11.5) which sets default values for the environment variables so that they point to the folder structure as installed. It also sets the PATH variable to include the PDMSEXE folder containing PDMS executables. VANTAGE PDMS Installation Guide Version 11.5 4-3 Setting Up the Windows Environment You may need to modify this file to reflect the folder structure of your own installation. The following is a list of the variables you may need to reset, with a brief description of each one and the default setting. Note that all environment variables must be UPPERCASE. It is recommended that users should not write to the pdms11.5 installation folder or any of its contents: PDMS System Environment Variables The following environment variables refer to the location of PDMS system files. PDMSEXE PDMSEXEMAIN Executable folder C:\AVEVA\pdms11.5 Copy of PDMSEXE, but can be a search path C:\AVEVA\pdms11.5 CADCENTRE_LICENSE_FILE License file See section 4.3, Setting the License File Location PDMSUI PMLLIB PDMSDFLTS PDMSPLOTS PLOTCADC PDMSHELPDIR Application User Interface folder (PML 1) C:\AVEVA\pdms11.5\pdmsui Application User Interface folder (PML 2) C:\AVEVA\pdms11.5\pmllib Applications defaults folder C:\AVEVA\pdms11.5\pdmsui\dflts Applications PLOTS folder C:\AVEVA\pdms11.5\pdmsui\plots Pointer to the PLOT executable. C:\AVEVA\pdms11.5\plot\plot.exe Online help data files. C:\AVEVA\pdms11.5\onlinehelp PDMS User Environment Variables The following environment variables refer to the location of users PDMS folders. Users must have write permission to these folders. PDMSWK PDMSUSER Temporary PDMS work file folder C:\temp Application Users save/restore setup area (or the users 'home' folder) C:\AVEVA\pdms11.5\pdmsuser PDMS Applicationware Report Input and Output folder. C:\AVEVA\pdms11.5\pdmsui\reports PDMSREPDIR 4-4 VANTAGE PDMS Installation Guide Version 11.5 Setting Up the Windows Environment PDMSDFLTS ‘C:\USERDFLTS C:\AVEVA\pdms11.5\pdmsui\dflts’ Applications defaults folder. Note that individual users may not have permission to change PDMS System defaults in C:\AVEVA\pdms11.5\pdmsui\dflts, but they should have their own local defaults area. This is achieved by setting a PDMSDFLTS search path, e.g. Project Environment Variables For each PDMS project, four more environment variables must be set. For example, for a project ABC: ABC000 ABCISO ABCMAC ABCPIC Project database folder Project ISODRAFT options folder Project inter-DB connection macro folder Project DRAFT picture file folder PDMS is installed with sample project data (See Chapter 7 PDMS Projects). PDMS Project Environment variables for these projects are set in evars.bat. 4.5 Running PDMS from a Command Prompt Window You can run PDMS from a Command Prompt window rather than using the Start/Programs menu. To do this you must set your PATH variable to include the folder where PDMS is installed. Windows 2000 and Windows XP • • • • Open the Control Panel. Select System, and pick the Advanced tab. Click on the Environment Variables button. Edit the system variable Path to add the PDMS folder (for example, C:\AVEVA\pdms11.5) to the list of folders in the Path variable. Once the Path variable includes the pdms11.5 folder, you can run pdms by typing pdms at a command prompt. 4.6 Customising PDMS Start-Up There is a batch (.bat) file supplied in C:\AVEVA\pdms11.5 called pdms.bat which allows entry into PDMS. You can run PDMS using this batch file in any of the following ways: VANTAGE PDMS Installation Guide Version 11.5 4-5 Setting Up the Windows Environment • • Use the shortcut in the Windows Start menu, Start>Programs>AVEVA>VANTAGE PDMS 11.5>Run PDMS You can create a shortcut on your desktop to run your batch file. With the cursor in the desktop area, click with the right-hand button and select New>Shortcut. This shows a sequence of dialogs to help you create the shortcut. Type in the location of pdms.bat, for example: C:\AVEVA\pdms11.5\pdms.bat then press Next and give the shortcut a name. Press Finish. You should now be able to double-click on the shortcut icon to enter PDMS. If you have C:\AVEVA\pdms11.5(the path name for the pdms.bat file) in your PATH environment variable, just type pdms in a command window to execute the batch file. Otherwise, navigate to the folder where the batch file is stored and type pdms or pdms.bat. • • You can set up your own batch files to run PDMS. For example, you may wish to run design checking utilities every night, or update batches of drawings overnight. Begin by creating a batch file, for example, runpdmsmacro.bat. Type the following line into this file: C:\AVEVA\pdms11.5\pdms.bat TTY SAM SYSTEM/XXXXXX /STRUC $M/mymacrofile Where: • • • • • TTY tells PDMS not to start the PDMS GUI. This gives command line only operation. SAM is the project name. SYSTEM/XXXXXX is the PDMS username/password to be used when running the command macro /STRUC selects the required MDB mymacrofile is the pathname of a PDMS command macro, containing the commands that you want to execute in PDMS. In this example, running runpdmsmacro.bat will enter PDMS in project SAM, as user SYSTEM/XXXXXX, in MDB /STRUC, and run the PDMS command macro mymacrofile. The VANTAGE PDMS MONITOR Reference Manual provides more details on running PDMS batch programs. 4-6 VANTAGE PDMS Installation Guide Version 11.5 Setting Up the Windows Environment 4.7 Plotting To plot in a Windows environment, we recommend that you use the plotcadc.bat file supplied in the pdms11.5 folder. Note that you may have to modify the plotcadc.bat file to suit your local printer installation. The Network Plotter must be mapped using the NET USE command. See your network documentation for more information. To run the plotcadc.bat file, give a command in the format: C:\AVEVA\pdms11.5\plotcadc.bat plotfile format printer options Where options are the AVEVA PLOT utility options, and may be omitted. See the PLOT User Guide for more information. Note that the options must be enclosed in quotes. For example: plotcadc.bat c:\pdms\plot1 ps \\ntserver\NTPostScript plotcadc.bat c:\pdms\plot1 hpgl \\ntserver\NThpgl 'CE=Y' VANTAGE PDMS Installation Guide Version 11.5 4-7 Setting Up the Windows Environment 4-8 VANTAGE PDMS Installation Guide Version 11.5 5 Language Support By default, your PDMS project can use any language whose characters are contained within the Latin-1 character set. The Languages covered by the Latin-1 character set a listed in the table below. If you want to use any of the other, non-Latin-1 languages supported by PDMS, it is necessary to configure your PDMS project and the Windows operating system. This chapter describes how to use PDMS on Windows 2000 and Windows XP Professional in each of the supported language groups: • • • • Latin-1 Latin-2 Latin-Cyrillic Far Eastern Supported languages Name Latin 1 Description ISO 8859-1 Latin alphabet 1 Languages covered Danish, Dutch, English, Faroese, Finnish, French, German, Icelandic, Irish, Italian, Norwegian, Portuguese, Spanish, Swedish, Albanian, Czech, English, German, Hungarian, Polish, Rumanian, Serbo-Croat, Slovak, Slovene Bulgarian, Byelorussian, English, Macedonian, SerboCroatian, Ukrainian, Russian Japanese, Korean, Simplified Chinese, Traditional Chinese Latin 2 ISO 8859-2 Latin alphabet 2 Latin Cyrillic ISO 8859-5 Latin/Cyrillic alphabet Far Eastern PDMS does not support any other language character set, nor does it support the mixing of any of the above, except for mixing one Far Eastern language with English. VANTAGE PDMS Installation Guide Version 11.5 5-1 Language Support 5.1 Preparing Windows to Use Supported Languages 5.1.1 Windows 2000 To add an additional language in Windows 2000, follow these steps: 1. Open the Control Panel. 2. Double-click Regional Options to show the Regional Options dialog. 3. Click the Input Locales tab. 4. In the Input Locales box, click the required language, and then click Properties. 5. In the Keyboard Layout box, click the required keyboard layout, click OK, and then click OK. 6. Click the General tab. Click to select the check box next to the language group you wish to install, and then click Apply. The system will either prompt for a Windows 2000 CD-ROM or access the system files across the network. Once the language is installed, Windows 2000 will prompt you to restart the computer. 5.1.2 Windows XP To add an additional language in Windows XP, follow these steps: 1. Open the Control Panel. 2. Double-click Regional and Language Options. 3. On the Regional options tab, under “Standards and formats”, select the required language from the list. 4. Click the Languages tab, and then click Details under "Text services and input languages". 5. Under “Default input language”, select the required language. If the required language appears in the list, click OK. If it does not appear in the list, then click Add under "Installed Services", and then click the language you want to add and the keyboard layout you want to use for that language. To configure the settings for the Language bar, click Language Bar under "Preferences". The Language bar is used to switch between languages while you are using PDMS. Click OK to close the Language Bar Settings dialog. Click OK to close the “Text Services and Input Languages” dialog. 5-2 VANTAGE PDMS Installation Guide Version 11.5 Language Support 6. Click the Advanced tab. Under ”Languages for non-Unicode programs”, select the required language. Click Apply. It may be necessary to install new code page conversion tables. Only member of the Administrators group can install code page conversion tables. The system will either prompt for a Windows XP CD-ROM or access the system files across the network. Once the language is installed, Windows XP will prompt you to restart the computer. Note: For Far Eastern language support, it is necessary have the East Asian support option installed. 5.2 Preparing PDMS to Use Latin-1, Latin-2 or LatinCyrillic Languages In PDMS ADMIN, you must specify a character set for each project by using one of the following commands on the PDMS ADMIN command line: Command PROJECT CHARSET LATIN 1 (default) Languages covered Danish, Dutch, English, Faroese, Finnish, French, German, Icelandic, Irish, Italian, Norwegian, Portuguese, Spanish, Swedish, Albanian, Czech, English, German, Hungarian, Polish, Rumanian, SerboCroat, Slovak, Slovene Bulgarian, Byelorussian, English, Macedonian, Serbo-Croatian, Ukrainian, Russian PROJECT CHARSET LATIN 2 PROJECT CHARSET LATIN CYRILLIC The corresponding font family must be selected for Draft and Isodraft drawings. Use Project>Font Families and select the Font Type appropriate for you chosen language. For details, see the VANTAGE PDMS ADMIN User Guide and VANTAGE PDMS ADMIN Command Reference Manual. 5.3 Preparing PDMS to Use a Far Eastern Language You must ensure that your licence file is for the language version you require. VANTAGE PDMS Installation Guide Version 11.5 5-3 Language Support Before you use PDMS, you must set the environment variable CADC_LANG as follows: CADC_LANG=Japanese CADC_LANG=Korean CADC_LANG=Chinese CADC_LANG= TChinese Simplified Chinese Traditional Chinese Kanji In PDMS ADMIN, you must specify the multibyte character set for each project by using the command corresponding to your required language: PROJECT MBCHARSET JAP PROJECT MBCHARSET KOR FILE / PROJECT MBCHARSET CHI Simplified Chinese PROJECT MBCHARSET TCHIN FILE / Traditional Chinese For details, see the VANTAGE PDMS ADMIN User Guide and VANTAGE PDMS ADMIN Command Reference Manual. 5-4 VANTAGE PDMS Installation Guide Version 11.5 6 6.1 Running PDMS under Windows Spaces in Windows pathnames To run macros with spaces in the filenames, you must enclose the filename in quotes, without a leading slash. For example: $m'c:\Program Files\Macros\space.mac' arg1 arg2 6.2 Linking to Microsoft Excel You can make your reports load directly into a Microsoft Excel spreadsheet, as comma-separated files: • Select Utilities>Reports>Modify from the PDMS main menu bar. Pick a report template. Click on OK: the Modify Template form is displayed. Select Options>Other Formats... from the Modify Template form menu bar. This displays the Report Format form. From this form: • Choose the CSV option from the Format drop-down list. • Click on OK: this returns you to the Modify Template form. Select the Overwrite radio button For the filename enter %PDMSUSER%/fname.csv (the .csv extension is important). In the System command text box enter 'cmd/c “C:\\excel.exe” %PDMSUSER%\fname.csv' where C:\ is the location of Excel on your system. Note that it is necessary to enclose Windows command arguments in double quotation marks if the argument contains embedded spaces. :\\ • • • • • • VANTAGE PDMS Installation Guide Version 11.5 6-1 Running PDMS under Windows 6.3 Windows Parameters The following setting can be used to improve performance when repositioning forms in PDMS. This is an optional Windows Parameter setting. Windows 2000 Open the Control Panel. Select Display and select the Effects tab. On the form, uncheck Show Window Contents While Dragging. Windows XP Open the Control Panel. Select Display, then select the Appearance tab and click on the Effects… button. On the form, uncheck Show Window Contents While Dragging and Show shadows under menus. 6-2 VANTAGE PDMS Installation Guide Version 11.5 7 7.1 PDMS Projects The Sample Project PDMS is supplied with a sample project, which can be used in several ways: • • It provides you with examples of the use of PDMS. It provides you with sample libraries, catalogues and specifications which enable you to use PDMS before you set up your own, and can be used as starting points when you do start to create your own. It provides you with starting points for the tutorials in the following manuals: Pipework Design Using PDMS Pipework Spooling Using PDMS Structural Design Using PDMS Industrial Building Design Using PDMS Support Design Using PDMS HVAC Design Using PDMS Reporting from PDMS Drawing Production Using PDMS • • It provides an example of how to set up your own projects. MAS (Master) provides data in read-only databases. This data should not be deleted or changed in any way, or the rest of the sample project will become unusable. SAM (Sample) contains several MDBs which can be modified, and so they can be used for training, The sample project is actually two projects in PDMS terms: • • 7.1.1 Copying Project SAM to Your User Area The sample project is loaded automatically when you install PDMS. You should copy the sample project to your user area and run it as supplied. VANTAGE PDMS Installation Guide Version 11.5 7-1 PDMS Projects The project files are held in two directories: sam000 holds all design data and catalogue data; sampic holds the DRAFT picture libraries. 7.1.2 Users and Teams in the Sample Project Free User The Free user has username/password SYSTEM/XXXXXX. General Users Team Username/password CATS DEMO EQUI HANGER HVAC PIPE SAMPLE STRUC CATS/CATS DEMO/DEMO EQUI/EQUI HANGER/HANGER HVAC/HVAC PIPE/PIPE SAMPLE/SAMPLE STRUC/STRUC General User with Administration Rights There is a user named ADMIN who is a member of all teams except MASTER. In particular, ADMIN is a member of the following teams: CATADMIN DRAFTADMIN HSADMIN ISOADMIN Membership of these teams gives special administration rights within the corresponding constructor module. Each MDB contains databases with appropriate access rights. There are also teams and users associated with each MDB with appropriate access rights. 7.1.3 MDBs in the Sample Project This section assumes that you are already familiar with PDMS databases. The sample project contains the following MDBs: 7-2 VANTAGE PDMS Installation Guide Version 11.5 PDMS Projects CATS DEMO EQUI HANGER An MDB for practising using Catalogues and Specifications. A demonstration MDB. An MDB for the Equipment tutorials. An MDB for the Support Design tutorial. This MDB contains suitable pipework, steelwork and civils as a starting point. An MDB for the HVAC Design tutorial. This MDB contains suitable steelwork and civils as a starting point. An MDB for the Reporting from PDMS and Drawing Production tutorials. This MDB contains design data from which reports and drawings can be produced. You can also produce isometrics. An MDB for the Structural Design tutorial. An MDB for the Pipework Design and Pipework Spooling tutorials. HVAC SAMPLE STRUC PIPE 7.2 Creating PDMS Projects For full information on setting up your own projects, see the VANTAGE PDMS ADMIN User Guide. You will need to create project folders for each project; for example, for a project xyz: md md md md xyz000 xyzpic xyziso xyzmac Set the corresponding environment variables that point to these directories. You can do this by setting Environment Variables using the Control Panel, or by modifying the evars.bat file used to configure your PDMS Windows installation. (see Chapter 4, Setting Up the Windows Environment, for further details). Alternatively, type the following in an MS-DOS window: set set set set XYZ000=pathname\xyz000 XYZPIC=pathname\xyzpic XYZISO=pathname\xyziso XYZMAC=pathname\xyzmac Note: Users converting from Unix should note that there is no direct equivalent of the .cshrc file in which these variables can be set. VANTAGE PDMS Installation Guide Version 11.5 7-3 PDMS Projects Use the 'Make PDMS project' icon supplied to start the PDMS Make program, then enter: XYZ $m/%PDMSEXE%/makemac.mac FINISH Note: Users converting from Unix should note that the makemac.mac file is the same as on Unix. The executable for each module is also named identically to that on Unix, e.g. DESIGN runs %PDMSEXE%/des. The extension '.exe' needed by Windows is added automatically. 7.2.1 The Sample Project and Your Own Projects You can add databases from the sample projects SAM and MAS to your own projects from within PDMS ADMIN, using the Install options on the main menu bar. Note that these options are only available if you have the project environment variables for SAM and MAS set. Note on DRAFT Libraries: You must have DRAFT libraries available in your current project before you can enter the module. You may find it convenient to install the libraries supplied by AVEVA in the MAS project (using the Install options), even if you wish to create your own libraries for the project. 7-4 VANTAGE PDMS Installation Guide Version 11.5 8 Installing AutoDRAFT This chapter explains the steps needed to install and configure AutoDRAFT. Under Windows, AutoDRAFT may be run in stand-alone mode or it may be run from PDMS DRAFT or ISODRAFT. You can use the adraftde, adraftbe and adraftse scripts as described in the VANTAGE PDMS AutoDRAFT User Guide. The DRAFT and ISODRAFT applicationware generates interface files for AutoCAD, which are then used by the scripts. AutoDRAFT generates interface files for DRAFT, which can be imported using the DRAFT applicationware. 8.1 Compatibility The version of AutoDRAFT released with PDMS 11.5 is compatible with AutoCAD Releases 2000i and 2002. 8.2 The AutoDRAFT Software AutoDRAFT software consists of three AutoCAD applications that run with AutoCAD Releases 2000i and 2002, and PDMS application macros to link the AutoDRAFT applications with PDMS DRAFT and ISODRAFT. The three AutoCAD applications are: • • • AutoDRAFT Drawing Editor AutoDRAFT Frame Editor AutoDRAFT Symbol Editor All three editors can be used with PDMS DRAFT. The AutoDRAFT Drawing Editor can be used with ISODRAFT. The Drawing Editor is used to modify drawings transferred from PDMS DRAFT or PDMS ISODRAFT. The Frame Editor is used to transfer AutoCAD drawings into backing sheets or overlay sheets in PDMS DRAFT. VANTAGE PDMS Installation Guide Version 11.5 8-1 Installing AutoDRAFT The Symbol Editor is used to convert AutoCAD graphics into symbol templates within PDMS DRAFT symbol libraries. 8.3 Configuring AutoDRAFT with AutoCAD The AutoDRAFT 11.5 software is installed under the PDMS executables folder: pdms11.5 autodraftACAD autodraftfonts autodraftACADsource • The autodraftACAD folder contains .bat files, AutoDRAFT scripts, AutoLISP programs, binary DRAFT menu files and an AutoCAD linestyle file. The autodraftfonts folder contains AutoCAD font files. All of these are needed to run AutoDRAFT programs in AutoCAD. In addition to the AutoDRAFT binary menu files, text versions are also provided. These are supplied in the autodraftACADsource folder for reference/customisation. This folder should not be visible by AutoCAD. • • Note: The AutoDRAFT software will only operate properly if AutoCAD can be run using the acad command. AutoDRAFT cannot be guaranteed to work if the AutoCAD executable acad has been renamed, or if the acad command runs a user-supplied file which itself runs AutoCAD. 8.4 Installing and Configuring AutoCAD In order to use AutoDRAFT, AutoCAD must be installed and configured for each computer where AutoDRAFT will be used. The AutoCAD Installation and Performance Guide supplied with AutoCAD describes how to do this. 8-2 VANTAGE PDMS Installation Guide Version 11.5 Installing AutoDRAFT Configure AutoCAD so that it can find the extra menus and fonts used in AutoDRAFT. How you do this depends on your version of AutoCAD; typically: • • In AutoCAD, move the cursor into the command region and click the right-hand mouse button. Select Preferences, then Environment. Add the appropriate paths to the autodraftACAD, autodraftACADsource and autodraftfonts directories to the Options>Files>Support File Search Path field. The AutoDRAFT environment variable setting commands applicable to each release of AutoCAD are listed in the following sections. The environment variables are set within the supplied pdms.bat file. These should be edited to suit the installed version of AutoCAD. 8.4.1 AutoCAD R2000i set PDMS_ACAD=2000i set PDMS_ACAD_PATH=pathname for AutoCAD R2000 files e.g. C:\Program Files\AutoCAD 2000i;C:\Program Files\Common Files\Autodesk Shared set ACAD_VERSION=%PDMS_ACAD% set path=location of autodraftACAD folder;%PDMS_ACAD_PATH%; %path% Before running AutoDRAFT, you need to run AutoCAD R2000i and add the following as file paths: Location of autodraftACAD folder Location of autodraftACADsource folder Location of autodraftfonts folder 8.4.2 AutoCAD R2002 set PDMS_ACAD=2002 set PDMS_ACAD_PATH=pathname for AutoCAD R2002 files e.g. C:\Program Files\Acad2002;C:\Program Files\Common Files\Autodesk Shared set ACAD_VERSION=%PDMS_ACAD% set path=location of autodraftACAD directory;%PDMS_ACAD_PATH%; %path% Before running AutoDRAFT, you need to run AutoCAD R2002 and add the following as file paths: VANTAGE PDMS Installation Guide Version 11.5 8-3 Installing AutoDRAFT Location of autodraftACAD directory Location of autodraftACADsource directory Location of autodraftfonts directory 8.5 Getting Started with AutoCAD Before using the Drawing Editor make sure that AutoCAD has been correctly installed and configured by entering the command acad at the operating system command prompt. 8.6 Application Macros for Use with PDMS DRAFT The applicationware provides the additional menus and forms required to run the AutoDRAFT editors in AutoCAD directly from DRAFT and ISODRAFT. 8-4 VANTAGE PDMS Installation Guide Version 11.5 9 Upgrading Projects to Version 11.5 No upgrade procedure is required for PDMS 11.4 projects. You can directly access PDMS 11.4 projects using PDMS 11.5. If you are upgrading from an earlier version of PDMS, it is necessary to upgrade your PDMS projects from each PDMS version to the next by using the upgrade procedure supplied with the appropriate version of PDMS. For example, to upgrade a project from PDMS 11.3 to PDMS 11.5, it is first necessary to load the PDMS 11.4SP1 product, and use its upgrade procedure to create a PDMS 11.4/11.5 version of your project. VANTAGE PDMS Installation Guide Version 11.5 9-1 Upgrading Projects to Version 11.5 9-2 VANTAGE PDMS Installation Guide Version 11.5 10 Troubleshooting Here are some suggestions about solving some problems you may encounter when using PDMS under Windows. 10.1 Error: General The dynamic link library DFORMD.dll could not be found in the specified path. This is supplied with PDMS. Perhaps you have not set your PATH variable. The PATH setting must include ‘C:\AVEVA\pdms11.5’. STOP The application failed to initialise properly (0xc0000135). Click on OK to terminate the application. This occurs after a number of other errors. The most likely reason is a problem with the PATH variable. Explanation: Error: Explanation: 10.2 Error: Solution: License Manager Errors When you start up lmgrd it says (lmgrd) Can't make folder C:\FLEXlm, errno: 2 No such file or folder, etc. There is no C: drive for the license manager to write to. As the System Administrator or a Power User, you need to make a shared disk called C:. This can be done on a networked or non-networked computer. Within the Windows Explorer’s File menu, create a new folder (e.g. D:\C_drive) and make it current. Select File>Properties and select the Share tab. Click on the Shared As: radio button and then click OK. Then from the Tools menu select Map Network Drive. Select C: from the Drive: drop-down list in the displayed form and type \\hostname\C_drive in the Path box. Then click on OK. (C:) should now appear in the list of available drives in Explorer. (lmgrd) "": Not a valid server hostname, exiting. The hostname used by AVEVA to create the license file does not correspond with the computer on which you are running PDMS. The hostname comes from the variable COMPUTERNAME, which you can Error: Explanation: VANTAGE PDMS Installation Guide Version 11.5 10-1 Differences Between 10.5.4 and 11.3 on NT obtain by typing 'env|findstr COMPUTERNAME' in a Command Prompt window. Compare this with the license file contents, and resubmit if necessary. Pop-up Mess.: FLEXlm: checkout failed: Cannot connect to license server (-15, 10:10061) WinSock error code. Explanation: lmgrd has not been started up - see above for details. Pop-up Mess.: FlexLM: checkout failed: Cannot find license file (-1,73:2) No such file or folder. Explanation: lmgrd has not been started up - see above for details. Pop-up Mess.: FlexLM: checkout failed: Licensed number of users already reached (-4,132). Explanation: You have exceeded the permitted number of users specified in your license file. 10.3 Entering PDMS (43,9) Environment Variable not defined for project name. You have not set the environment variable for the project, e.g. XYZ000. (43,1) Project not available! Error 7 allocating system database. The environment variable for the project does not point to the correct location. Either the disk and/or folder do not exist or are not readable. not found. or Bad password. You are trying to enter PDMS without a valid PDMS username and/or password. PDMSWK environment variable not set. Set PDMSWK to c:\temp or some other folder where PDMS can create temporary files. Error 34 opening variables file. You cannot create a file in the location pointed to by environment variable PDMSWK. Error: Explanation: Error: Explanation: Error: Explanation: Error: Solution: Error: Explanation: 10-2 VANTAGE PDMS Installation Guide Version 11.5 Error: Explanation: Project is pre version 8. This can happen if you have transferred the project from Unix using FTP in ASCII rather than Binary format. 10.4 Starting Appware in DESIGN/DRAFT/ISODRAFT/ PARAGON/SPOOLER/ADMIN Error: Solution: Fatal Druid error handler UI_init. Couldn't even find the Default Visual. The Display colour selection is incorrect. Refer to the Support pages on the AVEVA website for information on supported graphics cards and drivers. Syntax errors occur when entering PDMS, but before the initial form appears. or Using the 'q directory ...' syntax results in the message 'The system cannot find the path specified'. This may be caused because the TEMP environment variable is not set, or points to a folder to which PDMS cannot write. Error: Solution: 10.5 Error: Solution: Problems with Graphics Cannot pick certain items in DESIGN 3D shaded views. There is probably a problem with the display driver for the graphics board that you are using. Make sure you have the version of the display driver recommended on our supported display drivers Web page. Incorrect colours. Check the setting of your Display. The colour resolution should be set to ‘True Colour’ or 16.7 million colours. Graphics speed (for example in 3D views) is poor. Check the setting of your Display. Error: Solution: Error: Solution: VANTAGE PDMS Installation Guide Version 11.5 10-3