Readme 08.11 - Bentley...Bentley Utilities Designer integration with Oracle Spatial is one of the...

Readme 08.11.09

Bentley Utilities Designer

2 Readme 08.11.09 – Bentley Utilities Designer

Trademark Notice

Bentley and the "B" Bentley logo are either registered or unregistered trademarks or service marks of Bentley Systems, Incorporated. All other marks are the property of their respective owners.

Copyright Notice

Copyright © 2011-2015, Bentley Systems, Incorporated. All Rights Reserved.


Table of Contents

Bentley Utilities Designer V8i (SELECTseries 3) ..................................................................................... 6

v08.11.09............................................................................................................................................ 6

Introduction ....................................................................................................................................... 6

Workflow Manager ............................................................................................................................ 6

Design Editor ...................................................................................................................................... 6

Job Processor ..................................................................................................................................... 7

Key Features ........................................................................................................................................... 8

Bentley Map FME Extension ............................................................................................................ 11

What is FME? ............................................................................................................................... 11

FME Desktop Product Installation Requirement ......................................................................... 11

Data Formats ................................................................................................................................ 11

Known Issues ................................................................................................................................ 12

Knowledge Base ........................................................................................................................... 15

Oracle Spatial ................................................................................................................................... 18

Oracle SSO (Single Sign On) .......................................................................................................... 19

Workspace Macros ...................................................................................................................... 19

Oracle Spatial Connection ............................................................................................................ 20

Automating Oracle SSO Login ...................................................................................................... 20

Advanced Map Finishing .................................................................................................................. 20

What’s New or Revised? ...................................................................................................................... 26

Technical Requirements....................................................................................................................... 30

Installation Requirements ................................................................................................................ 30

Minimum Profile .............................................................................................................................. 31

Database Requirements ................................................................................................................... 32

Oracle ........................................................................................................................................... 32

Microsoft SQL Server ................................................................................................................... 32

Modeling Administrator Requirements ........................................................................................... 33

FME Desktop Extension Option ....................................................................................................... 33

External GIS Integration Requirements ........................................................................................... 33

Network Requirements .................................................................................................................... 34

Quick Installation ................................................................................................................................. 35

To install this product without Workflow Manager ........................................................................ 35


Pre-Installation steps: .................................................................................................................. 35

Installation Wizard steps: ............................................................................................................. 35

To install this product with Workflow Manager on SQL Server ...................................................... 36



To install this product with Workflow Manager on Oracle ............................................................. 36



To attach the sample database to SQL Server for the Workflow Manager ..................................... 37

To create an Oracle database instance for the Workflow Manager................................................ 38

To load the Oracle database for the Workflow Manager ................................................................ 38

To use the sample Microsoft SQL Server spatial schema ................................................................ 39

Product Activation ............................................................................................................................... 40

Activating a product using the Product Activation Wizard .............................................................. 40

SELECT subscribers activating against a hosted (Bentley) SELECT Server ................................... 40

SELECT subscribers with a deployed (local) SELECT Server ......................................................... 41

NON-SELECT or Node Locked user ............................................................................................... 41

Evaluation Only - No license information .................................................................................... 42

Frequently Asked Questions ................................................................................................................ 43

Known Issues ........................................................................................................................................ 45

Known Issues "FME Extension" ........................................................................................................ 52

Known Issues "Advanced Map Finishing" ........................................................................................ 55

Support Information ............................................................................................................................ 57

Bentley Utilities Designer V8i (SELECTseries 3)



v08.11.09

Introduction

Bentley Utilities Designer is a desktop application that fulfills the core requirements to model, document, and manage as-built infrastructure asset information for electric, gas, water, and wastewater utilities and to design and cost estimate plans for infrastructure extension, renewal, and maintenance activities. The core foundation builds on MicroStation CAD technology and Bentley Map 2D and 3D Spatial technology to address the unique and challenging needs of organizations that map, plan, design, build, and operate the world´s infrastructures. To meet the challenge, Bentley Utilities Designer provides three distinct installable modules: Workflow Manager, Design Editor, and Job Processor.

Workflow Manager

The Workflow Manager is an installable component of Bentley Utilities Designer that secures data access, streamlines Job and task management from current user to the next user, and increases collaboration and access to information. It accomplishes this through Group Roles assigned to users, the management of job status and states, and User Role based portals that include user tasks and metrics. The system can also be easily integrated with work and asset management systems and with ProjectWise.

Design Editor

The Design Editor provides the core GIS, Design, Visualization, and Editing environment to create, manage, analyze, and report on as-built utility infrastructure asset information, and to create, manage, analyze, cost estimate, and report on design plans for utility asset infrastructures. The tools in Design Editor can be categorized into two distinct groups: the Map tools and the Design Assistant. The Map tools provide the primary graphical view of the data. A variety of tools are provided to model, document, analyze, and report on the infrastructures as well as advanced GIS 2D and 3D data manipulation and analysis tools and print preparation tools. The Design Assistant tools are available in edit sessions where design plans are created and manipulated. The design tools provide the capability to assign compatible units to work locations in designs for infrastructure extension plans, maintenance plans, and renewal plans. The assignment of a compatible unit associates units of material, labor type, and cost for generation of cost estimates, Bills of Material, cost comparison purposes, and so forth. This information becomes immediately reportable. The design tools can be integrated with work and asset management systems.



Job Processor

The Job Processor is an installable component of Bentley Utilities Designer that executes and monitors job processing tasks as batch operations. Data is relayed to and from other systems while the Job Processor runs invisibly in the background. Jobs are processed according to job types, which are configured as a set of scheduling, priority, and failure notification preferences. Authorized users can view current job activity as well as information about logged events. By performing routine or time-consuming tasks with little user intervention, the Job Processor expedites production and data maintenance processes. Users can perform their work without interruptions and delays and without competing for system resources.

Key Features


Key Features

The key features of Bentley Utilities Designer are described as follows:

Key Feature Description

Based on MicroStation technology.

MicroStation is the most powerful mapping and design environment available today. Bentley Utilities Designer is based on MicroStation technology and takes advantage of its powerful capture, editing, display, and output capabilities. Companies around the world have been using MicroStation for over twenty years to produce high quality mapping. Bentley Utilities Designer capitalizes on this experience and adds geospatial modeling, network modeling, and interoperability tools while preserving MicroStation performance and operation.

Built-in Bentley Map technology

Bentley Map is a family of applications that form the foundation of the Bentley geospatial desktop and server products. It is a full-featured 3D GIS designed to address the unique and challenging needs of organizations that map, plan, design, build, and operate the world´s infrastructure. Bentley Map has tools for creating, persisting, maintaining, analyzing and sharing all your 2D and 3D geospatial information. Bentley Utilities Designer includes and builds on Bentley Map technology to allow users to easily integrate data from a wide variety of sources into engineering and mapping workflows. Multiple data types with varying coordinate systems are transformed "on-the-fly" as they are added to a session. Powerful analytical and presentation tools allow for detailed analysis, studies and decision support. Enhanced Print Preparation tool, labeling and annotation, join tables and comprehensive query and data browsing tools are included. Bentley Utilities Designer integration with Oracle Spatial is one of the strongest in its class and uses only standard Oracle data types and processes. An API is available to develop custom applications. Please refer to the corresponding Bentley Map release notes, read me documentation, and “Key Features” section for additional information.

Utility Industry Data Models

Bentley Utilities Designer includes data models for electric, gas, water, and wastewater. The data models define asset infrastructure objects, attributes, network connectivity, and relationships for each discipline to meet requirements for design and operations. In addition, the data models include operations records to aid in the management of inspections, maintenance, and incident activities.

Rules based Bentley Utilities Designer supports business rules, layout rules, and Compatible Unit Rules. Business Rules calculate connectivity and set relationships as a byproduct of the drafting process. Layout Rules, ensure maps and the GIS adhere to company drafting standards.

