CADWorx Installation Guide
CADWorx Installation Guide
Installation
23
Tuesday, June 27, 2023
Copyright
Copyright © 2003 - 2023 Intergraph Corporation and/or its subsidiaries and affiliates. All rights reserved.
This computer program, including software, icons, graphic symbols, documentation, file formats, and audio-visual displays; may be
used only as pursuant to applicable software license agreement; contains confidential and proprietary information of Intergraph
Corporation or a Hexagon Group Company and/or third parties which is protected by patent, trademark, copyright law, trade secret law,
and international treaty, and may not be provided or otherwise made available without proper authorization from Hexagon AB and/or its
subsidiaries and affiliates.
Documentation
Documentation shall mean, whether in electronic or printed form, User's Guides, Installation Guides, Reference Guides,
Administrator's Guides, Customization Guides, Programmer's Guides, Configuration Guides and Help Guides delivered with a
particular software product.
Other Documentation
Other Documentation shall mean, whether in electronic or printed form and delivered with software or on Smart Community,
SharePoint, box.net, or the Hexagon documentation web site, any documentation related to work processes, workflows, and best
practices that is provided by Hexagon as guidance for using a software product.
Terms of Use
a. Use of a software product and Documentation is subject to the Software License Agreement ("SLA") delivered with the software
product unless the Licensee has a valid signed license for this software product with Intergraph Corporation, Hexagon’s Asset
Lifecycle Intelligence Division ("Hexagon"), a Hexagon Group Company. If the Licensee has a valid signed license for this
software product with Hexagon, the valid signed license shall take precedence and govern the use of this software product and
Documentation. Subject to the terms contained within the applicable license agreement, Hexagon gives Licensee permission to
print a reasonable number of copies of the Documentation as defined in the applicable license agreement and delivered with the
software product for Licensee's internal, non-commercial use. The Documentation may not be printed for resale or redistribution.
b. For use of Documentation or Other Documentation where end user does not receive a SLA or does not have a valid license
agreement with Hexagon, Hexagon grants the Licensee a non-exclusive license to use the Documentation or Other
Documentation for Licensee’s internal non-commercial use. Hexagon gives Licensee permission to print a reasonable number of
copies of Other Documentation for Licensee’s internal, non-commercial use. The Other Documentation may not be printed for
resale or redistribution. This license contained in this subsection b) may be terminated at any time and for any reason by
Hexagon by giving written notice to Licensee.
Disclaimer of Warranties
Except for any express warranties as may be stated in the SLA or separate license or separate terms and conditions, Hexagon
disclaims any and all express or implied warranties including, but not limited to the implied warranties of merchantability and fitness for
a particular purpose and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or
amendment of such disclaimer. Hexagon believes the information in this publication is accurate as of its publication date.
The information and the software discussed in this document are subject to change without notice and are subject to applicable
technical product descriptions. Hexagon is not responsible for any error that may appear in this document.
The software, Documentation and Other Documentation discussed in this document are furnished under a license and may be used or
copied only in accordance with the terms of this license. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE FINAL
EVALUATION AS TO THE USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.
Hexagon is not responsible for the accuracy of delivered data including, but not limited to, catalog, reference and symbol data. Users
should verify for themselves that the data is accurate and suitable for their project work.
CADWorx Installation 2
Limitation of Damages
IN NO EVENT WILL HEXAGON BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL INCIDENTAL, SPECIAL, OR
PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO, LOSS OF USE OR PRODUCTION, LOSS OF REVENUE OR PROFIT,
LOSS OF DATA, OR CLAIMS OF THIRD PARTIES, EVEN IF HEXAGON HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
UNDER NO CIRCUMSTANCES SHALL HEXAGON'S LIABILITY EXCEED THE AMOUNT THAT HEXAGON HAS BEEN PAID BY
LICENSEE UNDER THIS AGREEMENT AT THE TIME THE CLAIM IS MADE. EXCEPT WHERE PROHIBITED BY APPLICABLE
LAW, NO CLAIM, REGARDLESS OF FORM, ARISING OUT OF OR IN CONNECTION WITH THE SUBJECT MATTER OF THIS
DOCUMENT MAY BE BROUGHT BY LICENSEE MORE THAN TWO (2) YEARS AFTER THE EVENT GIVING RISE TO THE CAUSE
OF ACTION HAS OCCURRED.
IF UNDER THE LAW RULED APPLICABLE ANY PART OF THIS SECTION IS INVALID, THEN HEXAGON LIMITS ITS LIABILITY TO
THE MAXIMUM EXTENT ALLOWED BY SAID LAW.
Export Controls
To the extent prohibited by United States or other applicable laws, Intergraph Corporation, Hexagon's Lifecycle Intelligence division
("Hexagon"), and a Hexagon Group Company's commercial-off-the-shelf software products, customized software, Technical Data,
and/or third-party software, or any derivatives thereof, obtained from Hexagon, its subsidiaries, or distributors must not be exported or
re-exported, directly or indirectly (including via remote access) under the following circumstances:
a. To Cuba, Iran, North Korea, Syria, or the Crimean, "Donetsk People's Republic", "Luhansk People's Republic," or Sevastopol
regions of Ukraine, or any national of these countries or territories.
b. To any person or entity listed on any United States government denial list, including, but not limited to, the United States
Department of Commerce Denied Persons, Entities, and Unverified Lists, the United States Department of Treasury Specially
Designated Nationals List, and the United States Department of State Debarred List. Visit www.export.gov for more information
or follow this link for the screening tool: https://legacy.export.gov/csl-search https://legacy.export.gov/csl-search.
c. To any entity when Customer knows, or has reason to know, the end use of the software product, customized software,
Technical Data and/or third-party software obtained from Hexagon, its subsidiaries, or distributors is related to the design,
development, production, or use of missiles, chemical, biological, or nuclear weapons, or other un-safeguarded or sensitive
nuclear uses.
d. To any entity when Customer knows, or has reason to know, that an illegal reshipment will take place.
Any questions regarding export/re-export of relevant Hexagon software product, customized software, Technical Data, and/or
third-party software obtained from Hexagon, its subsidiaries, or distributors, should be addressed to Hexagon’s Export Compliance
Department, 305 Intergraph Way, Madison, Alabama 35758 USA or at [email protected]. Customer shall hold
harmless and indemnify Hexagon and a Hexagon Group Company for any causes of action, claims, costs, expenses and/or damages
resulting to Hexagon or a Hexagon Group Company from a breach by Customer.
Trademarks
Intergraph®, the Intergraph logo®, Intergraph Smart®, SmartPlant®, SmartMarine, SmartSketch®, SmartPlant Cloud®, PDS®,
FrameWorks®, I-Route, I-Export, ISOGEN®, SPOOLGEN, SupportManager®, SupportModeler®, SAPPHIRE®, TANK, PV Elite®,
CADWorx®, CADWorx DraftPro®, GTSTRUDL®, CAESAR II® , and HxGN SDx® are trademarks or registered trademarks of Intergraph
Corporation or its affiliates, parents, subsidiaries. Hexagon and the Hexagon logo are registered trademarks of Hexagon AB or its
subsidiaries. Other brands and product names are trademarks of their respective owners. Microsoft, and Windows are registered
trademarks of Microsoft Corporation. Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation,
and/or its affiliates. AutoCAD, ObjectARX, and RealDWG are trademarks of Autodesk. HOOPS is a trademark of Tech Soft 3D, L.L.C.
Other brands, and product names are trademarks of their respective owners.
CADWorx Design Review contains Autodesk® RealDWG by Autodesk, Inc., copyright © Autodesk, Inc. All rights reserved. Autodesk,
Inc., 111 McInnis Parkway, San Rafael, California 94903 ("Autodesk") is a third-party beneficiary to this Agreement to the extent that
the Software Product contains RealDWG, and to the extent that the provisions herein relate to Licensee’s use of the Software Product
containing RealDWG. Such provisions are made expressly for the benefit of Autodesk, and are enforceable by Autodesk in addition to
Intergraph. BricsCAD is a registered trademark of Bricsys NV. Chapoo is a registered trademark of Chapoo NV. KunHengCAD is a
registered trademark of Beijing Kunheng Software Technology Co., Ltd.
CADWorx Installation 3
Introduction to CADWorx Installation
Contents
Introduction to CADWorx Installation ....................................................................................................... 5
What's New in CADWorx Installation ...................................................................................................... 6
Installation .................................................................................................................................................... 9
Quick Start .............................................................................................................................................. 9
CADWorx Installation .............................................................................................................................. 9
Install in Silent Mode ...................................................................................................................... 11
Setup Profile ................................................................................................................................... 14
Software Installation on Network Drive ................................................................................................. 15
Licensing .................................................................................................................................................... 18
Uninstall...................................................................................................................................................... 19
Uninstall CADWorx ............................................................................................................................... 19
Uninstall in Silent Mode .................................................................................................................. 19
Index ........................................................................................................................................................... 56
CADWorx Installation 4
SECTION 1
CADWorx Installation 5
What's New in CADWorx Installation
Version 23
The following changes have been made for this release:
CADWorx is now compatible with AutoCAD 2023 and 2024. For more information, see
CADWorx Software Recommendations (page 7).
CADWorx is now compatible with BricsCAD 23.2.06. For more information, see CADWorx
Software Recommendations (page 7).
CADWorx Installation 6
SECTION 2
Hexagon AB has confirmed compatibility with the currently listed versions of AutoCAD.
When you install with an AutoCAD vertical, CADWorx will run by default on AutoCAD without
the vertical. You can load CADWorx into the vertical by adding the CADWorx profile settings
into the AutoCAD vertical profile.
For the most up to date AutoCAD system requirements, check the Autodesk website.
Beginning with Windows 10 and Oracle 12.1.0.2, Microsoft and Oracle will enforce the
Internet Host Table Specification RFC 952 which mandates that component hostname labels
can contain only alphanumeric characters. Host names using underscores (‘_’) are not
CADWorx Installation 7
CADWorx Software Recommendations
allowed. Refer to Oracle Support Articles 1603775.1 and 1957895.1 and Microsoft KB
101785.
CADWorx may not be compatible with BricsCAD versions newer than those listed.
Hexagon AB has confirmed compatibility with the currently listed versions of BricsCAD.
For the most up to date BricsCAD system requirements, check the BricsCAD website.
Beginning with Windows 10 and Oracle 12.1.0.2, Microsoft and Oracle will enforce the
Internet Host Table Specification RFC 952 which mandates that component hostname labels
can contain only alphanumeric characters. Host names using underscores (‘_’) are not
allowed. Refer to Oracle Support Articles 1603775.1 and 1957895.1 and Microsoft KB
101785.
CADWorx Installation 8
SECTION 3
Installation
Install CADWorx on the system hard drive using the setup.exe installation file located on the
CADWorx product CD. The installation process is relatively simple. As you go through the
installation process, the software prompts you for required information.
If Autorun is enabled, the setup procedure starts when you insert the CD into the
CD-ROM drive. If the installation does not start automatically, double-click setup.exe
Quick Start
1. Run the SETUP.EXE.
2. To start CADWorx, click the icon created during installation.
3. Follow the dialogs will carry the user through the rest of the installation.
4. First time run of the program will require certain startup parameters to be set. Most of the time,
the defaults will be sufficient.
CADWorx Installation
The installation is similar to most other Windows installations. The following information is
required:
What drive is used?
Which version of CAD does CADWorx use?
Where will CADWorx be installed?
When installing a new version of CADWorx, the CAD profile settings are reset. When
updating to a new version of CADWorx the CAD profile settings are not reset.
You must be logged in with administrator privileges to run the installer. If you do not have those
privileges, the software prompts you to run as an administrator. You must also have elevated
privileges to run the silent install instructions. Run and close the CAD platform you plan to install
on one time before you install CADWorx.
To install CADWorx
1. Open the media received from Hexagon, then double-click to run CADWorxSetup.exe.
2. Click Start Setup.
If you have a previous version of CADWorx installed, the software prompts you
with the option to uninstall it before installing the current version.
Click Continue to install the current version and retain the previous version.
Click Uninstall to remove the previous version prior to installing the current version.
CADWorx Installation 9
Installation
8. Type the location drive and folder in Install Path, or click the browse ellipsis to navigate
to a folder. To use the default, click Next.
9. Clear Run Redistribute if you want to manually install redistributables later.
You must install the redistributables at a later time for the software to
function correctly.
10. Select the I agree to the license agreement and conditions check box, and then click
Install.
11. If the User Account Control dialog box displays, click Yes.
During the installation process, a progress bar displays along with the status of the installation
process.
To view the readme, select the View Readme check box. The readme file displays
after you click Finish.
12. Click Finish.
CADWorx Installation 10
Installation
9. Click each product name, except for Specification Editor and Object Enabler, to expand
each software selection, and then type the serial number provided by Hexagon.
10. Select the platform version with which to run CADWorx.
11. Type the location drive and folder in Install Path or click Browse to navigate to a folder. To
use the default, click Next.
12. Clear Run Redistribute if you want to manually install redistributables later.
You must install the redistributables at a later time for the software to
function correctly.
13. Select the I agree to the license agreement and conditions check box, and then click
Install.
14. If the User Account Control dialog box displays, click Yes.
During the installation process, a progress bar displays along with the status of the installation
process.
To view the readme, select the View Readme check box. The readme file displays
after you click Finish.
15. Click Finish.
If you need to modify the license type after installation, you can re-run the
installation process. During the installation process, a progress bar displays along with the
status of the installation process.
You must have administrative level rights to run the installer in silent mode. You must select
Run as Administrator from the right-click menu when stating the DOS prompt.
Ensure you are in the directory of the Setup.exe file.
Example:
[Root Directory]\CADWorxSetup.exe /install /silent /log "C:\SetupLog.log"
USERNAME="HexagonUser" COMPANYNAME="Hexagon" TARGETDIR="C:\CADWorx 23"
SLAACCEPT="YES" BCAD_VERSION="BCAD|2023"
ADDLOCAL="CORE_FEATURE,PLANT_FEATURE,SPECEDITOR_FEATURE,EQUIPMENT_F
EATURE,EQUIPMENTEDITOR_FEATURE,PIDPRO_FEATURE,STRUCTURE_FEATURE,STR
UCTUREEDITOR_FEATURE,CDR_FEATURE,OBJECTENABLER_FEATURE"
PLANT_SERIALNUM="00000000000000" PIDPRO_SERIALNUM="000000000000000"
STRUCTURE_SERIALNUM="00000000000000" RUN_REDISTRIBUTE="YES"
UNINSTALL_PREVIOUS_VERSION="YES"
The installer modify feature can only be performed through Add/Remove Programs.
All values must be typed with quotations.
CADWorx Installation 11
Installation
TARGETDIR Specifies the location folder for the Ex: "C:\CADWorx 23"
CADWorx install. Any available
location on your machine.
CADWorx Installation 12
Installation
CADWorx Installation 13
Installation
Setup Profile
Enables you to start CADWorx in different versions of the CAD platform. You need to run the
Setup_Profile utility with Administrator privileges.
Select CADWorx
Enables you to select the version and product you want to run.
CADWorx Version
Specifies the version of CADWorx you want to run.
CADWorx Product Location
Specifies the location of the CADWorx installation for the product you select from the
Product List.
Product List
Specifies the product you want to run, such as Plant or P&ID.
Select the CAD platform
Enables you to select the version of the CAD platform you want to run for the CADWorx
version.
CAD Product Location
CADWorx Installation 14
Installation
Specifies the location of the CAD platform version selected in the CAD Version List.
CAD Version List
Specifics the version of CAD platform you want to run. This list only displays available and
supported versions of the CAD platform.
CADWorx Installation 15
Installation
to move folders to a user-specified location. For more information, see Setup in the CADWorx
Help.
When the software is installed on a network drive, each client computer must contain the
command line directives in the icon to properly locate and run the software. The easiest way to
create the icon is to run the CADWorx Setup Profile on the client computer.
Prerequisites:
You must map the network location to a drive. When you install to a Universal Naming
Convention location, manually update the profile settings after running the settings on the
client computer. Map the network location to a drive such as U:\ for example.
The drive letter that you select for the mapped drive of the network location must match the
mapped drive letter on the client location. For example, if you install CADWorx Plant from
computer X on the mapped drive U:\ to the CADWorx folder, then that same mapped drive
letter U:\ on another client computer must point to the same location.
You must install the same version of AutoCAD or BricsCAD in the same location on both the
network computer and the client computer. For example, you install AutoCAD on the network
computer, and CADWorx on the network computer, then you must also install AutoCAD 2018
on the client computer.
The install network computer and the client computer must be located on the same network or
domain.
You must allow the client computer the same levels of read/write access to folders outlined in
the Installation Guide.
CADWorx Installation 16
Installation
5. Copy the CADWorx icon shortcuts from the network computer desktop to the client
computer.
6. Run CADWorx Plant, Structure, Equipment, P&ID, or any of the other software shipped with
the CADWorx installation.
CADWorx Installation 17
SECTION 4
Licensing
CADWorx supports Intergraph Smart® Licensing. For complete installation and configuration
instructions, see the Smart Licensing documentation.
CADWorx Installation 18
SECTION 5
Uninstall
Uninstall instructions for CADWorx are as follows.
Uninstall CADWorx
1. Click Start > Control Panel.
2. Under Programs, click Uninstall a program.
3. On the Uninstall or change a program list, double-click CADWorx (version). Alternatively,
click CADWorx (version), and then click Change.
4. Click Modify.
5. Select Uninstall.
6. If you receive the User Account Control dialog box, click Yes.
CADWorx removes.
7. Click Finish.
The uninstall closes.
CADWorx Installation 19
SECTION 6
Database Setup
Database setup is optional for CADWorx. This section is provided for those clients who choose to
use a Database with CADWorx.
ODBC Drivers
All databases associated with CADWorx use 64 bit ODBC (Open DataBase Connectivity) drivers.
CADWorx will install the required ODBC drivers if they are not already present.
After you install the software, the CADWorx User Data Sources list displays:
CADWorx Installation 20
Database Setup
ODBC drivers that are configured correctly ensure that CADWorx performs correctly. The
following figures show the ODBC driver information.
CADWorx Installation 21
Database Setup
CADWorx Installation 22
Database Setup
CADWorx Installation 23
Database Setup
To set up an SQL Server data source name, review the instructions in the [Product
Folder]\System\SQLServer.txt file. The following figure shows the SQL Server data source.
CADWorx Installation 24
Database Setup
1. Start the ODBC Administrator from the Control Panel to setup the Oracle ODBC Driver.
Please make certain you are running the latest version of the ODBC Administrator and ODBC
Drivers To check the version, go to the About Tab. The latest version of ODBC can be found
on the Microsoft Web Site.
2. Hit the Add button, and select Oracle ODBC Driver. The name "Oracle in
OraDb11g_home1" may be different on your system.
3. In the next dialog, type in the following:
For CADWorx P&ID:
Data Source Name: P&ID_ORACLE
Service Name: CWORA11g
The Data Source Name must be P&ID_ORACLE. The service name can be whatever you
selected for the database name.
For CADWorx Plant:
Data Source Name: PLANT_ORACLE
Service Name: CWORA11g
The Data Source Name has to be PLANT_ORACLE. The service name can be whatever
you selected for the database name.
For CADWorx IP:
Data Source Name: IP_ORACLE
Service Name: CWORA11g
The Data Source Name has to be IP_ORACLE. The service name can be whatever you
selected for the database name.
4. After the DSN is created, test the DSN by pressing the "Test Connection" button.
CADWorx Installation 25
Installing and Configuring Microsoft SQL Server 2012
Topics
Install Microsoft SQL Server 2012 ................................................. 26
Install any Required SQL Server 2012 Upgrades ......................... 30
Verify Automatic Startup of Microsoft SQL Server 2012 Services 30
Register the Microsoft SQL Server ................................................ 31
Assign System Administrator Privileges for SQL Server 2012 ...... 32
Create a SQL Server Database Alert ............................................ 33
SQL Server port assignments........................................................ 35
CADWorx Installation 26
Installing and Configuring Microsoft SQL Server 2012
2. From the Planning page, select System Configuration Checker to check for pre-requisite
applications and identify potential installation problems. You might have to restart your
computer if any pre-requisite applications were installed.
3. Click Installation, and then select the New SQL Server stand-alone installation or add
features to an existing installation option.
4. As you go through the installation process, make sure you install the Setup Support Files
and review any Setup Support Rules that identify potential problems.
5. Enter your SQL Server 2012 product key provided by Microsoft, and click Next.
6. Accept the license terms, and click Next.
CADWorx Installation 27
Installing and Configuring Microsoft SQL Server 2012
Wait while the SQL Server Setup files are installed on the computer.
7. Click Next.
8. Select SQL Server Feature Installation, and click Next.
CADWorx Installation 28
Installing and Configuring Microsoft SQL Server 2012
12. Define your instance name and the instance root directory. Click Next.
13. Verify the disk space requirements, and then click Next.
14. On the Server Configuration page, specify a domain account name with administrative
privileges on the system to be used. Also, set Automatic as the Startup Type and continue.
CADWorx Installation 29
Installing and Configuring Microsoft SQL Server 2012
A domain user account offers more flexibility and is typically used because many
server-to-server activities can be performed only with a domain user account, including
remote procedure calls, replication, and backing up network drives.
15. Select the Collation tab. Use locale-specific collation. These collation settings include the
character set, sort order, and other locale-specific settings.
18. Specify at least one SQL Server Administrator. You will need this administrator login later to
open SQL Server Management Studio.
19. Click Next, and complete the installation as prompted.
If any errors occur during installation, refer to the Summary Log for more information and contact
Intergraph Support for further assistance.
CADWorx Installation 30
Installing and Configuring Microsoft SQL Server 2012
2. Verify that the Status field is set to Started and the Startup Type field is set to Automatic, for
SQL Server (MSSQLSERVER).
The MSSQL service is appended with the named instance you specified when you
installed Microsoft SQL Server. For example, if you installed SQL Server as an instance
named Instance1, the service displays as MSSQL$Instance1.
3. To change the Status or Startup Type fields, right-click the service name, and select
Properties from the shortcut menu.
a. On the General tab, select Automatic from the Startup type list.
b. In the Service status section, click Start.
c. Click OK.
CADWorx Installation 31
Installing and Configuring Microsoft SQL Server 2012
4. Select Server Roles under the Select a page heading to display the Server Roles list.
5. In the Server Roles list, select the sysadmin check box.
Administrators need the sysadmin role. Standard users need public, db_datareader, and
db_datawriter database role membership mapping to each one of the CADWorx
databases. Standard users also need Execute permission to each database.
We do not recommend granting standard users db_owner permissions as it gives the
users a very high privilege to the database.
CADWorx Installation 32
Installing and Configuring Microsoft SQL Server 2012
6. Click OK.
4. Select New > Data Collector Set from the shortcut menu.
5. Type the name you want to use for the data collector set, click Create manually (Advanced),
and then click Next.
CADWorx Installation 33
Installing and Configuring Microsoft SQL Server 2012
9. Select the Microsoft SQL Server object in the Available counters section.
10. Select a counter in the Select counters from list list, and then click Add.
The new counter displays in the Added counters list.
Use CTRL+ or SHIFT+ to select multiple objects.
11. After all counters have been added, click OK to close the Add Counters dialog box.
To add local counters from a remote computer, you must have one of the following
permissions on the computer:
Local administrator privilege
Be a member of the Performance Monitor Users local group.
CADWorx Installation 34
Installing and Configuring Microsoft SQL Server 2012
12. Under the Performance counters list, select either Above or Below for the Alert when
value.
13. In the Limit box, enter a threshold value. Depending on the object you selected, the alert will
be generated when the value for the counter is more than or less than the threshold value.
Click Next to continue.
14. Click Finish.
Your new data collector set displays in the User Defined page.
15. To configure the alerts, double-click on your data collector set name and then right-click the
data collector. Select Properties from the shortcut menu.
16. On the Alerts tab, you can set additional alerts and define the unit of time for the duration of
the sample interval.
17. Set options in the Alert Action and Alert Task tabs to specify the actions to occur each time
the alert is triggered.
18. Click OK to close the Properties dialog box and activate the alert settings.
For more information about using System Monitor and setting up SQL Server
alerts, see the documentation delivered with Microsoft SQL Server and Windows Server.
1433 TCP From client to server; from server to client SQL Server Instance
CADWorx Installation 35
Installing and Configuring Microsoft SQL Server 2012
1434 UDP From client to server; from server to client SQL Browser
CADWorx Installation 36
APPENDIX A
Topics
Oracle Server Configuration .......................................................... 37
Install Oracle Database 11g Release 2 Server Software (11.2.0.2)
....................................................................................................... 38
Delete the Default Oracle Database .............................................. 42
Create the Smart 3D Oracle 11g Database................................... 42
Oracle Post-Installation Requirements .......................................... 51
CADWorx Installation 37
Appendix: Install and Configure Oracle Software
CADWorx Installation 38
Appendix: Install and Configure Oracle Software
12. Specify the Oracle Base location for the base folder and the Software Location for the home
folder by browsing to the location, and click Next.
13. Select General Purpose / Transaction Processing in the Select Configuration Type
screen, and click Next.
CADWorx Installation 39
Appendix: Install and Configure Oracle Software
14. Specify the Global database name and Oracle Service Identifier (SID) values in the
Specify Database Identifiers screen, and click Next.
CADWorx Installation 40
Appendix: Install and Configure Oracle Software
15. Select the Memory tab on the Specify Configuration Options screen, and select the
Enable Automatic Memory Management option. The percentage of memory allowed for an
instance of Oracle should not exceed 40%. If you have more than one Oracle instance on this
server, the allocated memory should not exceed 40% of the system memory.
16. Select the Character sets tab on the Specify Configuration Options screen and select the
Use Unicode (AL32UTF8) option.
All products in SmartPlant Enterprise that participate in integration should set their
encodings to Use Unicode (AL32UTF8) for the Database Character Set option, and to
AL16UTF16 - Unicode UTF-16 Universal character set for the National Character Set
option.
For more information about the Character sets option, see your Oracle installation
documentation.
17. Select the Security tab on the Specify Configuration Options screen, and choose your
security settings option.
18. Select the Sample Schemas tab on the Specify Configuration Options screen, and select
the Create database with sample schemas option. Click Next.
19. Select the Use Database Control for database management option on the Specify
Management Options screen. You can also enable notifications through email with this
option.
CADWorx Installation 41
Appendix: Install and Configure Oracle Software
20. Select File System in the Specify Database Storage Options screen and specify a
database file location. Click Next.
21. Specify your recovery options in the Specify Recovery Options screen, and click Next.
Do not enable Automated backups.
22. Specify your schema passwords in the Specify Schema Passwords screen, and click Next.
You must choose either the Use different passwords for these accounts or Use the same
password for all accounts option.
The software checks that all prerequisite software is installed on the computer.
23. Click Finish in the Summary screen.
24. Click Close after the installation process is finished.
See Also
Delete the Default Oracle Database (page 42)
Install and Configure Oracle Server Software (page 37)
CADWorx Installation 42
Appendix: Install and Configure Oracle Software
2. In the Database Configuration Assistant screen, select Create a Database, and click Next.
CADWorx Installation 43
Appendix: Install and Configure Oracle Software
3. In the Database Template screen, select the Custom Database option, and click Next.
4. Enter the name of the new database in the Database Identification screen. Generally, the
Global Database Name and the SID are identical. These names can be no longer than eight
characters.
CADWorx Installation 44
Appendix: Install and Configure Oracle Software
5. In the Management Options screen, click Next without changing the default selections.
Configure Enterprise Manager and Configure Database Control for local management
are the default options.
CADWorx Installation 45
Appendix: Install and Configure Oracle Software
6. In the Database Credentials screen, select a security option and provide the appropriate
information. Click Next.
7. On the Database File Locations screen, select File System and Use Common Location
for All Database Files. Browse to the appropriate files location, and click OK.
CADWorx Installation 46
Appendix: Install and Configure Oracle Software
A subfolder is created in the folder you choose and is named with the SID you provided earlier
in step 4.
8. Click Next.
9. If the database will not be used in a Global Workshare Configuration, select Specify Flash
Recovery Area in the Recovery Configuration screen, and click Next.
CADWorx Installation 47
Appendix: Install and Configure Oracle Software
If the database will be used in a Global Workshare Configuration, select Enable Archiving
and click Edit Archive Mode Parameters. Select Automatic Archiving to specify the
location of the archive log files.
CADWorx Installation 48
Appendix: Install and Configure Oracle Software
10. In the Database Content screen, select the Enterprise Manager Repository option and
click Next.
CADWorx Installation 49
Appendix: Install and Configure Oracle Software
11. Select the Memory tab on the Initialization Parameters screen and select the Typical
option. The percentage of memory allowed for an instance of Oracle should not exceed 40%.
If you have more than one Oracle instance on this server, the allocated memory should not
exceed 40% of the system memory.
12. On the Sizing tab, configure the Processes option based on this formula.
Processes ≈ (Maximum Number of Users * 10) + (Number of Oracle System Processes)
The number of Oracle system processes can vary based on the number of
background processes that are running. This number is a high estimate. Overestimate the
number to ensure it will only use the number of processes that the instance needs.
13. Select the Character Sets tab, and select the Use Unicode (AL32UTF8) option.
All products in SmartPlant Enterprise that participate in integration should set their
encodings to Use Unicode (AL32UTF8) for the Database Character Set option, and to
AL16UTF16 - Unicode UTF-16 Universal character set for the National Character Set
option.
For more information about the Character Set options, see your Oracle installation
documentation.
14. Select the Connection Mode tab, and select Dedicated Server Mode.
15. In the Connection Mode tab, select All Initialization Parameters.
16. Click Show Advanced Parameters.
CADWorx Installation 50
Appendix: Install and Configure Oracle Software
Name Value
db_files 1000
distributed_lock_timeout 180
open_cursors 3000
os_authent_prefix ""
processes 200
undo_retention 3600
17. Click Close after the changes have been made, and click Next on the Database
Configuration dialog box.
The control files should be divided among multiple physical hard drives. This file is
needed by the database to start.
18. Verify that the path in the Tablespaces folder is correct for SYSAUX, SYSTEM, TEMP,
UNDOTBS1, and USERS.
The information in the Datafiles and Redo Log Groups folders can retain the
default settings as long as the folder path does not need updating.
19. Create an additional Redo log file, and set the Redo log file size for each group to 512000 K.
20. Click Next.
The Creation Options screen allows you to save your database configuration as a
template file, and also allows you to generate database creation scripts.
Not every setting is preserved in the template file. If you re-use template
files, check the parameters carefully to verify the settings are correct.
21. When you have finished configuring the database, click Finish.
The first 15% of the creation process validates the configuration settings. After the
first 15% of the process has successfully passed, the database creation succeeds without any
errors.
22. After the Database Configuration Assistant completes the database creation, click Exit.
See Also
Oracle Post-Installation Requirements (page 51)
Install and Configure Oracle Server Software (page 37)
Appendix: Install and Configure Oracle Software (page 37)
CADWorx Installation 51
Appendix: Install and Configure Oracle Software
There is no need to have both Oracle Server and Oracle Client on the same
computer.
3. Make sure the Administrators, System, and Users Windows groups have full access to the
SharedContent folder on the reference data computer.
4. Make sure the Administrators and System account have full permissions to the Database
Templates folder.
CADWorx Installation 52
Appendix: Install and Configure Oracle Software
6. Select the product components to install in the Available Product Components screen, and
click Next.
7. Wait while the software performs the prerequisite checks, and click Next.
8. Click Install in the Summary screen and wait while Oracle client installs.
The Oracle Net Configuration Assistant displays.
CADWorx Installation 53
Appendix: Install and Configure Oracle Software
10. In the Welcome to the Oracle Net Configuration Assistant screen, click Next.
CADWorx Installation 54
Appendix: Install and Configure Oracle Software
For Oracle 11.2.0.2 32-bit client you must install Patch 22 now. Stop the service
OracleMTSRecoveryService if it exists and disable the service
DistributedTransactionCoordinator BEFORE you install Patch 22.
For Oracle 11.2.0.4 32-bit client there is no patch installation requirement.
See Also
Delete the Default Oracle Database (page 42)
Install and Configure Oracle Server Software (page 37)
CADWorx Installation 55
Index
A R
Appendix Register the Microsoft SQL Server • 31
Install and Configure Oracle Software • 37
Assign System Administrator Privileges for S
SQL Server 2012 • 32
Setup Profile • 14
Software Installation on Network Drive • 15
C SQL Server port assignments • 35
CADWorx Installation • 9
CADWorx Software Recommendations • 7 T
Create a SQL Server Database Alert • 33
Create the Smart 3D Oracle 11g Database • Technical Support • 57
42
U
D Uninstall • 19
Database Setup • 20 Uninstall CADWorx • 19
Delete the Default Oracle Database • 42 Uninstall in Silent Mode • 19
I V
Install and Configure Oracle Server Verify Automatic Startup of Microsoft SQL
Software • 37 Server 2012 Services • 30
Install any Required SQL Server 2012
Upgrades • 30 W
Install in Silent Mode • 11 What's New in CADWorx Installation • 6
Install Microsoft SQL Server 2012 • 26
Install Oracle Database 11g Release 2
Server Software (11.2.0.2) • 38
Installation • 9
Installing and Configuring Microsoft SQL
Server 2012 • 26
Introduction to CADWorx Installation • 5
L
Licensing • 18
O
ODBC Drivers • 20
Oracle 11g Release 2 32-bit Client
Installation • 52
Oracle ODBC Driver Setup • 24
Oracle Post-Installation Requirements • 51
Oracle Server Configuration • 37
Q
Quick Start • 9
CADWorx Installation 56
Technical Support
For the latest information on CADWorx , visit Hexagon PPM https://hexagonppm.com/.
For current on-line support information, including knowledge base, technical tips, and downloads,
visit Intergraph Smart Support
https://hexagon.com/support-success/asset-lifecycle-intelligence/community.
You can contact Hexagon PPM Technical Support or Sales:
CADWorx & Analysis Solutions Dealer Support
(http://www.coade.com/Support/Dealers.shtml) or CADWorx & Analysis Solutions General
Support (http://support.intergraph.com/Default.asp)
Sales E-mail: [email protected]
In order to provide technical support, Hexagon PPM needs to know what version of CADWorx,
AutoCAD or BricsCAD, and what Windows you are using. To determine this information, follow the
steps outlined for the product you are using:
In addition to the information above, the table below lists the additional files that are usually
required to assist Hexagon PPM in resolving your technical issues:
CADWorx Installation 57
Technical Support
CADWorx Plant (Piping, HVAC) Email the CAD model drawing (DWG) files.
If the model consists of several line numbers,
indicate in the email which line numbers you are
having issues with.
If the model consists of many drawing files with
dependent reference drawings (XREFs), use the
CAD platform ETRANSMIT command to create a
ZIP file of all the drawings used in the master model.
Configuration File (CFG).
Project File(.prj), Catalog File(.cat), and Pipe Support
Library Files (.psl).
CADWorx Plant (component data file Email information about the part's dimension from the
creation) manufacturer's catalog.
CADWorx Isogen Email the CAD model drawing (DWG) files, any
isometrics generated by Isogen, and the Isogen
style files.
If the model consists of several line numbers,
indicate in the email which line numbers you are
having issues with.
Model (DWG)
Created Isometrics
A backup of the Isogen Style
Extraction Logs
CADWorx Equipment to PV Elite Email the CAD model drawing (DWG) file and PV Elite
interface input file (*.pvdb).
CADWorx P&ID or CADWorx IP Email the complete P&ID project, which includes
Project.CFG, Database.TBL, Map.TBL, and all the
DWG, and MDB files. Usually, all of these files are
located in one folder.
If the project has many P&ID drawing files, indicate
which P&ID drawings and components you are
having issues with.
If you are experiencing database errors, include the
file [Product
Folder]\P&ID\System\Sql_Error_Log.TXT.
If you are emailing MDB files, use a compression
utility such as WinZIP. Most email servers have
restrictions on transmitting MDB attachments.
CADWorx Installation 58
Technical Support
CADWorx Datasheets Email the datasheets MDB file and any datasheet file
generated (XLS).
If emailing MDB / XLS files, use a compression utility
such as WinZIP. Most email servers have restrictions
on transmitting MDB / XLS attachments.
CADWorx Plant to CAESAR II interface Email the CAD model drawing (DWG) file and CAESAR II
input file (*._A, *.C2).
Run the CADWorx GETALLSPECDATAFILES
command to copy all specifications and data files
used in the model into sub-folders under where the
model drawing file is located.
Zip the contents of these folders and email the ZIP
file to Hexagon PPM Support.
If the model consists of several line numbers,
indicate in the email which line numbers you are
having issues with.
CADWorx Design Review Email the CAD model drawing (DWG) files.
If the model consists of several line numbers,
indicate in the email which line numbers you are
having issues with.
If the model consists of many drawing files with
dependent reference drawings (XREFs), use the
CAD platform ETRANSMIT command to create a
ZIP file of all drawings used in the master model.
If you are attaching large or multiple files to your Smart Support Service Request, use a
compression utility such as WinZIP.
If you cannot attach your drawing files, then try to duplicate the issue in a new drawing with as
few components as possible. If the issue can be duplicated in a new drawing, attach the
duplicate drawing to Hexagon PPM.
For hardware lock issues, first verify that you have a Hexagon PPM hardware lock. CADWorx
Plant Professional, CADWorx P&ID, CADWorx P&ID Professional, CADWorx Structure use
the Hexagon PPM hardware lock for licensing. For more information, see Licensing in the
CADWorx Installation Users Guide or the CADWorx Structure Installation Guide.
CADWorx Installation 59