LICENSE GRANT
In return for the payment of the license fee associated with the acquisition of the Licensed Program(s) from COADE, COADE hereby grants you the following non-exclusive rights with regard to the Licensed Program(s): 1. Use of the Licensed Program(s) on one machine. Under no circumstances is the Licensed Program to be executed without a COADE External Software Lock (ESL) or properly authorized software lock license. 2. To transfer the Licensed Program(s) and license it to a third party if the third party acknowledges in writing its agreement to accept the Licensed Program(s) under the terms and conditions of this License Agreement; if you transfer the Licensed Program(s), you must at the same time either transfer all copies whether printed or in machine-readable form to the same party or destroy any copies not so transferred; the requirement to transfer and/or destroy copies of the Licensed Program(s) contained or merged into other programs. You agree to reproduce and include the copyright notice as it appears on the Licensed Program(s) on any copy, modification, merged portion of the Licensed Program(s). THE LICENSE DOES NOT GIVE YOU ANY RIGHT TO USE, MODIFY, OR TRANSFER THE LICENSED PROGRAM(S) OR ANY COPY, MODIFICATION, OR MERGED PORTION THEREOF, IN WHOLE OR IN PART, EXCEPT AS EXPRESSLY PROVIDED IN THIS LICENSED AGREEMENT. IF YOU TRANSFER POSSESSION OF ANY COPY, MODIFICATION, OR MERGED PORTION OF THE LICENSED PROGRAM(S) TO ANOTHER PARTY, THE LICENSE GRANTED HEREUNDER TO YOU IS AUTOMATICALLY TERMINATED.
TERM
This License Agreement is effective upon acceptance and use of the Licensed Program(s) until terminated in accordance with the terms of this License Agreement. You may terminate the License Agreement at any time by destroying the Licensed Program(s) together with all copies, modifications, and merged portions thereof in any form. This License Agreement will also terminate upon conditions set forth elsewhere in this Agreement or automatically in the event you fail to comply with any term or condition of this License Agreement. You hereby agree upon such termination to destroy the Licensed Program(s) together with all copies, modifications, and merged portions thereof in any form.
LIMITED WARRANTY
The Licensed Program(s), i.e. the tangible proprietary software, is provided, "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED AND EXPLICITLY EXCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. The entire risk as to the quality and performance of the Licensed Program(s) is with you. Some jurisdictions do not allow the exclusion of limited warranties, and, in those jurisdictions the above exclusions may not apply. This Limited Warranty gives you specific legal rights, and you may also have other rights which vary from one jurisdiction to another. COADE does not warrant that the functions contained in the Licensed Program(s) will meet your requirements or that the operation of the program will be uninterrupted or error free. COADE does warrant, however, that the CD-ROM, i.e. the tangible physical medium on which the Licensed Program(s) is furnished, to be free from defects in materials and workmanship under normal use for a period of ninety (90) days from the date of delivery to you as evidenced by a copy of your receipt. COADE warrants that any program errors will be fixed by COADE, at COADE's expense, as soon as possible after the problem is reported and verified. However, only those customers current on their update/maintenance contracts are eligible to receive the corrected version of the program.
ENTIRE AGREEMENT
This written Agreement constitutes the entire agreement between the parties concerning the Licensed Program(s). No agent, distributor, salesman, or other person acting or representing themselves to act on behalf of COADE has the authority to modify or supplement the limited warrant contained herein, nor any of the other specific provisions of this Agreement, and no such modifications or supplements shall be effective unless agreed to in writing by an officer of COADE having authority to act on behalf of COADE in this regard.
LIMITATIONS OF REMEDIES
COADE's entire liability and your exclusive remedy shall be: 1. The replacement of any CD-ROM not meeting COADE's "Limited Warranty" as defined herein and which is returned to COADE or an authorized COADE dealer with a copy of your receipt, or 2. If COADE or the dealer is unable to deliver a replacement CD-ROM which is free of defects in materials or workmanship you may terminate this License Agreement by returning the Licensed Program(s) and associated documentation and you will be refunded all the monies paid to COADE to acquire the Licensed Program(s).
IN NO EVENT WILL COADE BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, AND OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LICENSED PROGRAM(S) EVEN IF COADE OR AN AUTHORIZED COADE DEALER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY. SOME JURISDICTIONS DO NOT PERMIT LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL AND CONSEQUENTIAL DAMAGES SO THAT THE ABOVE LIMITATION AND EXCLUSION MAY NOT APPLY IN THOSE JURISDICTIONS. FURTHERMORE, COADE DOES NOT PURPORT TO DISCLAIM ANY LIABILITY FOR PERSONAL INJURY CAUSED BY DEFECTS IN THE CD-ROM OR OTHER PRODUCTS PROVIDED BY COADE PURSUANT TO THIS LICENSE AGREEMENT. GENERAL You may not sublicense, assign or transfer your rights under this License Agreement or the Licensed Program(s) except as expressly provided in the License Agreement. Any attempt otherwise to sublicense, assign or transfer any of the rights, duties or obligations hereunder is void and constitutes a breach of this License Agreement giving COADE the right to terminate as specified herein. This Agreement is governed by the laws of the State of Texas, United States of America. The initial license fee includes one (1) year of support, maintenance, and enhancements to the program. After the first 1-year term, such updates and support are optional at the then current update fee. Questions concerning this License Agreement, and all notices herein shall be made by contacting COADE in writing at COADE, 12777 Jones Road, Suite 480, Houston, Texas 77070. EXPORT RESTRICTIONS You acknowledge the Software is subject to U.S. export jurisdiction. You agree to comply with all applicable international and national laws that apply to the Software, including the U.S. Export Administration Regulations, as well as end-user, end-use, and destination restrictions issued by U.S. and other governments. For additional information see http://www.bis.doc.gov (http://www.bis.doc.gov).
TRADEMARKS
AutoCAD and ObjectARX are trademarks of Autodesk. Windows, Access, SQL Server, Excel, Word are trademarks of Microsoft Corporation. Oracle is a trademark of Oracle Corporation. Other trademarks are the property of their respective owners.
COADE Inc. 12777 Jones Road, Suite 480 Houston, Texas 77070 U.S.A. Copyright 1993-2008 COADE, Inc. All Rights Reserved.
Table of Contents
CADWorx IP License Agreement Installation 3 9
Conventions ...................................................................................................................................9 Program Support/User Assistance...............................................................................................10 Installation Overview ....................................................................................................................11 Installation Start............................................................................................................................11 External Software Lock (ESL) ......................................................................................................18 ESL Installation ............................................................................................................................19
Introduction
23
Wizard
25
Step 1 ...........................................................................................................................................26 Step 2 ...........................................................................................................................................27 Step 3 ...........................................................................................................................................29 Step 4 ...........................................................................................................................................30 Step 5 ...........................................................................................................................................32 Step 6 ...........................................................................................................................................34 Step 7 ...........................................................................................................................................36
39 45
CHAPTER 1
Installation
In This Chapter
Conventions ....................................................................... 9 Program Support/User Assistance .................................... 10 Installation Overview.......................................................... 11 Installation Start ................................................................. 11 External Software Lock (ESL)............................................ 18 ESL Installation .................................................................. 19
Conventions
Before reviewing this guide, it is important to understand the terms and conventions used in the documentation. Use the information below to identify the convention and the type of information. Convention
<INSTALL-DIR>
Type of Information
This refers to the CADWorx installation directory on your computer. For example, C:\CADWorx IP. Substitute your installation directory anywhere this notation is used. This refers to your AutoCAD installation directory. For example, C:\AutoCAD 2000i. Substitute your installation directory anywhere this notation is used. This refers to your CD-ROM drive. Substitute your CD-ROM drive letter anywhere this notation is used.
<ACAD-DIR>
<CD-DRIVE>
10
Items that need to be typed in or appear at the AutoCAD command line. This refers to user responses to command prompts. CADWorx and AutoCAD commands. Command line options. AutoCAD system variables or keywords. Key combinations for which the user must press and hold down one key and then press another, for example, CTRL+P, or ALT+F4.
Options
CAPITALS KEY+KEY
Chapter 1 Installation
11
Installation Overview
CADWorx IP is installed on the system hard drive using the installation program called SETUP.EXE located on the CD ROM. This installation program has been designed to allow full installation and ease of updating. This section will explain the operation of the installation program, the format of CADWorx IP program on the CD ROM, and the options available to the user. The installation process is relatively simple to accomplish. After starting the installation program the user will be prompted for the required information. If the computer that the installation is being performed has auto run enabled, the setup procedure will automatically start. The CD ROM contains various files, all of which are compressed into files that the installation can read. The only way to extract these files out is to run the installation program (SETUP.EXE).
Installation Start
Quick Start
Run the SETUP.EXE. To start CADWorx IP, pick the icon created during installation. Dialogs will carry the user through the rest of the installation. First time execution of the program will require certain startup parameters to be set. Most of the time, the defaults will be sufficient.
Procedure
The installation is similar to most other Windows installations. The following information will be required: What drive will be used? Which version of AutoCAD will CADWorx IP use? What directory will CADWorx IP be installed in? The name of the Windows program group. The type of the hardware lock
Once these items are known, the installation process can be started. The installation process is detailed in the steps below:
12
2. Select the Start button. 3. Select Run. 4. In the command line type in <CD-DRIVE>:\SETUP.EXE, (or use the Browse... button to locate SETUP.EXE on the CD ROM drive) 5. Select the OK button and this will start the installation procedure. The next two questions pertain to AutoCAD version and install directory. The installation program will automatically try to locate a compatible AutoCAD install directory.
Chapter 1 Installation
13
CADWorx 2009 is compatible with the following AutoCAD versions: AutoCAD 2009 (32 bit version only) AutoCAD 2008 (32 bit version only) AutoCAD 2007 AutoCAD 2006 CADWorx 2009 is compatible with the following Autodesk vertical products: AutoCAD Mechanical 2009/2008/2007/2006 AutoCAD Electrical 2009/2008/2007/2006 Autodesk Mechanical Desktop 2009/2008/2007/2006 AutoCAD Architecture 2009/2008, Autodesk Architectural Desktop 2007/2006 AutoCAD MEP 2009/2008, Autodesk Building Systems 2007.1/2007/2006 AutoCAD Land Desktop 2009/2008, Autodesk Land Desktop 2007/2006 AutoCAD Civil 3D 2009/2008, Autodesk Civil 3D 2007/2006 AutoCAD Map 3D 2009/2008, Autodesk Map 3D 2007/2006 CADWorx 2009 is NOT compatible: AutoCAD 2009 (64 bit version) AutoCAD 2008 (64 bit version) Any Autodesk vertical product based on 64 bit version of AutoCAD 2008 or AutoCAD 2009 AutoCAD Electrical 2009/2008 (64 bit version) AutoCAD Mechanical 2009/2008 (64 bit version) Autodesk Mechanical Desktop 2009/2008 (64 bit version) AutoCAD LT Autodesk Inventor Autodesk Revit
14
The next step questions where to install CADWorx IP. The drive and directory location will be required. Once the target disk drive and directory are known, the installation program checks their existence and available space. If the target directory does not exist, it is created.
The next step asks for the Windows program group. The dialog will show all current program groups on the machine. The user can either choose a new one, or overwrite the entries in an existing group.
The next step asks for the hardware lock type and color. The installation will install the necessary files and drivers for the option chosen.
During the installation process, a progress bar will be displayed along with the status of the installation process.
Chapter 1 Installation
15
Icon Properties
The CADWorx IP program can be run from any location on any hard drive system (network or local). The user is responsible for all support search paths which might be required to find certain project or job folders. These search paths can be added or modified from the CADWorx IP profile. CADWorx IP uses the AutoCAD command line switch /P (User Profile) for starting and running the program within AutoCAD. If for example, AutoCAD 2009 is installed in C:\Program Files\AutoCAD 2009, the properties of the shortcut created will resemble the following: "C:\Program Files\AutoCAD 2009\Acad.exe" /P CADWorx_IP The installation program will automatically create a CADWorx_IP user profile. The profile can be manually created by adding the support file search paths (shown below) and the template file location. The CADWorx IP support directory has to be first in the search path because the ACAD.RX file used to load CADWorx IP is found in the <INSTALL-DIR>\SUPPORT directory. The ACAD.RX file is a text file that AutoCAD uses to load ARX routines. If another support directory is required to be first, copy the ACAD.RX file into that directory. The CADWorx menu is loaded by the ARX file. Note: To setup the profile for another user login on the same machine, run the utility SETUP_PROFILE_IP.EXE
16
Chapter 1 Installation
17
18
Chapter 1 Installation
19
ESL Installation
The following topics explain how to install the different types of hardware locks supported by CADWorx IP.
20
Chapter 1 Installation
21
7. The Activity Log has a box in the top left that will allow you to bring up just the information specific to each protocol. Bring up the Activity Log for the protocol you want to use. Make sure there are no error messages here. 8. For TCP/IP Protocol, the Activity Log should say something like: "Server IP address: 111.111.111.111" "Server Host Name: PDC_NT01" 9. To speed up response time to the Network key, you may "unload" the any protocols that you are not planning on using with the NetHasp License Manager. This can be done from the Remove pull down menu.
NETHASP.INI modification for TCP/IP Protocol: 1. To configure this protocol, you must know the IP address of the machine where the Red Network hardware lock is attached. Example: 111.111.111.111 2. Modify the NETHASP.INI file located at ..\CADWorx\ASSIDRV\NETHASP.INI with the following changes. [NH_COMMON] NH_TCPIP = Enabled [NH_TCPIP] NH_SERVER_ADDR = 111.111.111.111 NH_USE_BROADCAST = Disabled You may also have to modify other entries in [NH_TCPIP] Section depending on your network setup. The most common entries to modify are: NH_TCPIP_METHOD 3. Copy the NETHASP.INI file into AutoCAD EXE (ACAD.EXE) directory: Example: AutoCAD 2006 - (C:\Program Files\AutoCAD 2009); Example: AutoCAD 2007 - (C:\Program Files\AutoCAD 2008); Example: AutoCAD 2008 - (C:\Program Files\AutoCAD 2007); Example: AutoCAD 2008 - (C:\Program Files\AutoCAD 2006); For CADWorx Design Review, copy the NETHASP.INI into the C:\Program Files\COADE\COADE CADWorx Design Review 2008 directory 4. Start CADWorx IP.
22
3. Install and run the Monitor Utility that is located in the <INSTALLDIR>\ASSIDRV\NetHASPMonitorSetup.exe. If NetHASP Monitor cannot find the Red Network ESL, than the CADWorx IP will not find the Red Network ESL
23
CHAPTER 2
Introduction
In This Chapter
What is CADWorx IP.......................................................... 24
24
What is CADWorx IP
CADWorx IP publishes a CADWorx P&ID project to an organized group of static HTML pages. Drawings are published as DWFs (drawing web format) along with associated hyperlinks. These static HTML pages can be upload to a web site, placed on an area network, or simply copied to a CD-ROM. It is an excellent tool for sharing information and collaborating. Note: Only CADWorx P&ID with external databases can be published using CADWorx IP. CADWorx IP can publish to Autodesk DWF Viewer (formerly Autodesk Express Viewer). This is a free tool from Autodesk for viewing and printing DWF. To utilize CADWorx IP, DWF Viewer must be installed on the system. A simple wizard guides the user through the process of creating the published project. Once the project has been published, it can be opened by double clicking on the Index.htm file located in the published directory. Below is a sample view of a published project.
Select a drawing from the dropdown box in the upper left or from the tree. Sections can be expanded by picking the plus sign to the left of the drawing name. Move over an object in the drawing until the hand appears and then double click on it to view it's details.
25
CHAPTER 3
Wizard
In This Chapter
Step 1................................................................................. 26 Step 2................................................................................. 27 Step 3................................................................................. 29 Step 4................................................................................. 30 Step 5................................................................................. 32 Step 6................................................................................. 34 Step 7................................................................................. 36
26
Step 1
The installation program establishes an AutoCAD profile that will automatically start the CADWorx IP wizard. The first dialog of the wizard is simply an introduction. If the wizard is cancelled, it can be rerun using the command line below.
Command line: CADWORXIP (or CWIP)
Chapter 3 Wizard
27
Note: If you have documents linked to CADWorx P&ID drawings, start CADWorx P&ID and run the command TRANSDOC before publishing the project with CADWorx IP. This command copies all documents attached to different components in a drawing to a subdirectories of the project directory. CADWorx IP will copy these documents to the publish directory and link them in the viewer. If TRANSDOC in not run first from CADWorx P&ID, CADWorx IP will not link documents in the viewer.
Step 2
This page of the wizard allows the selection of a CADWorx P&ID project configuration file. This file will be located in the root directory of any valid CADWorx P&ID project and will be named Project.cfg.
28
Database Information
The Browse button is used to locate and select a valid CADWorx P&ID configuration file. Information about the project will be extracted from this configuration file. Names of drawings, documents, LOOPs, reports, etc. are all located via the configuration file and the project database. The wizard will locate and use all of this information. Config file path: will display the location of the configuration file. This information will be automatically populated. Database type: will indicate what type of database is being used. This information will be automatically populated. Database name: will indicate the name of the database being used. This information will be automatically populated. Username: and Password: will be required when an SQL Server or Oracle database is detected.
Publish Settings
Company name: can be any name and is only used for identification purposes with in the next edit box. Project name: is used to identify the published project. A file named <ProjectName>.PUB (publish file) will be stored in the CADWorx P&ID project directory and will record all information about the current publication. Several publish files (*.pub) can be stored in the project directory and each can have different selections (i.e. which files and database columns are to be published). When finished with this dialog pick the Next button to continue. At anytime the user can go back to the previous page by using the Back button.
Chapter 3 Wizard
29
Step 3
This page of the wizard allows the user to select which drawings are to be published.
Here the user can select all or as many drawings they wish to publish. By holding down the control key, the user can individually select drawings. By holding down the shift key, the user can select multiple drawings (pick a drawing at the top and then one at the bottom). Once the drawings are selected, they can be set to publish or not with the Yes/No button. When finished with this dialog pick the Next button to continue. At anytime the user can go back to the previous page by using the Back button.
30
Step 4
This page of the wizard allows the user to select which database columns are to be published.
Chapter 3 Wizard
31
Table Names
This list box allows the selection of different tables within the CADWorx P&ID project database. When a table is selected it will list the names of the columns of that table in the list box on the right. Tables cannot be eliminated from the project, but all the columns within the table can be excluded.
Fields to be selected
Here the user can select the columns needed in the published project. By holding down the control key, the user can individually select columns. By holding down the shift key, the user can select multiple columns (pick a column at the top and then one at the bottom). Once the columns are selected, they can be set to publish or not with the Yes/No button. When finished with this dialog pick the Next button to continue. At anytime the user can go back to the previous page by using the Back button.
32
Step 5
This page of the wizard allows the user to select which reports are to be published.
Chapter 3 Wizard
33
Here the user can select the reports needed in the published project. By holding down the control key, the user can individually select reports. By holding down the shift key, the user can select multiple reports (pick a report at the top and then one at the bottom). Once the reports are selected, they can be set to publish or not with the Yes/No button. Note: Reports are generated from within the Microsoft Access project database first. Access reports can be generated by using the Access export utility which will save reports as a Snapshot Format (*.snp file) as shown above. They must be generated in Access first or they will not appear in this dialog. Create a directory called "Reports" under the project directory. Copy all *.snp file into this "Reports" directory. This dialog will also list all files in the "Reports" directory and copy them into the publish directory. When finished with this dialog pick the Next button to continue. At anytime the user can go back to the previous page by using the Back button.
34
Step 6
This page of the wizard allows the user to select which LOOP drawings (if applicable) are to be published.
Chapter 3 Wizard
35
Here the user can select all or as many LOOP drawings they wish to publish. By holding down the control key, the user can individually select drawings. By holding down the shift key, the user can select multiple drawings (pick a drawing at the top and then one at the bottom). Once the drawings are selected, they can be set to publish or not with the Yes/No button. When finished with this dialog pick the Next button to continue. At anytime the user can go back to the previous page by using the Back button. Note: Create a directory called "Loops" under the project directory and copy all Loop drawing files into this directory. CADWorx IP does NOTread the LoopOutputDirectory setting in the Project.cfg file.
36
Step 7
The last page of the wizard allows the user to select the location of the published project.
Chapter 3 Wizard
37
Publish location
Pick the Browse to chose the location of the published project. After a directory is chosen the program will then proceed to publish the project to that directory. The directory will be divided into sub-directories and each of those directories will have HTML pages, DWFs, reports, etc. There will be a single file in the root directory which can be used to start the published project. The published project can also be copied to another drive or directory. It is not path dependent, although the structure has to remain as published. Note: Pervious version of CADWorx IP had a "Select Viewer" option on this dialog. This option is not needed since the only viewer supported is Autodesk DWF Viewer When finished with this dialog pick the Finish button to publish the project. At anytime the user can go back to the previous page by using the Back button.
39
APPENDIX A
ODBC Drivers
This Appendix covers all the ODBC (Open DataBase Connectivity) information regarding the CADWorx products. Databases associated with CADWorx IP will all use ODBC. If the machine on which CADWorx IP is going to be installed does not have the latest version of the ODBC drivers, these drivers should be obtained from the Microsoft website (http://www.microsoft.com/data). To determine what version of ODBC drivers are installed on the user's machine, pick the Windows Start Button -> Settings -> Control Panel -> Administrative Tools -> Data Sources (ODBC). Double click on the icon and then select the About tab. The versions installed on the machine should be 3.50 or greater. If the files on the user's machine are older, install the latest updates. The user MUST do this before installing CADWorx IP. After installing the program the CADWorx IP User Data Sources will appear as shown below.
40
ODBC drivers configured correctly will insure that CADWorx IP will perform correctly. The following figure shows the ODBC Driver information.
41
42
43
To setup a SQLServer Data Source Name, review the instructions in the file ..\CADWorx\System\SQLServer.txt. The following figure shows the SQL Server data source.
45
Index
C
CADWorx IP License Agreement 3 Conventions 9
T
Troubleshooting Network Locks 21
E
ESL Installation 19 External Software Lock (ESL) 18
W
What is CADWorx IP 24 Wizard 25
I
Icon Properties 15 Installation 9 Installation Overview 11 Installation Start 11 Introduction 23
L
Local Lock Installation 19
N
NetHASP License Manager / NETHASP.INI Instructions 20 Network Lock Installation 20 Notes on Network ESLs 19
O
ODBC Drivers 39
P
Procedure 11 Program Support/User Assistance 10
Q
Quick Start 11
S
Software Installation on Network Drive 17 Step 1 26 Step 2 27 Step 3 29 Step 4 30 Step 5 32 Step 6 34 Step 7 36