Key Features


Compatible Unit Rules capture design knowledge and enable the automatic assignment of materials, labor, and costs.

Comprehensive Edit and Design Environment

Bentley Utilities Designer merges CAD, GIS, and Work Management into one streamlined environment to manage asset as-built information and design plans for extensions, renewals, and maintenance activities.

Integrated Work Management

The Workflow Manager manages work requests and designs in either a stand-alone mode or with seamless integration to external work management system (WMS). Bentley Utilities Designer supports the most widely used WMS products on the market today.

Workflow Manager Bentley Utilities Designer Workflow Manager allows users to view and manage job status and states by tracking the timelines of each project and shows you which ones need your attention. At a glance, you can see which work requests are pending and which are overdue as well as which designs are still in progress.

Modeling and Documentation Tools

Bentley Utilities Designer layout tools allow users to model and document electric, gas, water, and wastewater infrastructure assets. Similarly, operations records for inspections, maintenance, and incidents can be associated to these assets. Bentley Utilities Designer Conduit Manager Tools allow users to accurately model and document electric underground conduit structures, structure walls, ducts, devices, cables, and conduit run cross sections with precise detail. The system manages relationships and connectivity and provides a place by trace result command to make the layout process a snap.

Network Trace Analysis Bentley Utilities Designer Trace Analysis tools retain trace results until the user clears them. This allows the user to visualize cumulative trace results individually or as a composite presentation. Trace types supported include Find Multiple Paths along a conduit run, Find Spatially Redundant Paths, Find Connected Paths, Find Upstream Paths, Find Downstream Paths, and Find Shortest Path. These results can be refined with queries, or with barriers placed interactively.

Leak Analysis The leak analysis tools enable a user to capture pipe leak and break data in gas and water networks and perform analyses to identify problem areas which can feed into replacement and maintenance decisions.

Design Assistant The Bentley Utilities Designer Design Assistant provides a comprehensive design interface to manage design information and cost estimation information including point and span information, compatible unit information, generating bills of materials, and so forth.

On-the-fly Cost Estimates

Bentley Utilities Designer provides real-time cost estimates for a design as you create it. It continuously calculates and displays the

Key Features


estimated cost of all labor, materials, and equipment at each work location and for the entire design.

Wastewater survey import

Bentley Utilities Designer is preconfigured to import manhole and pipe survey data that includes condition scores, images, and CCTV observations. Pipe scores are calculated as a result of the import process.

Interoperability with Analysis

Bentley Utilities Designer can create Bentley WaterGEMS and Bentley SewerGEMS models in their native format. These models can be maintained by periodically synchronizing them with the GIS without the need to re-create the entire model. Additionally, design scenarios can be created directly in the models by Bentley Utilities Designer to analyze design plans or optimize designs.

"Interoperability" tools and user workflows.

Bentley Utilities Designer includes new tools to improve interoperability with other GIS formats. Directly reference ESRI® SHP files, MapInfo® TAB files, and others, or export your data into these formats for sharing with other groups on your project team. The interoperability tools include a unique interface for defining import and export processes. Easily import single files or entire folders of data. The data is automatically projected into the coordinate system defined for your current map. Your project and mapping data can also be exported into these formats using the same tool with full support of attribute data and projection. For users requiring more advanced interoperability capabilities, the Bentley Map FME Extension is provided that makes available many additional geospatial data formats and supports additional data conversion workflows. In addition, Bentley Utilities Designer Live Data Exchange provides a custom plug-in architecture that allows integration to almost any spatial data source including GE Smallworld.

"Oracle Spatial" direct editing interface.

Oracle Spatial is fast becoming the standard method for organizations to store and manage very large volumes of spatial data. Bentley Utilities Designer can edit data directly in any standard Oracle Spatial environment employing a feature locking mechanism for multi-user environments. Organizations can also take advantage of Oracle versioning to manage conflicts in an “extract, edit, and post to Oracle Spatial” workflow enabled by the Bentley Geospatial Server. It's straightforward for Bentley Utilities Designer to maintain the topological relationships that may have been defined and stored in the Oracle Spatial database because Bentley Utilities Designer uses the native Oracle Spatial topology model. Please refer to the "Oracle Spatial" section for more information.

Microsoft SQL Server spatial geometry direct editing interface.

Beginning with the Bentley Utilities Designer V8i (SELECTseries 3) release, users can edit data directly spatial geometries being persisted in a Microsoft SQL Server graphical source.

Key Features


Bentley Map FME Extension

Bentley Utilities Designer has tools to import and export several different formats of geospatial data. For users that require access to other data formats not directly supported by Bentley Utilities Designer, the Bentley Map FME Extension is designed to make many additional geospatial data formats accessible to improve user workflows.

What is FME?

FME (the “Feature Manipulation Engine”) is a complete data access solution for reading, writing and transforming spatial data. It is produced by Safe Software (www.safe.com). In general FME is used to translate geographic data to and from a variety of different formats including those listed on the "FME Desktop Supported Formats" online resource. The FME Desktop product contains additional useful tools such as the following:

The FME Universal Viewer is a handy tool to view geospatial data of many formats in a quick way.

The FME Workbench is a graphical authoring environment that makes it easy to graphically specify data transformations.

FME Desktop Product Installation Requirement

Please note that prior to using the Bentley Map FME Extension functionalities, you must install and license the required version of the FME Desktop product. Please refer to the "Technical Requirements" section for additional information.

Data Formats

The following table lists those data formats which have been tested with the Bentley Map FME Extension application:

Format Import Export

Bentley MicroStation Design (V7)


Bentley MicroStation GeoGraphics


CityGML

ESRI Geodatabase (File-based) ** requires installation of application software **

ESRI Geodatabase (MDB) ** requires installation of application software **

ESRI Shapefile

FOT GML

Industry Foundation Class STEP Files (IFC)

http://www.safe.com/http://www.safe.com/products/desktop/formats/index.php

Key Features


Format Import Export

Intergraph MGE

MapInfo MIF/MID

MapInfo TAB (MITAB)

Microsoft SQL Server 2008 Spatial

OpenGIS KML Encoding Standard

OS (GB) MasterMap

WFS (Web Feature Service)

Please refer to "FME Desktop Supported Formats" online resource for a complete list of data formats supported by the FME Desktop product.

Known Issues

This section contains information about known issues in this Bentley Map FME Extension release. Please report any other issues found while using this software. It is not necessary to report the following known issues:

Issue Details Formats

Limitations with import of data that contains solid geometries.

During import operations, solids will be converted to multi-surfaces because Bentley Utilities Designer does not currently support solids. The immediate drawback is the loss of the solid semantic and inability to export back to solids.

IFC

Text is not supported.

Text geometry currently cannot be imported or exported as the XfmStorage doesn't support that yet. The FME Extension will ignore instances with text geometries and log a warning.

MicroStation GeoGraphics

Issues with string lengths being too long in XFM.

XFM appears to have some length limitations for string properties. However that limitation is not enforced when setting the string, but rather when retrieving the property on querying the instance, e.g. in Data Browser or on export. It appears that the issue is not there after FME Extension is restarted after the import.

KML, CityGML, LandXML

Structs are flattened during import operations.

During import operations, structs are flattened out as properties, so a struct named 'Address', containing the properties 'Street' and 'Housenumber' will be incorporated as properties with the names 'Address.Street' and 'Address.Housenumber' respectively.

FOT GML

Struct Arrays are not imported.

FME Extension does not currently support modeling of structs and struct arrays.

FOT GML

http://www.safe.com/products/desktop/formats/index.php

Key Features



Structs are not exported.

Any struct or struct array that an instance may contain will be stripped from the instance on export. A warning will be logged to inform the user that information has been lost on export. FME Extension does not currently support modeling of structs and struct arrays. Because structs are flattened at import, struct data still gets written at export if the feature definition is left unchanged.

