Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. This document is the property of and contains Proprietary Information owned by Westinghouse Electric Company LLC and/or its subcontractors and suppliers. It is transmitted to you in confidence and trust and you agree to treat this document in strict accordance with the terms and conditions of the agreement under which it was provided to you. 1
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Westinghouse Map & Migration Software Overview Robert Shemony Principal Engineer, Simulator Upgrades 2
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Safety Brief • Location in the building • Quickest/safest route out of the building • Evacuation assembly area • Room-specific hazards • Inclement weather • Location of nearest defibrillator (AED) • Safety concerns policy – All employees and contractors are expected to immediately report any nuclear safety concerns they may have 3
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Introduction • Targeted toward simulator maintenance staff • Session, consisting of classroom instruction and demonstration. • Demonstration will include setting up the tools and running them. The process of using the input files and generating code will also be shown. • Prerequisites: ® ® – Familiarity with Microsoft Windows /Windows Server OS – Basic Ovation® Training 4
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Classroom Topics and Goals • Training in the use of simulator map and migration software – Standard DCS Map Tool – Standard DCS Migration Tool • Usage and configuration of the Map & Migration Tools • Overview of input files needed • Overview of output files produced • Putting the output files to use 5
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Demonstrations • Map process • Migration process 6
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Training Objectives • By the conclusion of this training, each student should be able to: – CONFIGURE the Map Tool – CONFIGURE the DCS Migration Tool – GENERATE & APPLY the required Input Files – RUN the Map Tool – RUN the DCS Migration Tool – GENERATE Map & Migrated Files – UTILIZE the generated files in the simulator system 7
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Terms and Definitions • Drop(s) – An Ovation Simulation system that may include a database server, SimHistorian, or operator workstation among others • Stimulated – A type of system that is driven by actual plant equipment • Emulated – A type of system that is driven by plant algorithms and processes executing in the PMC environment • PMC – Plant Model Computer – also referred to as the Simulation Server – Is the computer that drives the simulation and houses a simulator executive program with plant models. • PTDB Database – A database export file that contains all the points, networks, units in the system. PTDB (Power Tools DataBase). 8
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Terms and Definitions (cont.) • Oracle Database – A full database export that contains everything in the PTDB Database export in addition to computer SIDs, IP Addresses, etc • Master SimStation – A simulator computer that transfers data and commands back and forth between Ovation and the PMC • Map – A set of files created to link the points stored in shared memory on a SimStation with that of the shared memory(global) on a Plant Model Computer • Migration – The act of producing configuration files from the plant database and graphics 9
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Westinghouse Simulator Software Process Handling Plant Data 10
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Plant Data • The Plant data consists of the plant database(s), control sheets, graphics and references used by the Ovation System. • The plant data must be backed up from the Plant Database server, generally drop200. • Any time data is changed in Ovation such as a new point, a graphical change, etc, a new backup must be made. 11
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Plant Export File • The Ovation plant export file is the compilation of all of the system data in text form. It contains data from the System level all the way down to every point in the system. • This file contains detailed data about every item in the system. – Trend groups – Alarm configuration – Security/quality configuration • There are two forms of the plant export file – An Ovation ptdb database (system, network and unit data) – An Oracle database ( system, network, unit, control sheet and graphic data) • Both databases are generated along with the OvPtSvr folder contents during a system backup. 12
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. OvPtSvr Folder • The OvPtSvr folder contains all the information about the system graphics and control sheets. – The graphics folders that will contain the system macros and graphic sheets. – The “on-line” folder that will contain the compiled control sheets. 13
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Plant Backup (.OVBK) Directory • The .OVBK directory is a plant backup generated from the Ovation Backup/Restore utility. This will create a copy of the entire OvPtSvr plant directory which contains all the necessary items for Migration to the simulator. • In addition an OVPTBACKUP directory will be created and contain: – PTDB Database backup – Oracle Database dump – Sheet_data.xml ( if allowed by plant) – Sim_ocb.lst (if allowed by plant) • Two simulator sql scripts are required to create the sheet_data.xml and sim_ocb.lst files. They are transferred to the plant system if allowed. 14
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Plant Backup (.OVBK) Directory - continued • To generate a .OVBK backup from Ovation, open Ovation Developer’s Studio. • Right click on the system name, ASCO and then click “Backup/Restore”. 15
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Plant Backup (.OVBK) Directory - Continued • The Ovation Backup/Restore utility will appear. • Click on the “Backup/Restore” tab and set the output file name and location. • Click “Backup Now”. 16
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Plant Backup (.OVBK) Directory - Continued • The backup process will now begin. • Once the process is complete, a .OVBK directory will be generated at the location entered. 17
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Retrieving Files from the .OVBK directory • The files must now be retrieved from the .OVBK directory. This can be done by opening on Backup/Restore utility. the Ovati • To restore a complete .OVBK backup, from Ovation, open Ovation Developer’s Studio. • Right click on the system name, ASCO and then click “Backup/Restore”. • The Ovation Backup/Restore utility will appear. • Click on the “Backup/Restore” tab and set the input directory. • Click “Restore Now”. • Individual files can be restored by using the windows copy/paste function from the .OVBK directory 18
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Oracle Export - Import • To import the Oracle dump file into the Ovation Simulator system, copy the file to Drop200 of the simulator system. It is a good practice to backup the simulator before importing the dump. • Open a command window to load the Oracle dump file using the following command: – do_ptadmin_import • After this command is issued, you will be prompted for the file name/path where the Oracle dump was installed. • This will commence a 14 step process that will import the full Oracle database into Ovation. This may take several minutes. • This type of import is typically used to load the UNEDITED plant data onto the simulator in order to generate the sim_ocb and sheet data files. 19
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Westinghouse Simulator Software Process DCS Map Tool 20
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. DCS Map Tool • The Standard Simulator DCS Map Tool is software that is used to generate variable mapping configuration files and simulator import file. • The Westinghouse Simulator software creates a shared memory on the SimStation. This shared memory stores the data for every variable passed between the PMC and the SimStation. Variable addresses are different between Ovation and PMC. • The files generated by the DCS Map Tool link the two shared memory addresses so each address matches up with its companion. 21
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. DCS Map Tool (cont.) • The mapping files link the Ovation memory locations with that of the SimStation, and with the help of plant-specific drivers on the PMC, link the shared memory on the PMC with the model memory. 22
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. DCS Map Tool (cont.) • Once the DCS Map Tool is installed, start the program by double-clicking on the Sim DCS Logic Map Tool icon. 23
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Map Tool Config File • The config file is an XML file that contains the data on each drop and how each drop’s points are allocated in the simulator. • The XML file will also specify how each drop’s points are mapped. • The Drop Configuration file template is generated by using the DCS Map Tool. • The template is modified using a text editor. The saved file name of the Drop Configuration is generally “drop_config.xml”. • Typically a drop configuration file, once configured, will never change throughout the life of the system unless a new operator workstation is added or another drop is introduced to the system. 24
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. User Interface • The Map Tool user interface will appear. 25
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. User Interface (cont.) • The main open area highlighted is the log area. It also contains an error/warning count and an options button that allows result filtering. 26
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. User Interface (cont.) • The Map Tool has three buttons that control the tool’s functionality. • The highlighted button generates a drop configuration template file. As previously mentioned, this file is a user-created file. This will generate a generic template to use. 27
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. User Interface (cont.) • The highlighted button below will begin the mapping file generation. This button is grayed out until the preferences are correctly set. 28
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. User Interface (cont.) • The highlighted button will display the Preferences popup window and allow you to set the settings for the DCS Map Tool. 29
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Preferences - General • The General tab allows you to set the base output folder where the map files will be generated and allows you to select an algorithm package. No algorithm package will be used for ASCO. DCS Migration files will be used, later in Advanced. 30
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Preferences – General (cont.) • The lower selections of the screen allow for mapping memory changes. The “Output Type” used depends on the type of connection used in the system, either TCP/IP or the Legacy SCRAMNet cards. • Initial Memory Offset will set where in memory the value mappings will begin; a hexadecimal value is used. 31
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Preferences – Ovation • The Ovation tab of the Preferences window requests that you locate all of the input files and sets the current version of Ovation being used. Red indicates file does not exist. • The input files are: – PTDB Export File – OCB Point List – Ovation Control Sheets – Sheet Data XML – Drop Configuration 32
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Preferences – Code Generation • The Code Generation tab allows for prepending, appending, capitalization, and character replacement of the mapped variables. Typically, this should match the Migration configuration files so that the variable names match. 33
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Preferences – Scripts • The Scripts tab allows the project to enter pre and post scripts. These scripts will be executed each time the Map tool is executed. Pre script before processing and post script after processing. The scripts can also be disabled by using the main Map Tool UI tool bar. 34
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Project Specific Pre-processing • Sometimes the PTDB export file or OvPtSvr folder contents must be manually edited before being used in the simulator tools. • The project batch file Removeptdb.bat is used to execute the script RemoveASCPptdb.vbs from the Map Tool Interface • RemoveASCOptdb.vbs processes the plant OvPtExport.exp file and creates the OvPtExport_ASCO_mod.exp. The script removes: I/O references related to BOPNET1 or SAMONET1 All ExternalSysInterfaces IoDevice 5 related to ExternalOvationNetwork LocalDataServers ExtNetConnections ConfigHistStorage Changes ScannerDrop from “drop162” to “” Replaces any BOPNET1 or SAMONET1 with SCDRNET1 35
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Project Specific Post-processing • Sometimes the Map Tool output files must be manually edited before being used in the simulator. • The project batch file CreatSAMOpoints.bat, called by the Map Tool, executes the visual basic script SAMOpoints.vbs and batch script change_DU2LC.bat. SAMOpoints.vbs - parse graphics and macros source files changing BOP/SAMO multi-network points to SCDRNET1 Change_DU2LC.bat executes the following scripts CLEAR_ACK.vbs – creates the simulator trigger file for all drops in the plant system. The created file is appended to the end of each system status display Status_macro.vbs – modifies each macro used by a system status display such that the DU field options are changed to LC field options. System_macro.vbs– modiiesy each system status display such that the DU field options are changed to LC field options 36
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Project Specific Post-processing (cont’d) System_system.vbs– modifies each system status display such that the DU field options are changed to LC field options and POKE parameters point to trigger 50 and 51 Drop_details.vbs – modifies the drop details diagram such that the DU field options are changed to LC field options M8changes.vbs – parses the OvPtExport.exp and saves M8 and HD module values. Creates the batch file “SetM8moduleFields.bat” to set each module M8 and HD according to the plant using set_point_field.exe. This is required due to the controller emulation executed on the PMC 37
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Preferences – Advanced • The Advanced Tab allows for overriding of template files within the tool. • The Advanced commands can be found in WNA-GU-00145-GEN, Section 5.2.5.5. • In order to maintain Map and Migration synergy the ASCO project is using Advanced commands input.config.io.file – io_modules_config.xml released with the Migration Tool input.config.alg.file – algorithm_templates.xml released with the Migration Tool 38
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Generation • Once the Preferences are properly set up, the “Generate” button will become available. • Clicking the “Generate” button will prompt you to select which files you would like to generate and which you wouldn’t. • Once the “Generate” button is clicked, the mapping process will begin. 39
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Generation (cont.) • As the mapping process is occurring, a status bar will appear and display the percent completion. • It also shows any status messages in the logging area. A running count of errors and warnings is shown at the top of the log. 40
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Generation (cont.) • Once the mapping process completes, you will see “Mapping Complete.” at the bottom of the log, along with the memory size. 41
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Output • The output files generated from the Map Tool are primarily tokens files that list each variable with a shared memory address offset. • The other type of file generated is the SimOvPtExp.imp and ocbpoints.imp, which are new database files that will be loaded on the simulator system. 42
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Tokens Files • The tokens files will list every point in the system. It links their original Ovation name with the PMC variable name (the variables generated from the Migration Tool plus any prefix, suffix or capitalization changes). • The tokens files also contain a memory and server offset to match up the shared memory addresses on each side of a TCP/IP connection. 43
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Tokens Files (cont.) • The tokens files are used on either side of the TCP/IP connection. They MUST match exactly for the connection to work. • A copy of the tokens files must be placed on the SimStation at C:\Ovation\sim\config and on the PMC at C:\Westinghouse\SCDR\output[FAT,SAT]. 44
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. SimOvPtExp.imp • The SimOvPtExp.imp file is a reorganized PTDB database file generated by the Map Tool. • This file reorganizes the system variables to be located on the SimStation drop. • This is done for simulation to work correctly as the SimStation is the simulator’s processor of all points, instead of having various points on each drop. 45
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. PTDB Export - Import • To import the PTDB Export file into the Ovation Simulator system, copy the file to Drop200 of the simulator system. • Execute the Westinghouse Map Tool • Open a command window to load the Map Tool generated PTDB project export files using the following commands: – ovptimport –u ptadmin/ptadmin@ptdb –f baseline.exp (for baselines) – ovptimport –u ptadmin/ptadmin@ptdb SimOvPtExp.imp (Map Tool generated import file) – ovptimport –u ptadmin/ptadmin@ptdb SAMO.imp (Map Tool generated SAMO import file) – ovptimport –u ptadmin/ptadmin@ptdb ocbpoints.imp (Map Tool generated ocbpoints import file) • These steps are typical when rebuilding a simulator system from a plant backup. 46
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Westinghouse Simulator Software Process DCS Migration Tool 47
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. DCS Migration Tool • The Standard Simulator DCS Migration Tool is software that is used to generate configuration and other supporting files from a set of plant data to allow emulation of a control system within the PMC. • The Migration Tool “migrates” the control sheets and each point in the database by creating a software equivalent of the actual hardware. • The resultant database contains everything from the logic to malfunction data built based on that plant logic. • A project properties file must be created before starting the Migration Tool. 48
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. Input Files • There are four types of input files required for logic migration. – OCB Point List – Sheet Data XML File – Plant Export Ovation Database – Ovation Control Sheets • After restoring the plant Oracle dump on the simulator database server. The OCB list and sheet data files can be generated on the simulator system, using scripts from the Map Tool. The plant export and control sheets are extracted as is from the plant Ovation backup. 49
Westinghouse Proprietary Class 2 © 2015 Westinghouse Electric Company LLC. All Rights Reserved. OCB Point List • The OCB Point List is a list of Ovation Control Builder points within the Ovation system. • This program is generated using a script supplied by the Map Tool install. • The Map Tool must be installed on a system with the UNEDITED plant database loaded into Ovation. This can be done directly from the plant database server or via a plant Oracle dump file loaded onto the simulator database server. The latter is the recommended method as it avoids loading simulation software on the plant system. • The OCB Point List file generated by the Map tool is named “sim_ocb.lst”. • After the plant database has been restored to the simulator database server. Generate an OCB Point List file. Browse to the Map Tool scripts directory. Double-click the simocb.bat file. 50
Search