FOT GML

No support for multiple geometry properties.

In very rare cases the user may want to import data where for a given instance multiple geometry properties exist (e.g. in CityGML a single WallSurface instance may have a geometry for LOD2 and one for LOD3). Since FME Extension does not currently support multiple geometries, only the first geometry property will be considered. Other geometry properties will be skipped and a warning will be logged.

CityGML

Relationships are imported as foreign keys if the FME reader supports that.

There is no conversion that creates XFM sub features for relations. FME Extension does not currently support that from a functionality point of view.

CityGML

No texture support.

No texture support is provided at this time. CityGML

No coordinate transformation on export.

During export, geometries will not be reprojected, so the exported geometries will be in the same projection as they were in FME Extension. However the coordinate system information is being exported. So the exported data knows the coordinate system it is in if the following conditions exist:

A valid coordinate system was assigned to the active design file in the FME Extension session.

The user selected a target coordinate system in the FME connection dialog.

All

Issues with exported spatial reference information.

For certain projections the resulting output in FME doesn't contain proper SRS information (e.g. Dutch RD projection). Example output: ...

GML, SHP

Incorrect schema generated by FOT GML export.

Since it isn't possible to set a schema file (XSD) in the FME dialog when exporting a file to GML, FME will always create its own schema file. This also means that the exported data might not validate with the official schema. The only way to ensure a proper export is by verifying that the feature structure (including structs + struct arrays) at export matches the official schema definition exactly.

FOT GML

Key Features



One thing beyond our control is that FME also generates two geometry properties. One is a single geometry property, and the other is its multigeometry variant. For example:

Also the used namespace in the GML output file is wrong:

The installer complains that the ecom.config file is installed by another Bentley application.

Workaround if the installer complains that the ecom.config file is installed by another Bentley application:

Back-up the existing ecom.config and remove it from the specified directory and run the installer again. Note: Removing the existing ecom.config may break the applications that installed that config file

All

Non-planar polygons are ignored.

Some data files contain polygons which are non-planar. Technically they are invalid, and the associative regions don't match them well because of this. But neither FME nor Bentley Utilities Designer throws an exception, writes a log message, or does anything else because of it.

All

Import of certain IFC features cause a property type mismatch error.

In some cases FME provides additionally redundant properties (e.g. the same property will be delivered as string with comma separated values and as array). This leads to a property type mismatch error. The redundant property will be discarded.

3D Data

Holes in vertical surfaces aren't always detected properly on export.

Many 3D data, especially CityGML data, has vertically oriented features, like walls. Often they contain holes, like windows. In special circumstances (close parallel surfaces) holes don't get exported properly. Generally the distance between two walls is large enough to work properly, but the distance between the two sides of a window is often too small.

3D Data

Swapping two properties in schemamapping does not work.

Example: given a class with the properties "name" and "description," the user chooses to assign the name property to description, and the description property to name. The exchange will complete with warnings. The log will list argumentExceptions, because the reclassifier cannot handle this.

All

http://www.opengis.net/gmlhttp://www.w3.org/1999/xlinkhttp://www.w3.org/2001/XMLSchema-instancehttp://www.w3.org/2001/XMLSchema-instancehttp://www.safe.com/gml/fme

Key Features



Exporting ESRI File Based Geodatabase files.

When creating a new ESRI File Based Geodatabase during export, an ESRI ArcView license level will not work. You must have a license of ESRI ArcEditor or ESRI ArcInfo. In the FME Extension when exporting to ESRI formats, ArcGIS must be installed on the same machine as Bentley Utilities Designer and the FME Desktop software. ArcGIS and FME Desktop must be both licensed. When creating a new ESRI File Based Geodatabase, you must have a license of ArcEditor or upper, an ArcView license level will not work. Workaround: Creating the File Based Geodatabase in ArcCatalog and using it in the FME Extension should provide the ability to export.

ESRI File Based Geodatabase (GDB)

Exporting LandXML files.

While attempting to export data to LandXML file format, an "Exchange failed" error message occurs indicating "FME Error(s): There was a problem writing out the 'Alignments' and 'Alignment' elements. The problem was: 'Item id must be globally unique'. LandXML requires that 'Name' attributes are globally unique. If features have non-unique values for the 'Name' attribute, the attribute will need to be renamed." At this time exporting of the LandXML file format is not supported.

LandXML

Importing existing CityGML files.

A schema mapping problem occurs for the AuxiliaryTrafficArea feature which causes FME Desktop 2010 to provide the property “citygml_function” with an incorrect property type. This issue should be fixed in a future FME Desktop release but for now we recommend to uncheck this property when importing AuxiliaryTrafficArea features when using the FME Desktop 2010 product.

CityGML

In CityGML xlink:href references are ignored.

In the current CityGML support xlink:href references are ignored (this is due to a limitation in FME Safe Software). For more information please see http://www.fmepedia.com/index.php/Main_Page

CityGML

Knowledge Base

This section contains a knowledge base of information that can be useful for Bentley Map FME Extension users.


Enable 3GB option in Windows for import of

For large datasets and certain FME formats (e.g. KML) FME consumes a lot of memory. It is therefore recommended to enable the 3GB option in the boot.ini file of the computer in those cases. See

KML

http://www.fmepedia.com/index.php/Main_Page

Key Features



large datasets

http://docs.safe.com/fme/html/FME_Workbench/content/using_the_3gb_switch.htm for additional information. In general that switch is intended for applications that are memory-intensive, such as database management systems (DBMS). The use of a larger virtual address space can provide considerable performance and scalability benefits. However, the file cache, paged pool, and nonpaged pool are smaller, which can adversely affect applications with heavy networking or I/O. Therefore, you might want to test your application under load, and examine the performance counters to determine whether your application benefits from the larger address space. Windows XP Setup Instructions In boot.ini use /3GB switch:

/3GB [ /userva=SizeInMB ]

Subparameters

/userva

Specifies an alternate amount of user-mode virtual address

space for operating systems booted with the /3GB parameter.

SizeInMB

Specifies the amount of memory, in megabytes, for user-mode

virtual address space. This variable can have any value

between 2048 (2 GB) and 3072 (3 GB) megabytes in decimal

notation. Windows uses the remaining address space (4 GB

minus the specified amount) as its kernel-mode address space.

Example:

[boot loader]

timeout=1

default=multi(0)disk(0)rdisk(0)partition(2)\WINDOWS

[operating systems]

multi(0)disk(0)rdisk(0)partition(2)\WINDOWS="Microsoft

Windows XP Professional" /noexecute=optin /fastdetect

/3gb /userva=3030

Windows Vista Setup Instructions:

bcdedit /set IncreaseUserVa 3072

FME does not export Relief features.

FME does not presently support writing Relief features to CityGML. CityGML

FME 2009 does not support creationDate

These properties are present on most of the features (everything derived from the type _CityObject). This has only been added in FME 2010.

CityGML

http://docs.safe.com/fme/html/FME_Workbench/content/using_the_3gb_switch.htmhttp://docs.safe.com/fme/html/FME_Workbench/content/using_the_3gb_switch.htm

Key Features



and terminationDate properties.

Importing CityGML data with Gauss-Krüger projection may lead to swapped X and Y coordinates.

This is an FME issue that is scheduled to be fixed for FME 2011 only. For FME 2009 and 2010 this can be worked around by modifying the file \xml\gml\xfmaps\gml_keywords.xml file. In that file insert the following keywords into the group called "srsName-to-axisOrder"

gt;

...

CityGML

Coordinate system required when exporting from FME Extension to GML

To export from FME Extension to a GML file, a coordinate system must be set or the following error may occur: Error Message: FME Error(s): * - Unable to write

feature geometries without an FME Coordinate System.

Either tag the FME features with a coordinate system,

or use the GML writer SRS_NAME along with the

SRS_AXIS_ORDER keywords to specify the GML srsName and

axis order for the GML and elements * A fatal error has

occurred. Check the logfile above for details * Error

encountered during writer shutdown.

This condition can be corrected using either of the following methods:

1. Set a coordinate system in FME Extension:

Select the "Tools -> Geographic -> Select Geographic Coordinate System" menu.

Press the second button of the Geographic Coordinate System toolbox (From Library).

Select the appropriate Coordinate System. For more details please consult the MicroStation documentation.

2. Set a coordinate system in the FME Export dialog.

GML

Coordinate system required when exporting from FME

FME requires that the projection is set to LL84 when exporting to KML format.

The following quote is from the FME documentation: KML requires all vector geometry to use the LL84 coordinate system, and to have three dimensions. The KML writer will reproject input feature geometry to ensure that this constraint is fulfilled. Note: An error will

KML

Key Features



Extension to KML format.

occur if the KML Writer encounters a feature with no specified coordinate system.

Unable to open Filenames with Unicode characters

In order for FME to read non-Latin file names, you must open the Regional Settings in Windows and set the language for non-Unicode programs to the language used in the file name. To use filenames with Chinese characters on Windows XP you have to install the files for East Asian languages first. This can be done in the 'Regional and Languages Options' on the 'Languages' tab by activating the checkbox.

All

Error reported if FME uninstalled after FME Extension is installed.

There is no way to detect that FME is missing or uninstalled. This exception is thrown whenever an FME object type is used. Typically that happens when the Browse Dataset dialog on Import/Export is opened.

All

Oracle Spatial

Bentley Utilities Designer works directly with Oracle Spatial data including support for Oracle 9i, Oracle 10g and Oracle 11g database servers. However to access this data the Oracle 11g R1 or R2 client must be installed. Please refer to the "Requirements" section for additional details. In addition for Bentley Utilities Designer to recognize an Oracle table as a feature the following minimum criteria must be met:

Criteria

The feature table must have a primary key constraint consisting of a single numeric or string/character column which will represent the id of the feature. This primary key is required to enable versioning using the standard versioning system of the Oracle Workspace Manager.

The table must have a geometric (SDO_GEOMETRY) column specifying the feature geometry, and this geometry column must be registered in the Oracle Spatial metadata table (ALL_SDO_GEOM_METADATA or the related USER_SDO_GEOM_METADATA view for the user).

The table fields must be of common type (i.e.: no user defined type).

The geometry must be all of a similar type (all of the geometries must be a point, line or polygon type, not a mixture of these types). To determine if a table contains more than one geometry type:

SQL>select p.geometry.sdo_gtype, count(*) from your_table p group by

p.geometry.sdo_gtype;

GTYPE = 2001 = points

GTYPE = 2002 = lines

GTYPE = 2003 = polygons

requirements_map.htm

Key Features


Oracle SSO (Single Sign On)

To enable Oracle SSO functionality database administrators must add new Oracle users for each domain account requiring SSO to the target database, prefixed with the string defined by the os_authent_prefix initialization variable (e.g. “OPS$”).

The following SQL script can be modified for this purpose: CREATE USER "OPS$DOMAIN\USERNAME" PROFILE "DEFAULT"

IDENTIFIED EXTERNALLY DEFAULT TABLESPACE "USERS"

TEMPORARY TABLESPACE "TEMP"

ACCOUNT UNLOCK;

GRANT UNLIMITED TABLESPACE TO "OPS$DOMAIN\USERNAME" WITH ADMIN OPTION;

GRANT "CONNECT" TO "OPS$DOMAIN\USERNAME" WITH ADMIN OPTION;

GRANT "RESOURCE" TO "OPS$DOMAIN\USERNAME" WITH ADMIN OPTION;

Then make sure that sqlnet.ora (on both database server and database client machines) contains the following line:

SQLNET.AUTHENTICATION_SERVICES = (NTS)

Then when connecting using SQL*Plus where you would normally use “sqlplus user/password@server”, you could then simply use: sqlplus /@server

Then the database administrator should ensure all required database objects (e.g. tables, indexes, views, sequences etc...) outside of the Oracle SSO user schema have the proper grants so that processes such as "Register Features..." within the "Bentley Geospatial Administrator" application can access them properly.

Workspace Macros

In order to define Oracle SSO for RDBMS properties, within the Bentley Geospatial Administrator the following workspace macros can be added:

Key Features


Oracle Spatial Connection

To use Oracle SSO when defining a new "Oracle Spatial Connection" choose the "Use Windows Integrated Authentication" option and provide a connection and service name as shown in the following:

Automating Oracle SSO Login

In addition during a Bentley Utilities Designer session, normal Oracle connection dialogs in the "Interoperability" application can be suppressed by adding an optional MSGEO_USE_ORACLE_SSO environment variable definition to a users workspace in one of the following forms:

Host;Port;Service MSGEO_USE_ORACLE_SSO = myserver;1521;mydbservice.domain.com

Service Name Only MSGEO_USE_ORACLE_SSO = mydbservice

Advanced Map Finishing

The Bentley Utilities Designer V8i (SELECTseries 3) "Advanced Map Finishing" (A) capabilities add professional desktop publishing capabilities to MicroStation and provides a unique WYSIWYG (what you see is what you get) on-screen display of graduated color fills, transparent fills, and element ordering and symbology. This software solution enables the simple generation of professional publication-quality presentation graphics inside the MicroStation environment. The key features of the Advanced Map Finishing capabilities are described as follows:


WYSIWYG Operation

With WYSIWYG operation, what you see on the screen is what you get in the print. Extra control is provided by resymbolization and ordering tables, whose effects are visible on the screen the moment they are applied—costly, time-consuming checkplots are a thing of the past. In addition, the map finishing tools

Key Features



eliminate traditional color limitations, provides masking functionality and generates high-resolution compressed PostScript or EPS output straight from MicroStation.

PDF Output The ability to generate PDF files directly removes the need to convert PostScript to PDF using third party application. The Standard of PDF is far superior to the normal MicroStation plot drivers, for users who need and enhanced, precise and efficient output.

Desktop Publishing Tools

Easy-to-use menus provide MicroStation users with access to the desktop publishing tools. Tools typically found in cartographic and desktop publishing such as graduated linear and radiated fills are readily available to create design effects.

Sophisticated Halo Creation

Sophisticated full and half halo creation is available on either closed linear elements to represent water, earth, area boundaries, and linear elements.

Transparency Support

Transparency as a screening percentage from 0 to 100 percentage is ideal for highlighting areas on a raster image and adding color washes to monochromatic images.

Cartographic Tools

A full complement of handy cartographic tools, such as line cap options, are provided along with a wealth of text presentation options, including shadowing, variable fill, transparency, and the use of PostScript fonts. The map finishing tools makes it simple to place text along curves and around corners. These tools also allow EPS files to be placed directly into MicroStation to bring accent graphics and other designs in that may have been created in another desktop publishing tool.

Best Presentation Output

To ensure the best presentation output, users have complete control over element order and symbology presentation both on the screen in WYSIWYG mode and in printing or plotting. Therefore it is simple to produce a composite PostScript or color separation files for print production. For plot production, the map finishing tools offer reliable and powerful print control.

Intuitive User Interface

Print controls provide an intuitive interface making it straightforward to create high quality industry standard PostScript output. From one screen easily define print setup, manage plot scale, implement image compression techniques, define plot rotation or color separation options.

(A) Not available in all Bentley Utilities Designer product editions. Please refer to the "Product Editions" section for additional information.

What's New or Revised?

The following table contains a list of new or revised functionalities relative to the predecessor set of applications Bentley Utilities Designer replaces:

Category Key Feature Description

Platform Standalone Bentley Utilities Designer is a standalone application.

functional_matrix.htm

Key Features



Data Model Multiple Commodities

Data Models are included for electric, gas, water, and wastewater as well as discipline specific tools for design and operations support.

Data Model Wastewater The wastewater data model is all new. The data model provides a comprehensive set of features for sanitary and combined storm systems. It includes asset feature definitions for manholes, catchments, pressure and gravity pipes to name a few. Operations records are provided for surveys, maintenance, and incidents. Operations records can include images, documents, and CCTV.

Compatible Unit Rules

CU quantity Compatible Unit rules can now contain a quantity value.


CU Rule Builder A new tool has been added to allow "master" designers to generate Compatible Unit rules interactively by placing features and capturing the settings at the work locations.

Workflow Management

SQL Server support Workflow Manager now supports SQL Server databases.

Design Assistant SQL Server support Design Assistant now supports SQL Server databases.

Design Assistant User Interface The "Design Assistant" user interface has been improved for usability and in better support for multiple commodities.

Visualization and Analysis

Profile Generation A new tool is provided to generate profiles. The tool is preconfigured to generate profiles of wastewater infrastructures. Other infrastructure features can be configured with the administration tools. Elevation attributes must be present to generate the profiles.


Wastewater Trace Analysis

Support for wastewater networks is added to the network analysis and visualization tool.

Modeling and Documentation

Connectivity New tools to easily connect and disconnect flow connectivity are provided.


Structural Relationships

New tools to easily attach and detach structural relationships are provided.


Merge Linear Features

A new tool is added to merge linear features and compliments the split linear features tool. The tool ensures connectivity and relationships is reset for the resulting feature.

Key Features




Conduit Detail Editor Precision Controls

Precision layout controls have been added to improve manipulation of conduit cross section details and underground structure wall details. These controls include rulers along the top and right sides of the detail view, grid points with user controllable scaling, automatic snapping to control points, and grouping tools.

Data Browser Standard Pre and Post Processes and API callbacks

"Data Browser" edits now invoke pre and post processes that are necessary to maintain data integrity. API callbacks are available for customizations.

Data Browser Improved Search, Sort and Filter Performance

For Oracle Spatial and Microsoft SQL Server Spatial database users, the "Data Browser" application has been enhanced to leverage the new Direct Data Access (DDA) technology that provides server side processing for search, sort and filter operations. With these changes, the "Data Browser" can now more efficiently search, sort and filter extremely large data sets using the speed and power of the underlying database.

Map Manager New Export Map Layer(s) MicroStation Elements Command

In the Map Manager application, the ability to select and export one or more map layers to fully symbolized MicroStation elements has been added. This new functionality provides Bentley Utilities Designer users with the ability to easily share custom thematic map output with MicroStation users that may not have access to a Bentley Utilities Designer product. For developers, a new C API function is provided to leverage this new capability in custom applications.

Coordinate System Tools

New Grid Definition and Grid Generation User Interfaces

A completely new user interface has been added to better support the grid definition and generation processes. Similar to a MicroStation text style or element template, Bentley Utilities Designer users now have the ability to create user defined grid definitions and then place instances of those grids that are dynamically updated whenever the grid definition is changed.

Feature Engine Improved Data Persistence Model

A number of significant performance improvements have been made in the core XFM feature engine including the replacement of MicroStation XML fragment elements with the newer MicroStation XAttributes technology. To improve the efficiency when creating or visualizing large complex polygons (common in many geospatial data sets) the Bentley Utilities Designer V8i (SELECTseries 3) release introduces a new Type 106 polygon data type. This

Key Features



new polygon data type not only simplifies the manner in which disjointed polygon collections or polygons containing holes are persisted, but also removes the need to use associative regions. For non-graphic data only features, a new Type 107 data feature has been added. Note: While Bentley Utilities Designer V8i (SELECTseries 3) can read XFM instance data created with all predecessor product releases, due to the XFM file format changes that data will remain read/only and unavailable for editing until converted into the new file format. Conversion of existing design files to the new XFM file format can be performed using the "File > Save As..." and "Batch Convert" commands with appropriate "XFM" settings in the "Save As V8 Options" dialog. See the "XFM Properties" section of the Bentley Utilities Designer help for additional information on converting existing design file data to the new XFM file format.

Interoperability Improved Geo-Locate Capabilities

For Oracle Spatial and Microsoft SQL Server Spatial database users, the ability to search and locate any graphical feature instance from an attached graphical source has been added. This new functionality provides Bentley Utilities Designer users with the ability to perform a query of the attached graphical source, then select one or more resulting rows in the "Data Browser" and perform a geo-locate operation.

Interoperability Export to SewerCAD and SewerGEMS

A wizard can be used to create SewerCAD and SewerGEMS hydraulic models in their native format. The wizard can also be used to synchronize existing hydraulic models from the GIS and to create scenarios in the models to easily analyze and optimize designs.

Interoperability Import Manhole Survey Data

A survey data import tool can be used to import data in the NASSCO MACP format into the asset database. Observation records, images, and CCTV are automatically related to assets during the import process.

Interoperability Import Pipe Survey Data

A survey data import tool can be used to import data in the NASSCO PACP format into the asset database. Observation records, images, and CCTV are automatically related to assets during the import process.

Interoperability Oracle Versioning and Conflict Resolution

Oracle versioning and conflict resolution is supported without the need for a separate Oracle Connector license.

Key Features



Interoperability New Microsoft SQL Server Spatial Geometry Support

The ability to read/write spatial geometries being persisted in a Microsoft SQL Server database has been added.

Interoperability New Spatial Data Streaming (SDS) Mode

Provides the ability to seamlessly stream data from a variety of spatial data sources including Oracle Spatial and Microsoft SQL Server databases.

Interoperability New Selective Posting Capabilities

Provides the ability to selectively post pending changes to Oracle Spatial and Microsoft SQL Server databases. Prior to the Bentley Utilities Designer V8i (SELECTseries 3) release, posting operations would attempt to commit all pending changes. With this enhancement, users can now choose to post only those changes which are contained within a fence or view.

Interoperability Enhanced Erase Command

For Oracle Spatial and Microsoft SQL Server Spatial database users, the "Erase" command has been enhanced to only process and remove existing feature instances from the connected graphical sources.

Interoperability New Web Feature Service (WFS) Client Support

The ability to query spatial geometries from a Web Feature Service (WFS) server has been added.

Interoperability Improved Interoperability User Interface

The user interface of the "Interoperability" application has been significantly enhanced to better support new capabilities including Spatial Data Streaming, Web Feature Service (WFS) client and graphical source selective posting and erase operations. Included also is graphical interface for defining the "Where" clause search criteria.

What’s New or Revised?



The following table contains a list of new or revised functionalities relative to the predecessor set of applications Bentley Utilities Designer replaces:


Platform Standalone Bentley Utilities Designer is a standalone application.

Data Model Multiple Commodities

Data Models are included for electric, gas, water, and wastewater as well as discipline specific tools for design and operations support.

Data Model Wastewater The wastewater data model is all new. The data model provides a comprehensive set of features for sanitary and combined storm systems. It includes asset feature definitions for manholes, catchments, pressure, and gravity pipes to name a few. Operations records are provided for surveys, maintenance, and incidents. Operations records can include images, documents, and CCTV.


CU quantity Compatible Unit rules can now contain a quantity value.


CU Rule Builder A new tool has been added to allow "master" designers to generate Compatible Unit rules interactively by placing features and capturing the settings at the work locations.

Workflow Management

SQL Server support Workflow Manager now supports SQL Server databases.

Design Assistant SQL Server support Design Assistant now supports SQL Server databases.

Design Assistant User Interface The "Design Assistant" user interface has been improved for usability and in better support for multiple commodities.


Profile Generation A new tool is provided to generate profiles. The tool is preconfigured to generate profiles of wastewater infrastructures. Other infrastructure features can be configured with the administration tools. Elevation attributes must be present to generate the profiles.


Wastewater Trace Analysis

Support for wastewater networks is added to the network analysis and visualization tool.


Connectivity New tools to easily connect and disconnect flow connectivity are provided.


Structural Relationships

New tools to easily attach and detach structural relationships are provided.





Merge Linear Features

A new tool is added to merge linear features and compliments the split linear features tool. The tool ensures connectivity and relationships is reset for the resulting feature.


Conduit Detail Editor Precision Controls

Precision layout controls have been added to improve manipulation of conduit cross section details and underground structure wall details. These controls include rulers along the top and right sides of the detail view, grid points with user controllable scaling, automatic snapping to control points, and grouping tools.

Data Browser Standard Pre and Post Processes and API callbacks

"Data Browser" edits now invoke pre and post processes that are necessary to maintain data integrity. API callbacks are available for customizations.

Data Browser Improved Search, Sort and Filter Performance

For Oracle Spatial and Microsoft SQL Server Spatial database users, the "Data Browser" application has been enhanced to leverage the new Direct Data Access (DDA) technology that provides server side processing for search, sort and filter operations. With these changes, the "Data Browser" can now more efficiently search, sort and filter extremely large data sets using the speed and power of the underlying database.

Map Manager New Export Map Layer(s) MicroStation Elements Command

In the Map Manager application, the ability to select and export one or more map layers to fully symbolized MicroStation elements has been added. This new functionality provides Bentley Utilities Designer users with the ability to easily share custom thematic map output with MicroStation users that may not have access to a Bentley Utilities Designer product. For developers, a new C API function is provided to leverage this new capability in custom applications.

Coordinate System Tools

New Grid Definition and Grid Generation User Interfaces

A completely new user interface has been added to better support the grid definition and generation processes. Similar to a MicroStation text style or element template, Bentley Utilities Designer users now have the ability to create user defined grid definitions and then place instances of those grids that are dynamically updated whenever the grid definition is changed.

Feature Engine Improved Data Persistence Model

A number of significant performance improvements have been made in the core XFM feature engine including the replacement of MicroStation XML fragment elements with the newer MicroStation XAttributes technology. To improve the efficiency when




creating or visualizing large complex polygons (common in many geospatial data sets) the Bentley Utilities Designer V8i (SELECTseries 3) release introduces a new Type 106 polygon data type. This new polygon data type not only simplifies the manner in which disjointed polygon collections or polygons containing holes are persisted, but also removes the need to use associative regions. For non-graphic data only features, a new Type 107 data feature has been added. Note: While Bentley Utilities Designer V8i (SELECTseries 3) can read XFM instance data created with all predecessor product releases, due to the XFM file format changes that data will remain read/only and unavailable for editing until converted into the new file format. Conversion of existing design files to the new XFM file format can be performed using the "File > Save As..." and "Batch Convert" commands with appropriate "XFM" settings in the "Save As V8 Options" dialog. See the "XFM Properties" section of the Bentley Utilities Designer help for additional information on converting existing design file data to the new XFM file format.

Interoperability Improved Geo-Locate Capabilities

For Oracle Spatial and Microsoft SQL Server Spatial database users, the ability to search and locate any graphical feature instance from an attached graphical source has been added. This new functionality provides Bentley Utilities Designer users with the ability to perform a query of the attached graphical source, then select one or more resulting rows in the "Data Browser" and perform a geo-locate operation.

Interoperability Export to SewerCAD and SewerGEMS

A wizard can be used to create SewerCAD and SewerGEMS hydraulic models in their native format. The wizard can also be used to synchronize existing hydraulic models from the GIS and to create scenarios in the models to easily analyze and optimize designs.

Interoperability Import Manhole Survey Data

A survey data import tool can be used to import data in the NASSCO MACP format into the asset database. Observation records, images, and CCTV are automatically related to assets during the import process.

Interoperability Import Pipe Survey Data

A survey data import tool can be used to import data in the NASSCO PACP format into the asset database. Observation records, images, and CCTV are automatically related to assets during the import process.




Interoperability Oracle Versioning and Conflict Resolution

Oracle versioning and conflict resolution is supported without the need for a separate Oracle Connector license.

Interoperability New Microsoft SQL Server Spatial Geometry Support

The ability to read/write spatial geometries being persisted in a Microsoft SQL Server database has been added.

Interoperability New Spatial Data Streaming (SDS) Mode

Provides the ability to seamlessly stream data from a variety of spatial data sources including Oracle Spatial and Microsoft SQL Server databases.

Interoperability New Selective Posting Capabilities

Provides the ability to selectively post pending changes to Oracle Spatial and Microsoft SQL Server databases. Prior to the Bentley Utilities Designer V8i (SELECTseries 3) release, posting operations would attempt to commit all pending changes. With this enhancement, users can now choose to post only those changes which are contained within a fence or view.

Interoperability Enhanced Erase Command

For Oracle Spatial and Microsoft SQL Server Spatial database users, the "Erase" command has been enhanced to only process and remove existing feature instances from the connected graphical sources.

Interoperability New Web Feature Service (WFS) Client Support

The ability to query spatial geometries from a Web Feature Service (WFS) server has been added.

Interoperability Improved Interoperability User Interface

The user interface of the "Interoperability" application has been significantly enhanced to better support new capabilities including Spatial Data Streaming, Web Feature Service (WFS) client and graphical source selective posting and erase operations. Included also is graphical interface for defining the "Where" clause search criteria.

Technical Requirements



This document contains information regarding:

1. Installation Requirements 2. Minimum Profile 3. Database Requirements 4. Modeling Administrator Requirements 5. FME Desktop Extension Option 6. External GIS Integration Requirements 7. Network Requirements

More detailed installation information can be found in the Bentley Utilities Designer V8i (SELECTseries 3) documentation. For important additional information that is not included in the documentation, please reference the Bentley Utilities Designer V8i (SELECTseries 3) ReadMe document.

Installation Requirements

CD drive or access to the Internet is required for product installation.

The minimum system configuration for installation of Bentley Utilities Designer V8i:

Operating System

Windows 7 Windows 7 x64 Windows Vista Windows Vista x64 Windows XP Professional (SP2 or later) Windows XP Professional x64 Windows Server 2003 (SP1 or later) Windows Server 2003 x64 Windows Server 2008 (SP2 or later, Standard and Enterprise editions) x64 Windows Server 2008 (R2 , Standard and Enterprise editions) x64

(Windows NT, Windows 2000 and Windows 9x series are not supported)

Microsoft Internet Explorer v6.0 or later with 128-bit cipher strength.

Virtualized Environments

Citrix XenApp 5.0 64-bit using Microsoft Windows Server 2008

Software Prerequisites

The Prerequisites for Bentley Desktop Applications v08.11.07.03 or higher needs to be installed to your workstation prior to the installation of Bentley Utilities Designer V8i (SELECTseries 3).



The Prerequisites for Bentley Desktop Applications needs to be installed on your system once, and only needs to be reinstalled if you are installing a later version of Bentley Utilities Designer that requires an updated prerequisite pack.

The Prerequisites for Bentley Desktop Applications is available from the Web Downloads / MySELECT CD area of SELECTservices Online and includes the following components:

1. Windows Installer Version 3.1v2 2. Microsoft .NET Framework 3.5 3. Microsoft XML Parser (MSXML) 6 SP 1 (32-bit and 64-bit) 4. Microsoft Visual Basic for Applications core 5. Microsoft Visual Basic for Applications localized 6. DirectX 9c 7. DHTML Editing Control for Applications (with Vista compatibility)

Minimum Profile

The minimum recommended workstation profile for installing and running Bentley Utilities Designer is:

Processor Intel© or AMD© processor 3.0 GHz or greater.

Memory 2 GB minimum, 4 GB or more recommended.

Additional memory will almost always improve performance, particularly when working with larger data sets.

Hard Disk 2 GB free disk space minimum

This includes space for temporary installation files, product setup packages, required prerequisite pack installation, ~850 MB footprint for Bentley Utilities Designer V8i (SELECTseries 3), and ~300 MB in user data (configuration files, data files, examples, etc.)

Video Graphics card supported by DirectX 9.0c

See the graphics card manufacturer for latest information on DirectX drivers. 256 MB of video RAM or higher is recommended. If insufficient video RAM or no graphics card supported by DirectX can be found, MicroStation attempts to use software emulation. For optimal performance, graphics display color depth should be set to 24-bit or higher. When using a color depth setting of 16-bit, some inconsistencies will be noted.

http://appsnet.bentley.com/myselectcd/default.aspxhttp://appsnet.bentley.com/myselectcd/default.aspxhttp://selectservices.bentley.com/http://www.microsoft.com/windows/directx/productinfo/default.mspx



Database Requirements

Bentley Utilities Designer V8i (SELECTseries 3) can be implemented using number of different persistence models, including models that leverage Oracle and SQL Server databases.

Oracle

When implementing Bentley Utilities Designer V8i (SELECTseries 3) with DGN/Oracle or Oracle Spatial persistence, the minimum requirements are:

Server Oracle Database 11g Release 2 Standard Edition, Standard Edition One, Enterprise Edition

Oracle Database 11g Release 1 Standard Edition, Standard Edition One, or Enterprise Edition

Oracle Database 10g Release 2 Standard Edition, Standard Edition One, or Enterprise Edition (Version 10.2.0.4 or higher)

Oracle Database 10g or 11g Express Edition***

Client Oracle Database 11g Release 2 Full Client Installation *

Oracle Database 11g Release 1 Full Client Installation *

Oracle Database 10g Release 2 Full Client Installation **

* Required for those users planning to leverage direct connections to Oracle Spatial databases. Installation and use of an Oracle 11g 32-bit client is required for all Microsoft Windows 32-bit and 64-bit operating systems. Use of Oracle 11g 64-bit clients are not supported at this time.

** For those users not planning to make use of Oracle Spatial functionalities (e.g. RDBMS properties only, no geometries) the Oracle 10g and Oracle 11g full client installations are supported since these capabilities make use of the underlying MicroStation database server support.

*** For Oracle Express Edition installations, both client and server must be installed together on the client workstation. Due to the limitations in the Express Edition functionality, not all of Bentley Utilities Designer capabilities might be available.

Patches For Oracle 10g server instances, patches 6056355 and 6330165 are required for users working with topology.

For Oracle 11g server instances running on Intel platforms, please see the Known Issues section for information regarding required version and patch set numbers for users working with Oracle Spatial 3D geometries.

Microsoft SQL Server

When implementing Bentley Utilities Designer V8i (SELECTseries 3) with DGN/SQL Server or SQL Server Spatial persistence, the minimum requirements are:

known_issues.htmknown_issues.htm



Server SQL Server 2012 Enterprise or Standard Edition SQL Server 2008 R2, Enterprise or Standard Edition SQL Server 2008 R2, or 2012 Express†

Client SQL Server 2008 R2 Client Tools SQL Server 2012 Client Tools

† For SQL Server Express installations, both client and server must be installed together on the client workstation. Due to the limitations in the Express functionality, not all of Bentley Utilities Designer capabilities might be available.

Modeling Administrator Requirements

In Bentley Utilities Designer, data model definitions and macro routines used to generate a working Bentley Utilities Designer setup are stored in Microsoft Excel 97-2003 Worksheets. Adjusting the standard data models delivered with the product, or creating new data models, will need a working version of Microsoft Excel.

Prerequisite Product

Microsoft Excel 97 or higher

FME Desktop Extension Option

To be able to leverage advanced GIS interoperability capabilities, an installation of FME Desktop software must be installed and properly licensed prior to installation of the Bentley Utilities Designer FME Extension option.

Prerequisite Product

FME Desktop Version 2010 Service Pack 4 (SP4) Windows 32-bit FME Desktop Version 2011 Service Pack 1 (SP1) Windows 32-bit FME Desktop Version 2012 Service Pack 1 (SP1) Windows 32-bit

Language English

External GIS Integration Requirements

Integration with an external GIS is typically implemented using Bentley Utilities Designer’s Life Data Exchange (LDE).

GE Smallworld

LDE Integration requires the use of Smallworlds TICS (Transport Independent Client/Server) for communication between server and client.



Note that TICS is deprecated at Smallworld core 4.3 and will not be supported in future Smallworld releases. Effectively, the following Smallworld versions are supported:

1. Version 3.1 2. Version 3.3 3. Version 4.0 Classic or Smallworld Application Framework 4. Version 4.1 Classic or Smallworld Application Framework 5. Version 4.2 Classic or Smallworld Application Framework 6. Version 4.3 Classic or Smallworld Application Framework

Network Requirements

For DGN/Oracle, Oracle Spatial, DGN/SQL Server, and SQL Server Spatial persistence, Bentley Utilities Designer V8i (SELECTseries 3) will typically be configured in a LAN or comparable setup, leveraging file and database servers, accessed by one or more Bentley Utilities Designer clients.

Minimum network requirements are:

Bandwidth 500 Mbit/s minimum, 1 Gbit/s or higher recommended

In networking, bandwidth represents the overall capacity of the connection. The greater the capacity, the more likely that better performance will result. Note that the numbers given here reflect actual, not theoretical throughput.

Latency < 5 ms minimum, < 1 ms recommended

Besides Bandwidth, latency is a factor that has a major impact on network speed. The term latency refers to any of several kinds of delays typically incurred in processing of network data. A low latency network improves performance.

Quick Installation


Quick Installation

The following guidelines should be reviewed prior to Bentley Utilities Designer product installation:

1. When installing or uninstalling Bentley Utilities Designer V8i (SELECTseries 3), you must be logged on with Administrator rights.

2. Installation of Bentley Utilities Designer V8i (SELECTseries 3) on Windows 2000 is not supported. For more information on supported operating systems, see the "Technical Requirements" section.

3. Bentley Utilities Designer V8i (SELECTseries 3) requires software libraries (DLLs) that are delivered with Microsoft's Internet Explorer version 6.0 (or greater). Because of this, make sure Internet Explorer 6.0 (or later) is installed on your computer before you install the Bentley Utilities Designer V8i (SELECTseries 3) release. You do not need to change your default Web browser if it is currently something other than Internet Explorer. Refer to http://www.microsoft.com/windows/ie/default.htm for more information regarding Internet Explore.

4. It is highly recommended that you close any programs and disable any antivirus software that is running prior to the installation of this software. Be sure to turn on your antivirus software once product installation has been completed.

5. Bentley Utilities Designer V8i (SELECTseries 3) also requires that the "Prerequisites for Bentley Desktop Applications v08.11.09" be installed to your workstation prior to installation. See the "Technical Requirements" section for additional information.

To install this product without Workflow Manager

Note: If you plan to support Job workflows and cost estimation, please see the instructions To install this product with Workflow Manager on SQL Server or To Install this product with Workflow Manager on Oracle.

Pre-Installation steps:

1. Run the self-extracting executable Setup_UtilitiesDesigner_08.11.09.xxx 2. In the Extract Screen, select “Extract install package only” 3. Find and review the readme_installation.chm. 4. Set up your database of choice. 5. From the extract folder, run the Setup.exe. 6. In the prerequisites screen, press the Install button. Prerequisites are installed and an install

wizard appears for this product.

Installation Wizard steps:

1. In the “Welcome” screen, press the Next button. 2. In the “End-User Agreement” screen, click on the check box that reads, "I accept the terms

in the License Agreement", and press the Next button. 3. In the “Destination Folder” screen, change default paths as necessary and press on the Next

button. 4. In the “Configure Shortcuts” screen, click on the shortcuts you would like to create and

press the Next button. 5. In the “Choose Setup Type” screen, press the Custom button.

http://www.microsoft.com/windows/ie/default.htm

Quick Installation


6. In the "Product Features" screen, unselect Workflow Manager and other features that are not required and press the Next button.

7. In the “Ready to install Bentley Utilities Designer V8i (SELECTseries 3)…” screen, press the install button. The product installs. When it is done the screen returns to the prerequisites screen.

8. Press the Finish button.

To install this product with Workflow Manager on SQL Server

Notes: See the instructions "To attach the sample database to SQL Server for the Workflow Manager" prior to executing these installation steps. When choosing to install on SQL Server, the installed configuration will be pre-configured to work with a SQL Server Spatial database. Please see the instructions "To use the sample Microsoft SQL Server spatial schema" describing how to set up this environment.








press the Next button. 5. In the “Choose Setup Type” screen, press the Typical button. 6. In the “Microsoft SQL Server database name and Server name” screen, enter the Default

database name and host Server name, and press the Next button. 7. In the “Ready to install Bentley Utilities Designer V8i (SELECTseries 3)…” screen, press the

Install button. The product installs. When it is done the screen returns to the prerequisites screen.


Note: If the SQL Server Native Client is missing, a "Microsoft SQL Server Requirements Missing" screen displays after Step 6. You will need to manually create a DSN named "CHDATA" post installation to correct the issue.

To install this product with Workflow Manager on Oracle

Note: See the instructions "To create an Oracle instance for the Workflow Manager" and "To load the database for the Workflow Manager" prior to executing these installation steps.

Quick Installation









press the Next button. 5. In the “Choose Setup Type” screen, press the Custom button. 6. In the "Product Features" screen, unselect features that are not required and press the Next

button. 7. In the "Database Type" screen, select "Oracle" and press the Next button. 8. In the “Oracle Service Name” screen, enter the Oracle service name and press the Next

button. 9. In the "VGIS" screen, press the Next button. 10. In the "WMS" screen, press the Next button. 11. In the “Ready to install Bentley Utilities Designer V8i (SELECTseries 3)…” screen, press the

Install button. The product installs. When it is done the screen returns to the prerequisites screen.


Note: If the Oracle Client is missing, an "Oracle Requirements Missing" screen displays after Step 8. You will need to manually create a DSN named "CHDATA" post installation to correct the issue.

To attach the sample database to SQL Server for the Workflow Manager

1. Copy the database files, BUDV8i.mdf and BUDV8i.ldf, in the extracted SQL Server database folder into the SQL Server Data folder (e.g. C:\Program Files (x86)\Microsoft SQL Server\MSSQL11.SQLEXPRESS\MSSQL\DATA)

2. Run SQL Server Management Studio and connect to your Server. 3. In the Object Explorer, find the Databases folder for the server, and Right-Click on the

Database folder. A popup menu appears. 4. Select the Attach entry in the popup menu. The "Attach Databases" dialog appears. 5. In the Attach Databases dialog, press the Add button. The "Locate Database Files" dialog

appears. 6. In the "Locate Database Files" dialog, navigate to the BUDV8i.mdf file, select the file, and

press the OK button. 7. In the "Attach Databases" dialog, press the OK button.

Quick Installation


To create an Oracle database instance for the Workflow Manager

Note: It is recommended that the following steps be performed by an Oracle DBA. If you are not a DBA, please refer to Oracle documentation for further instructions on Oracle.

Install Oracle Server and create a new database. The initialization parameters should be as follows:

Oracle Release

Initial Settings

9.2.0.1.0 O7_DICTIONARY_ACCESSIBILITY = TRUE COMPATIBLE = 9.2.0.0.0

CURSOR_SHARING = SIMILAR

DB_BLOCK_SIZE = 8192

DB_CACHE_SIZE = 900000000

MAX_ENABLED_ROLES = 50

OPEN_CURSORS = 2500

OS_AUTHENT_PREFIX =

PROCESSES = 220

REMOTE_OS_AUTHENT = TRUE

UNDO_MANAGEMENT = AUTO

UNDO_RETENTION = 10800

10.2.0.1.0 O7_DICTIONARY_ACCESSIBILITY = TRUE CURSOR_SHARING = SIMILAR



OPEN_CURSORS = 2500

OS_AUTHENT_PREFIX =

PROCESSES = 220




11.1.0.6.0 O7_DICTIONARY_ACCESSIBILITY = TRUE SEC_CASE_SENSITIVE_LOGIN = FALSE




OPEN_CURSORS = 2500

OS_AUTHENT_PREFIX =

PROCESSES = 220




11.2.0.x O7_DICTIONARY_ACCESSIBILITY = TRUE SEC_CASE_SENSITIVE_LOGIN = FALSE




OPEN_CURSORS = 2500

OS_AUTHENT_PREFIX =

PROCESSES = 220




Select “UTF8” for both Database Character Set and National Character Set.

To load the Oracle database for the Workflow Manager

Note: It is recommended that the following steps be performed by an Oracle DBA. If you are not a DBA, please refer to Oracle documentation for further instructions on Oracle.

Quick Installation


Note: Step 9 is to facilitate an initial user who would further configure other users. Other users can be added using the “User Manager Dialog” in Workflow Manager. Please refer to Bentley Utilities Designer Help for further details.

If you have not created a database instance, please refer to the instructions, “To create an Oracle database instance for the Workflow Manager”.

1. Find the Database folder located in the extracted installation folder, typically “C:\ BentleyDownloads\ UtilitiesDesigner_08.11.09.xx\Database”.

2. Copy the Oracle dump file BUDV8i.dmp from the “Database\ BUDRefDBDump” sub folder to the “Database\LoadFromDump\New” sub folder.

3. Enter the sub folder “Database\LoadFromDump\New”. 4. Open the new_db.bat file for editing. 5. Change the password and instance name for the "sys" user of the database (6 entries). For

example, replace “sys/chadmin@ ED01” with your “sys/password@net_service_name”. 6. Change the name of the dump file to BUDV8i.dmp. 7. Edit the tablespace.sql file and change the paths to the correct location for tablespaces to

be created in your database instance. 8. Edit the new_edusers.sql file and add the required users who will use Bentley Utilities

Designer. Bentley Utilities Designer uses OS Authentication to connect to Oracle. User names must be the same as Windows login names.

9. Run the batch file new_db.bat. 10. Review the log file DB_IMPORT.log for errors. Table drop error can typically be ignored. 11. Log into SQLPLUS as sys user and execute ( = one of the users added in Step 8):

update chdata.userlogin set username='', firstname='Firstname', lastname='Lastname' where username='administrator'; commit;

Note: This step is to facilitate an initial user who would further configure other users. Other

users can be added using the “User Manager Dialog” in Workflow Manager. Please refer to

Bentley Utilities Designer Help for further details.

Test the database with OS Authentication from the command prompt by executing the statement “sqlplus /@net_service_name”. If this fails, please refer to Oracle documentation to set up OS Authentication correctly.

To use the sample Microsoft SQL Server spatial schema

Attach the sample spatial database provided, following the same steps described in “To attach the sample database to SQL Server for the Workflow manager”.

1. Open the file BUD_SSS2T-PostRegFtrs.xml using Bentley Geospatial Administrator. This file can be found in the Bentley Utilities Designer install location, in the subfolder "\datamodel\BentleyUD\".

2. In the Schema tab, navigate to Graphical Sources|SQL Server Spatial Connection|Named Connection.

3. Change the Host value to match the machine hosting your database. 4. Export the schema. 5. Run the batch file CopySS

Readme 08.11 - Bentley...Bentley Utilities Designer integration with Oracle Spatial is one of the...

Documents

Transcript of Readme 08.11 - Bentley...Bentley Utilities Designer integration with Oracle Spatial is one of the...