V5R16SP5 Build 7 en
V5R16SP5 Build 7 en
V5R16SP5 Build 7 en
for
February 2008
Build: 7
Installation Documentation
Extended Enterprise Installation Manual V5R16 SP5 Build 7 EN_V5.16.5.7 Installation Documentation
Issued by: T-Systems International GmbH Business Unit Digital Engineering Solutions Fasanenweg 5 D-70771 Leinfelden-Echterdingen
1 News ......................................................................................................................................... 6 2 Licenses ................................................................................................................................... 7 3 Prerequisites ............................................................................................................................ 8 3.1 Hardware ............................................................................................................................... 8 3.1.1 Hardware for Windows XP ................................................................................................ 8 3.2 Software ................................................................................................................................ 8 3.2.1 Operating System .............................................................................................................. 8 3.2.2 Java..................................................................................................................................... 9 3.2.3 Perl / TK .............................................................................................................................. 9 3.2.4 Perl Installation for Windows XP...................................................................................... 9 3.2.5 Perl Installation for UNIX................................................................................................. 11 3.2.6 CATIA V5R16 SP5 ............................................................................................................ 11 3.3 Disk Space Requirement.................................................................................................... 11 4 Delivery................................................................................................................................... 12 5 Product Description .............................................................................................................. 13 5.1 PROJECT Tables ................................................................................................................ 13 5.2 Start Templates for V5R16 SP5: ........................................................................................ 13 5.3 Daimler CAA Applications ................................................................................................. 14 5.4 Documentation.................................................................................................................... 15 5.5 DCS-Specific CATIA V5 Definitions .................................................................................. 15 6 Installation on Unix................................................................................................................ 17 6.1 Download of the Tar Files from the Daimler Engineering Portal ................................... 17 6.2 Migration from older Supplier Packages.......................................................................... 17 6.3 Installation of gtar............................................................................................................... 17 6.4 Installation of the Tar Files ................................................................................................ 18 7 Installation on Windows XP.................................................................................................. 20 7.1 Migration from an older V5R16 Supplier Package........................................................... 20 7.2 Download of the V5R16SP5_INTEL_Build_7.* File from the Engineering Portal.......... 20 7.3 Standard Installation .......................................................................................................... 20 7.4 Administrative Installation................................................................................................. 24 8 Installation of a CATIA Hotfix ............................................................................................... 26 9 CAA Applikation Powerfeature............................................................................................. 27 10 CAA application Q-Checker V5 .......................................................................................... 28 10.1 Update of Q-Checker profiles .......................................................................................... 28 11 CAA application SAM .......................................................................................................... 29 12 T-Systems license manager (licman20)............................................................................. 30
3
12.1 Installation / customization.............................................................................................. 30 13 T-Systems license manager (licman1.2)............................................................................ 35 14 SAM-Light............................................................................................................................. 36 15 WBK / WBK_SMGD Installation and Customizing............................................................ 37 15.1 Installation on UNIX.......................................................................................................... 37 15.2 Installation on Windows XP............................................................................................. 38 15.3 Customization ................................................................................................................... 38 15.3.1 Additional license configuration .................................................................................. 39 15.3.2 Integrate the WBK-Project into Start Environment .................................................... 39 15.4 Check the WBK installation ............................................................................................. 40 15.4.1 Start CATIA V5 ............................................................................................................... 40 15.4.2 Verify the special WBK DLNames and your own ones .............................................. 40 15.4.3 Check for the WBK macros .......................................................................................... 41 15.5 WBK User Manuals........................................................................................................... 41 15.5.1 E-Learning documentation ........................................................................................... 42 15.6 Contact persons for WBK ................................................................................................ 42 16 Adapting the Supplier Package.......................................................................................... 43 16.1 Start Script Adaptations................................................................................................... 43 16.1.1 GUIConfig.ini File: ......................................................................................................... 43 16.1.2 Catiav5.ini File: .............................................................................................................. 44 16.2 CATIA V5 License Definition ........................................................................................... 48 16.3 Start of CATIA V5 with the Daimler Environment (GUI) ................................................ 49 16.4 Start of CATIA V5 with the Daimler Environment (Command Line)............................. 50 16.5 Definition of own Projects ............................................................................................... 50 16.6 Integration of own CAA Applications ............................................................................. 51 16.9 Importing DLNames into a CATIA Session .................................................................... 52 16.9.1 Daimler Default Mechanism.......................................................................................... 52 16.9.2 DLName Import as with the V5R12 Paket.................................................................... 54 16.9.3 Own Procedure .............................................................................................................. 55 16.10 Plotter Definition............................................................................................................. 56 16.11 CATIA V5 Online Documentation .................................................................................. 57 16.12 CATIA V5 Language Environment ................................................................................ 58 16.13 CATIA V4 Interoperabilitt (UNIX) ................................................................................. 58 17 Supplier Package Integration into Customer-Specific CATIA V5 Environments .......... 59 17.1 Installation......................................................................................................................... 59 17.2 Definition of the Environment Files ................................................................................ 59 17.3 Start of CATIA with the Daimler Environment ............................................................... 60
4
18 Installation Test ................................................................................................................... 60 19 Distribution of the Installation to Further Clients............................................................. 67 20 Uninstall ............................................................................................................................... 67 20.1 Unix .................................................................................................................................... 67 20.2 Windows XP ...................................................................................................................... 67 21 Known Problems ................................................................................................................. 69
1 News
The current Supplier Package corresponds to the CAx release-management (CRM) level of February 2008 for CATIA V5 R16 SP5 of Daimler AG This package replaces the packages delivered on the basis of CATIA V5R16 SP5 from November 2007 (Build 6). Main changes compared to the V5R16 packages from November 2007: New Q-Checker profiles for CVD Modified VB-scripts (3DM) New / modified catalogs: MBZNORM, BIW_Features, CVD-Partdesign-Powercopies, TubingISO, Tubing-Powercopies, Vehicle Features modified CAA applications: 3DM-View, bmst, dcweld3, Modified CATSettings: CVD_Design_Powertrain, CVD_Production_Tools, CVD_DMU, Powertrain, SFK The T- Systems Licman 2.0 license manager is now the default delivered version. Licman is only required if you want to use SAM (Step Assembly Manager). The former licman version (1.2) is still delivered with this package as backup. Attention: New license files and additional customization steps are required to setup the T-Systems license manager (licman20). On Windows XP, the internal installation mechanism has slightly changed. (see chapter Administrative installation). Support of XP64 (32bit CATIA)
2 Licenses
The following applications require additional licenses: Q-Checker V5, Powerfeature: Powerfeature, DCWeld3: SAM: WBK: Transcat PLM GmbH & Co. KG CATIA V5 KT 1 license T-Systems Licman
Licenses HD2 (Hybrid Design 2) or MD2(Mechanical Design 2) + GSD (Generative Shape Design 2) KT1 (Product Knowledge Template 1) Additionally recommended: KIN (DMU Kinematic Simulator 2) DMN (DMU Navigator 2) SPA (DMU Space Analysis 2)
3 Prerequisites
3.1 Hardware
The hardware prerequisites described in the CATIA V5R16 online documentation apply.
3.2 Software
3.2.1 Operating System
The following operating systems are supported by the Supplier Package: AIX 5.3, HP-UX 11, Windows XP Professional SP2 and Windows XP64 SP2, with a minimum patch level as defined in the CATIA installation manual or the program directory for SP5. Note: The Daimler internal tests for AIX are based on AIX V5.3 ML3 and TL5. No tests were
8
carried out with AIX 5.2 or other MLs. AIX 5.3 TL5 is the preferred level. On UNIX platforms, CATIA V5R16 requires the web browser Mozilla with the Java 1.4 plugin. Netscape is no longer supported!
3.2.2 Java
If you want to use SAM and/or SAM_Light, JAVA 1.2 or newer is required. On UNIX, ensure that Java is found in your PATH variable.
3.2.3 Perl / TK
To permit the use of the graphical user interface of the start center that is also supplied, Perl and Perl/TK must have already been installed on the client machines before the installation of the package. The minimum level for Perl is Version 5.6 as used in the previous V5R14 Supplier Packages. Inside DAIMLER, perl 5.8 is used on UNIX and XP. Note: If you have already installed one of the former Daimler Supplier Packages on your workstations, Perl is already installed with a sufficient level. On UNIX machines, the Perl interpreter must be located under /usr/local/bin/perl. Here some links with information on and downloads regarding Perl: Windows XP: http://www.activestate.com/Products/ActivePerl UNIX: http://www.perl.org
You can also download Perl (incl. TK) from the Daimler Engineering Portal pages. To check the Perl version, enter the following command in a shell environment: perl version : the answer should be version 5.6 or higher To check the installation path on UNIX, enter the following command in a shell environment: /usr/local/bin/perl version: Should Perl not be found, you either need to install it or create a link from the existing Perl location to /usr/local/bin/perl.
You can find out the installation path with the command "which perl": ln fs /<my_perl_path>/perl /usr/local/bin/perl
Start the installation (double click on the MSI package) and follow the installation dialog. We recommend choosing an installation path without blanks in the path name.
Select the check boxes Add Perl to the PATH environment variable and Create Perl file extension association!
10
11
4 Delivery
The delivered package consists of compressed TAR files and an installation script for UNIX and a Windows installer file (.msi) for Windows XP with the complete Supplier Package software for every operating system.
V5R16SP5_AIX_Build_7.tar.gz (gtar zip) V5R16SP5_HP-UX_Build_7.tar.gz (gtar zip) WBK_SMGD: V5R16SP5_UNIX_WBK_SMGD_Build_5.tar.gz (not changed since Build 5 delivery) Install_B16_7.ksh (UNIX) V5R16SP5_INTEL_Build_7.msi (Windows) V5R16SP5_INTEL_Build_7.exe WBK_SMGD: V5R16SP5_WINDOWS_XP_WBK_SMGD_Build_5.zip (not changed since Build 5)
1 MB 170 MB 126 MB
12
5 Product Description
The Supplier Package contains the following components: Daimler CATIA V4 project tables Catalogs: MBZNORM , Vehicle feature, Powertrain, DCWeld, Tubing_Power_Copy, Tubing_ISO*, V5_CAE, Sheetmetal, Powercopies, V5 start-templates CATIA V5 CAA applications: bmst, bpmt, 3DM_View, XMLWriter, SFK [clamping and locator plan] , FTACol, DrwFastener, dcweld3, Powerfeature, qcheckerV5, SAM, dcweld3,VB_Tools DCS-specific CATIA V5 definitions (CATSettings, variables) Start environment based on Perl scripts for Windows XP and UNIX TubingISO PRM (project resources management) adaptations SAM-light (STEP Assembly Manager) licman (T-Systems license manager) required for SAM
Note: A detailed Supplier Package content list can be found on the Engineering Portal (Engineering Services | CAx / EDM Service | CATIA Installation Environ. | V5 Supplier Package | Contents)
Startpart_Assembly_1.0.1_en.CATPart Startpart_BIW_7.5.1_en.CATPart Startpart_CVD_Simple_1.0.1_en.CATPart Startpart_DCS_Standard_1.0.0_de.CATPart Startpart_Electric-Component_1.0.1_en.CATPart Startpart_Rohbau_7.4.9_de.CATPart Startpart_Rohbau_ZB_1.0.0_de.CATPart Startpart_SFK-Drawing_1.0.0_de.CATDrawing Startpart_SFK-Product-Structure_1.0.1_de.CATPart Startpart_SFK-Product-Structure_1.0.1_en.CATPart Startpart_Vehicle_1.0.1_de.CATPart Startpart_Vehicle_1.0.1_en.CATPart
3D Master-View Control DC Master Data & Weight Management, Titleblock Graphic presentation of tolerances Clamping and locator plan Automated creation of weld spots in the drawing on the basis of DCWeld Requires CATIA V5 license KT1! Fit Size Table Requires a CATIA V5 KT1 license and an additional license from Transcat PLM Requires an additional license from Transcat PLM Requires an additional license from T-Systems
5.4 Documentation
After the installation, additional documentation can be found under: <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/doc.
For the cooperation with Daimler only the provided Drafting XML file is to be used and not the default files of the standard CATIA installation (ISO, ANSI,...)!
2. The Daimler-specific CATSettings are supplied in the directory CATSettings_DC, the projectspecific CATSettings in CATSettings_BEMI CATSettings_CVD_Design_Base CATSettings_CVD_Design_Base_ToolBar CATSettings_CVD_Design_Powertrain CATSettings_CVD_Design_Powertrain_ToolBar CATSettings_CVD_DMU CATSettings_CVD_DMU_ToolBar CATSettings_CVD_Electric CATSettings_CVD_Electric_ToolBar CATSettings_CVD_ProductionFoundry CATSettings_CVD_ProductionTool CATSettings_CVD_ProductionTool_ToolBar CATSettings_CVD_TubingDiagrams CATSettings_DC CATSettings_DMU_Settings CATSettings_DMU_ToolBar CATSettings_Elektrik CATSettings_Elektrik_ToolBar CATSettings_Fahrzeug CATSettings_Fahrzeug_ohne_Cache CATSettings_Fahrzeug_ToolBar CATSettings_Fahrzeug_ToolBar_ohne_Cache
15
CATSettings_HD2 CATSettings_Powertrain_Standard CATSettings_SFK CATSettings_SFK_2D CATSettings_SFK_DMU CATSettings_TubingISO CATSettings_HD2 contain an example of the license requirement for the CATIA HD2 configuration. The settings are connected in such a manner that the license requirements are always positioned first in the CATReferenceSettingPath, followed by the CATSettings_DC and then the project settings. Instructions on how to integrate further licences can be found in chapter 8.2. Cascading example for the start of the Electric environment: 1. CATSettings_HD2: license configuration 2. CATSettings_DC: standard settings as e.g. CATIA V4 project 3. CATSettings_Electric Attention: Do not change the supplied CATSettings in your installation!
16
6 Installation on Unix
6.1 Download of the Tar Files from the Daimler Engineering Portal
A gtar file for every operating system can be found on the Engineering Portal. Download the required tar file to any directory (e.g.: /tmp). You will also need the installation script provided there (install**.ksh), which you need to copy to the same directory as the tar file. You will need 'gtar' (GNU tar) version 1.13.25 to unpack the gtar files. To check the 'gtar' version, enter the following command: gtar version If necessary, you can also download gtar from the Engineering Portal.
17
Attention:
For the installation of the tar files, the install_B16_7.ksh shell script is absolutely necessary. The tar files can not be unpacked directly, since the installation script will perform additional settings!
Installation of the tar files
Change to the directory to which you downloaded the installation files: e.g.: cd /tmp Start the installation script: ./install_B16_7.ksh !------------------------------------------------------------! ! ! ! Installation of Daimler AG supplier package ! ! V5R16SP5 package 2/2008 ! ! ! !------------------------------------------------------------! Target directory for Daimler supplier package Enter your target directory (absolute path starting with /): Type in the desired installation path for the supplier package: e.g.: /Daimler_B16SP5 If the directory does not exist yet, confirm (Y) that it is to be created: ------------------------------------------------------------Cannot find the target directory: /Daimler_B16SP5 Do you want the install program to create it ? ------------------------------------------------------------Press Y/N to confirm or refuse: Y ------------------------------------------------------------Where is your CATIA installed? Enter your target directory (e.g.: /usr/DassaultSystemes/B16): Enter the installation path of the V5R16SP5 CATIA installation here: e.g.: /apps/catia/B16
18
------------------------------------------------------------OPTIONAL: Where are your installation dependant CAA applications installed? Consult installation documentation about how to integrate CAA applications)? Enter CAA installation directory or type <ENTER> (e.g.: /My/CAADIR): /My/CAA The script will then install the tar file and perform the required settings.
The following structure will be unloaded in the target directory: ./cl : client directory with the CAA applications ./srv : server part (adaptation) ./Daimler_AG_SUPLVL : level file
Attention: The installation script creates absolute links under UNIX, so it is not possible to copy the resulting file tree to another directory path.
19
7 Installation on Windows XP
7.1 Migration from an older V5R16 Supplier Package
The new V5R16 Supplier Package is delivered as a complete package. It is possible to install the new package in parallel with the old package. Recommendation: first install the new package, carry out all required adaptations and test the installation. Then you can uninstall the older version. Future deliveries might also be supplied as updates.
20
Follow the installation dialogs: choose an installation directory. Recommendation: For Perl, CATIA V5R16 and the Daimler Supplier Package, choose installation path names without blanks. In UNIX environments, path names with blanks are quite unusual and it can not be guaranteed that all Perl scripts or Perl modules will function if there are blanks in the path name.
21
During the installation, the msi package calls the EXE file and extract the data. You may have to confirm the execution of the V5R16SP5_INTEL_Build_xx.exe file
The installation routine will copy all required files into the installation directory. In addition, all necessary adaptations in the configuration files <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/scripts/DC_CV5_Start/GUIConfig.ini and <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/scripts/DC_CV5_Start/Catiav5.ini will be carried out, if ActiveState Perl is found on the machine. Here, only the first installation of CATIA V5R16 on the PC is taken into account: (HKEY_LOCAL_MACHINE\SOFTWARE\DASSAULT SYSTEMES\B16\0) In case you have several parallel versions of V5R16 installed, please check the registry for the installation corresponding to the Daimler V5R16 SP5 / hotfix level. Use regedit to identify the V5R15 installation paths and then manually enter the installation path into the Catiav5.ini file.
22
If ActiveState Perl is not found by the installation routine, a corresponding information dialog box will pop up and you will have to manually edit the GUIConfig.ini and Catiav5.ini files, as described in the following chapters.
In case the following error message appears, the post installation script, which modifies the configuration files, did not run error-free.
In this case, also check the content of the GUIConfig.ini and Catiav5.ini files and carry out the required adaptations, if necessary. After the installation you will find two shortcuts under Start/Programs/Daimler Supplier Package B16_7 Start/Programs/Daimler Supplier Package B16_7/CATIA V5R16 SP5 Start
23
Now follow the instructions from the chapter Installation Test to check the functionality!
Compared to the former packages, the files are packaged in a slightly different way. Now, the intel_a files of the CAA applications are shipped in the directory of the corresponding CAA application. There is no longer a merged intel_a directory in the exe file, containing all CAA applications! During execution of the MSI installation package, these directories are merged in one intel_a directory. So, in the case that you extract the exe file by hand, you will have to copy all intel_a directories of the CAA applications into one intel_a directory at the level of the CAA applications. You can use the link.vbs script in the <INSTALLDIR>\cl\B16\3DParty\EDM_07_03 directory to perform this step.
24
In addition, you will have to create/modify the configuration files (Catiav5.ini und GUIConfig.ini) and the shortcuts manually by yourself.
25
26
27
28
You do not need to order a software CD for SAM, as the SAM software is already included in the DC supplier package. 3. Activation of SAM: In the DC supplier package, SAM is disabled by default. If you want to use SAM, please edit the Perl script < SUPPLIER_PACKAGE_UNLOAD >/cl/sam/sam_start.pl: Comment line no. 10 in start_sam.pl by inserting a # character at the beginning of the line, like this: #$my_catiaenv->setEnvVar('SAM_DISABLE', 'ON');
29
network or nodelock licenses application environment (CATIA V4, CATIA V5, Medina) operating systems which you use (UNIX, Windows XP)
you may have to perform different installation steps. In addition, there is a different approach, if you migrate step by step or in one step from licman 1.2 to 2.0. On Windows XP, only one licman version can be installed at a time on a machine. On UNIX both licman versions can be installed together on a machine, but it is necessary to use license files with different port numbers.
server. On UNIX, it is possible to use the same machine as for the licman l.2 installation if you use different ports in the license files. On Windows, you have to use another machine as license server, if licman 1.2 is still required. 2. Retrieve the system ID for the Licman20 license file on the license server machine or local machine in case of nodelock licenses Windows: Uninstall licman 1.2 or disable licman 1.2 services and install licman 2.0. Then run: Start -> Programs -> T-Systems -> Licman 2.0 -> Licman Id
or run ipconfig /all Extract the Ethernet adapters physical address and remove dashes.
30
Remark: LICMAN system ids are not case sensitive. Id strings are valid whether they are uppercase, lowercase or mixed case characters. On a Windows PC with several network adapter cards a Linux PC with several network adapter cards AIX 5.1 or newer you may get more than one possible LICMAN system id. Each of them is accepted by LICMAN as a valid system id.
3. Request new license keys for licman 2.0 at the T-Systems product support, if you didnt get
Before you start the installation: Ensure, that you got new license files from T-Systems before you start the migration as the old licman 1.2 license files will not work with the new version! 4. UNIX: All necessary runtime files are delivered and automatically installed with the supplier package. Windows XP: Install the separate delivered licman 2.0 setup file as described in the licman 2.0 documentation.
5. Prepare License.dat files (Unix + Windows XP)
After getting the License.dat, copy the file to: <SUPPLIER_PACKAGE_UNLOAD >/srv/licman20_V5_S/License.dat In the License.dat file, modify the line with the HOSTID, HOSTNAME and PORT entries to your needs. (only required in case of network licenses). For example:
SERVER HOSTID=00CE3DEF4C00 HOSTNAME="your hostname" PORT=52818
If the line starts with a # (comment), then uncomment (delete the # sign).
6. Prepare a licman 1.2 compatibility file (Unix + Windows XP):
It is necessary to create a compatibility licenses file to be able to still support 1.2 applications. Example:
31
Assuming your productive licman 1.2 installation has a licenses file with port 60000 for the communication of LLD:
Licensefile for DaimlerChrysler xxx hostname, Typ F DLVOWXGNLZQWTCXJKAVYCVTDAESCHOTAUZRGTVRACUPQQIFIGTCQPUXYJKRJOMRIJUXOAVWPYG SRHWGW 20.03.06 23.03.07 31.12.08 60000 60001
Then, for licman 2.0 compatibility mode create a new licenses file: <SUPPLIER_PACKAGE_UNLOAD >/srv/licman20_V5_S/licenses which uses another port for the communication to the lld. Only the first 6 lines are required and only the port number from line Nr. 6 is read. Copy you old licenses file and edit the port number in line 6 to your new value or just copy the following lines in that file:
Licensefile for licman 2.0 compatibility mode
Now, the preparation of the license files is finished. 7. Distribute license files (Unix + Windows XP): If you have several machines, accessing network licman licenses, then these machines must have access to the License.dat and licenses files. Depending on your installation, this can be achieved in different ways: - Share the <SUPPLIER_PACKAGE_UNLOAD >/srv path on a network file system. Keep in mind that you have to edit the ServerPath variable in the Catiav5.ini file to share the srv part.
-
Copy the License.dat and licenses files to all machines with the supplier package installed: <SUPPLIER_PACKAGE_UNLOAD >/srv/licman20_V5_S/
8. Start licman processes on the licman license server (UNIX) This step is required only in case of network licenses and only on the license server, running the Global License Daemon (GLD) process. Edit <SUPPLIER_PACKAGE_UNLOAD >/srv/licman20_V5_S/rc.licman20 and adopt the variable definition: export debisLICDIR=/catiav5/licman20_V5_S to your installation path. Then execute the script and verify, that both licman20_gld and licman20_lld processes are executing. It is also possible, to execute the rc.licman20 during startup of the machine (e.g. /etc/inittab on AIX).
32
9. Start licman processes on the licman license server (Windows XP) Start the licman 2 GLD service in the services panel of the system control on the license server and set the start type to Automatic. Do the same for the LLD. Attention: The GLD should be started only on the license server machine, not on the clients.
10. Test the installation Check, that the license server is working, run: C:\Program Files\T-Systems\Licman20\licman20_appl.exe or <SUPPLIER_PACKAGE_UNLOAD >/srv/licman20_V5_S/steplib_AIX/licman20_appl on AIX 1. Use option 4 for query
33
2. Use option 1 to allocate a license and give a Product key (license key)
34
35
14 SAM-Light
SAM-Light (Step Assembly Manager) is now delivered in the supplier package, including a valid license. SAM-Light requires a Java 1.2 or newer runtime installation. On UNIX, ensure that Java is found in the Search path. Read: < SUPPLIER_PACKAGE_UNLOAD >/cl/sam_light/Flyer_SAM_light-de.pdf < SUPPLIER_PACKAGE_UNLOAD >/cl/sam_light/SAM_light_License_Agreement.txt There are no additional customization steps required.
36
V5R16_UNIX_WBK_Build_3.tar.gz V5R16_UNIX_WBK_SMGD_Build_5.tar.gz
138 MB 124 MB
cd (change directory) to the directory where you already unloaded the supplier package V5R16 Build 5. e.g.: cd <SUPPLIER_PACKAGE_UNLOAD> unpack the V5R16_UNIX_WBK_Build_3.tar.gz e.g.: gtar -xzvf /tmp/ V5R16_UNIX_WBK_Build_3.tar.gz
37
V5R16_WINDOWS_XP_WBK_Build_3.zip V5R16_WINDOWS_XP_WBK_SMGD_Build_5.zip
131 MB 124 MB
Then unzip the file into the path where you installed the supplier package:
15.3 Customization
After unloading the WBK software you have to perform the following additional customization steps: create the licenses configurations for the WBK project include the WBK project in the Perl/TK Startcenter script
38
integrate your own specific DLNames for the WBK-project test the WBK configuration
15.3.1 Additional license configuration The following CATIA V5 licenses are required for WBK:
License HD2 (Hybrid Design 2) or MD2(Mechanical Design 2) + GSD (Generative Shape Design 2) KT1 (Product Knowledge Template 1) also recommended: KIN (DMU Kinematic Simulator 2) DMN (DMU Navigator 2) SPA (DMU Space Analysis 2)
Please consult the chapter "CATIA V5 License Definition" and define the required licenses for WBK. 15.3.2 Integrate the WBK-Project into Start Environment Define the WBK-project in the < SUPPLIER_PACKAGE_UNLOAD >\srv\B16\scripts\DC_CV5_Start\GUIConfig.ini as explained in the appropriate chapter in this document.
@CV5PARM::Projects_B16 = ( "/", "/DC" ,
"/DC/WBK",
or "/DC/WBK_SMGD",
"/DC/Fahrzeug", "/DC/Fahrzeug_ohne_Cache", "/DC/Powertrain_Standard", "/DC/DMU_Standard", "/DC/Electric", "/DC/TubingISO", "/DC/SFK", "/DC/SFK_2D", "/DC/SFK_DMU", "/DC/CVD_Design_Base", "/DC/CVD_Design_Powertrain", "/DC/CVD_Electric", "/DC/CVD_ProductionFoundry", "/DC/CVD_ProductionTool", "/DC/CVD_Tubing_Diagrams", "/DC/CVD_DMU_General" ); 39
Read the output in the startup-window. Usually there appear the information about the included scripts and values from CATIA V5 environment variables. So you can control, if the CATReferenceSettingPath has the CATSettings_WBK and CATSettings_WBK_ToolBar concatenated.
15.4.2 Verify the special WBK DLNames and your own ones Inside your CATIA V5 session go to menu Tools/Options/General/Document o DLName must be in the state current o select DLName and press configure control if you could find #CATALOG.WBK_KAT and SYSTEM.MACRO.WBK Also search for your own defined DLNames. another way to check the DLNames: menu File/Open o the next panel offers you in Look in: a defined DLName o if you choose the #CATALOG.WBK_KAT it shows you a list of the WBK
40
catalog files
15.4.3 Check for the WBK macros now you have also a special WBK-Toolbar: WBK_Macros
check out for the definitions o go to menu Tools/Macro/Macros/ o you get the following panel:
15.5.1 E-Learning documentation A good help for recall of the WBK methodology is to watch the flash videos under <SUPPLIER_PACKAGE_UNLOAD>\srv\B16\3DParty\WBK\Doc\XP\web_demos_englis h Attention: only useable on Windows XP with installed flash-player!
Mr. Wolfgang Keller DAIMLER AG - Werk Sindelfingen Entwicklung Rohbau Dept.: EP/QFR mailto:[email protected]
42
, , ,
%CV5PARM::MX = ( 'Title' , 'Office', 'Word' ,'start /D"C:\\Programme\Microsoft Office\Office10" winword.exe', 'Excel','start /D"C:\\Programme\Microsoft Office\Office10" excel.exe', 'Powerpoint','start /D"C:\\Programme\Microsoft Office\Office10" Powerpnt.exe');
UNIX:
@CV5PARM::Menues = ( \%CV5PARM::Utilities , \%CV5PARM::Tools); %CV5PARM::Utilities = ( 'Title' , 'Utilities ', 'CATIA V4-V5 Migration','CATIAV5:CNEXT -batch -e CATV4ToV5Migration ', 43
'V4 seq. Import','CATIAV5:CNEXT -batch e ExtractModelFromSequential', 'Nodelock Management' , 'CATIAV5:CATNodelockMgt'); %CV5PARM::Tools = ( 'Title' , 'Tools ', 'xterm' , 'xterm', 'clock' , 'xclock');
Global:
# Project Definition: @CV5PARM::Projects_B16 = ( "/", "/DC" , "/DC/Fahrzeug", "/DC/Fahrzeug_ohne_Cache", "/DC/Powertrain_Standard", "/DC/DMU_Standard", "/DC/Electric", "/DC/TubingISO", "/DC/SFK", "/DC/SFK_2D", "/DC/SFK_DMU", "/DC/CVD_Design_Base", "/DC/CVD_Design_Powertrain", "/DC/CVD_Electric", "/DC/CVD_ProductionFoundry", "/DC/CVD_ProductionTool", "/DC/CVD_Tubing_Diagrams", "/DC/CVD_DMU_General" );
@CV5PARM::License = ("HD2");
You can define additional menus and projects in the GUIConfig.ini file. The supplied settings serve as an example for this.
= N = 1
CascadeSeparator = : PathSeparator = / RootBegin = / UserTemp = /tmp Use_V4_SysDyn = N ServerPath = /your_install_path/srv ClientPath = /your_install_path/cl UserHome = $ENV{HOME} ReferenceSettingPath = $ServerPath/$DC_Version/CATSettings_DC RemoteTraceDirPath = /share/v5tracedir/$DC_Version LocalTraceDirPath = /tmp/v5tracedir ExecutionSuffix = " " CV5_Masterdcls = $ServerPath/$DC_Site/sysdyn/MASTERDCLS CV4_Masterdcls = /catia424/prod/sysdyn/MASTERDCLS MappingFile = $ServerPath/$DC_Site/sysdyn/win2unixgroups SysDynFilterDir = $ServerPath/$DC_Site/Projects DC_Local_Cache = $ENV{HOME}/CATCache_$DC_Version DC_DocumentationPath = $ServerPath/$DC_Version/Doc ; OtherCatiaPath is necessary in supplier package e.g.: /apps/catia/B16 OtherCatiaPath = "<Your CATIA B16 install path>" ; SupplierCaapath without $OSDS ;SupplierCaaPath = /tmp/MyCaaInstallPath [windows] CascadeSeparator = ; PathSeparator = \ ; SystemDrive is XP-Variable RootBegin = $ENV{SystemDrive}\ ; UserTemp is DC scratch area for example creating DLnames UserTemp = CSIDL_LOCAL_APPDATA\DassaultSystemes Use_V4_SysDyn = N ServerPath = C:\apps\catia\offline ClientPath = $ENV{SystemDrive}\apps\catia UserHome = CSIDL_APPDATA\DassaultSystemes ReferenceSettingPath = $ServerPath\$DC_Version\CATSettings_DC ; RemoteTraceDirPath and LocalTraceDirPath are used only in start_mtc.pl to collect Abends. CATErrorlog is moved to another location RemoteTraceDirPath = \\your_traceshare\v5tracedir\$DC_Version LocalTraceDirPath = $UserTemp ExecutionSuffix = '.exe' CV5_Masterdcls = $ServerPath\$DC_Site\sysdyn\MASTERDCLS CV4_Masterdcls = \\your_catiashare\catia424\prod\sysdyn\MASTERDCLS MappingFile = $ServerPath\$DC_Site\sysdyn\win2unixgroups SysDynFilterDir = $ServerPath\$DC_Site\Projects DC_Local_Cache = CSIDL_LOCAL_APPDATA\DassaultSystemes\CATCache_$DC_Version DC_DocumentationPath = $ServerPath\$DC_Version\Doc ; OtherCatiaPath is necessary in supplier package OtherCatiaPath = "<Your CATIA B16 install path ; Supplierpath without $OSDS ; SupplierCaaPath = E:\MyCaaInstallPath ; DC_DomainControler info is used to check if laptops are offline DC_DomainControler = local ; Serverpath is mapped to DC_DriveLetter at startup; possible values Y and N 45
; enable_drive_mapping ; DC_DriveLetter
= N = R:
; dc_win_create_process 0 Perl system() function will use; 1 Windows CreateProcess will use dc_win_create_process = 0
[Global section] DC_Site: This declaration sets the Daimler environment: V4-project directory, standard drafting xml file, templates, standard catalogs etc. DCS: default in CRM installation This setting must not be changed! Default_DC_AddEnv: Definition of the default initialization scripts. The corresponding PERL scripts (start/stop), such as: start_catiav5.pl and stop_catiav5.pl must be contained in the directory <SUPPLIER_PACKAGE_UNLOAD>/srv /B16/init.d. The default script catiav5 must not be removed! You can attach further scripts: Example: Default_DC_AddEnv = catiav5 myinit_script The scripts/B16/init.d/start_catiav5.pl und /B16/init.d/start_my_init_script.pl are executed before CATIA V5 is started. Default_EnvironmentFile: Environment File This setting must not be changed!
BBDomainManager: Hostname of the backbone domain manager. For a definition of a domain manager node, refer to the CATIA online manual. CheckResources: Monitoring of resources (only for Windows XP)
DebugLevel:
46
[UNIX section]
ReferenceSettingPath: This setting must not be changed! Basic setting for the connection. As described in the documentation, the path may be added, if necessary.
SysDynFilterDir: Folder for project-specific DLName filters DC_Local_Cache: Path to local cache
47
[Windows section]
UserHome, UserTemp: Support for windows special folders: CSIDL_APPDATA und CSIDL_LOCAL_APPDATA
48
Now select the desired license (MD2) under Tools/Options/General/Licensing. Tip: It may be useful to lock the settings in Tools/Options. End the CATIA session and delete all files (except for the Licensing.CATSettings file) in the directory <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/CATSettings_MD2,. chmod 555 to CATSettings_MD2 directory and chmod 444 to Licensing.CATSettings file. If you want to use the CATIA start scripts also in the batch mode (without the start GUI) then you have to take into account the license settings in this mode as well: 1. Copy the <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/init.d/start_HD2.pl to <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/start_MD2.pl 2. Edit the start_MD2.pl file and replace: my $lic="HD2"; by my $lic="MD2"; 3. chmod 755 start_MD2.pl Define the MD2 license in the <SUPPLIER_PACKAGE_UNLOAD >/srv/B16/scripts/GUIConfig.ini file: @CV5PARM::License = ("HD2", MD2); # Array with the available license packages Now you can start CATIA V5 with the created Daimler-DCS environment
Select the desired license and the project you want to work on, then press the button: *** Start CATIA ***
49
If selected, the "Reset Settings check box deletes the CATSettings in the CATUserSettingPath directory.
1;
4. Define all project-relevant CATSettings in the admin mode: <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/scripts/GUI.pl a Select the project that is to be administered. Do not modify the supplied settings! Make sure that you have write access permission on the CATSettings_<Project> directory. Activate the admin check box and start CATIA Define all the required parameters in Tools/Options and Tools/Customize Stop the CATIA session and write-protect the CATSettings directory and its content 5. Start CATIA V5 with the defined new project in the user mode: <SUPPLIER_PACKAGE_UNLOAD>/srv/B16/scripts/GUI.pl Select the project Start CATIA
to ; Supplierpath without $OSDS SupplierCaaPath = /my_CAA_Install_Dir Copy all data of your CAA application into a new directory under <SupplierCaaPath>. Use a separate directory for every CAA function. e.g.: /my_CAA_Install_Dir/MyCAA_1 /my_CAA_Install_Dir/MyCAA_n Copy/paste the directory $OSDS in the CAA application directory to <SupplierCaaPath >/$OSDS. Now all CATIA-relevant data will automatically be found and accessed at the start of CATIA. e.g.: for AIX: cp rp /my_CAA_Install_Dir/MyCAA_1/aix_a /my_CAA_Install_Dir/ cp rp /my_CAA_Install_Dir/MyCAA_2/aix_a /my_CAA_Install_Dir/ If your CAA application requires special initialization steps (e.g.: environment variables, scripts,...), create a Perl script <SupplierCaaPath>/MyCAA_1/start_MyCAA_1.pl with all necessary commands and definitions.
52
4. If you also want to import CATIA V4 DLNames, additionally set: Use_V4_SysDyn = Y und CV4_Masterdcls. The path must point to the input file for the DLName import. e.g.: CV4_Masterdcls = /catia424/prod/sysdyn/Masterdcls (CATIA V4 DLNames) The format for the input files looks like this: DLNAME Windows Path Unix Path Type File access
CATIAV5.B1.P1;\\emc\fs\b1\p1;/data/catiav5/b1/p1;MODEL;;/*U:580:G:543:O:All:*/ CATIAV5.B8.P1;\\emc\fs\b8\p1;/data/catiav5/b8/p1;MODEL;;/*U:580:G:543:O:NONE:*/ If the file access attributes are set, only those DLNames for which the user has at least read permission will be imported by CATIA V5 at the start. File access attributes: U=User: Unix user id G=Group: Unix group id O=Other: NONE or ALL In addition, project-specific filters (e.g. Body-in-White) can be defined in order to further narrow down the DLName list.
To do so, create corresponding filter files for every project. <SUPPLIER_PACKAGE_UNLOAD>/srv/DCS/Projects/[projectname]/sysdyn_filter e.g.: define filter in /catiav5/DCS/Projects/Body_in_White/sysdyn_filter: ^CATIAV5 ^[B|Y]ATIA. TEST In the example, only DLNames starting with CATIAV5, BCATIA or YCATIA or containing the string TEST are imported. If you want to use your own individual procedure for the import of DLNames, set the following parameter in the Catiav5.ini configuration file: DC_USE_DLNAMES=N To activate your own import script, enter it at the end of the line Default_DC_AddEnv = catiav5. e.g.: Default_DC_AddEnv = catiav5 my_import_script To this end, the corresponding perl start script start_my_import_script.pl must first be stored in the directory ..srv/B16/init.d. The script name must begin with start_.
53
54
DLNAME_IN_FILE_1 DLNAME_IN_FILE_2 Now the import script reads the files DLNAME_IN_FILE_1 and DLNAME_IN_FILE_2 in order to import the DLNAMES. This mode is useful, when several projects are to have access to an identical subset of DLNAMES. It is possible to mix both variants (e.g. a DC.txt and a Chassis.include file) The DLNAME input files must be made up of the format that is documented in the CATIA online documentation. Example: Chassis.txt # DLNAME | WINDOWS path | Unix path Chassis_DL1;C:\data\chassis1;/catiadata/chassis1; Chassis_DLx;C:\data\chassisx;/catiadata/chassisx; In addition, filters can be set on a Regular Expression so that the number of DLNAMES can be further limited down. If the file <Projectname>.filter exists, the Regular Expressions are applied to the entire DLNAME input list. Example: DC.txt contains: POWER_DL1;C:\data\power1;/catiadata/power1; POWER_DLx;C:\data\powerx;/catiadata/powerx; CHASSIS_DL1;C:\data\chassis;/data/chassis; STANDARD_PARTS;C:\data\standard;/data/standard; STANDARD_ASS;C:\data\standard_ass/data/standard_ass; Powertrain.filter contains:
^POWER ^STANDARD Now only those DLNAMES are imported, that start with either POWER or STANDARD. In the example given,CHASSIS_DL1 would not be imported.
Default_DC_AddEnv = catiav5 my_import_script To do so, the script start_my_import_script.pl must be contained in the ..srv/B16/init.d directory. The entry catiav5 may not be deleted and must be listed first!
56
5. Change the access rights for the plotter directory so that normal users do not have write permission there 6. Now start CATIA V5 as normal user and check the availability of the plotter list
57
58
You can find more information in the CATIA documentation. CATIA V4: Data Administration and Interoperability Guide Part II : Understanding Different Data Interoperability Issues Manipulating CATIA Version 5 in a CATIA Version 4 Session. CATIA V5: V4 Integration Guide: Reading V5 Data in Version 4 Format
Note: Please note that with future versions, this type of integration might no longer be possible as easily, as soon as CAA applications or projects need more sophisticated initialization scripts.
17.1 Installation
Unload the software as described in the chapters above.
In the new opened command line window key in: set > C:\Temp\v5vars.txt
Now you can compare the two files with a file comparison Tool of your choice. Identify the changes and include them in the environment file, which you use for your production environment.
59
18 Installation Test
The following points should be checked in order to verify the installation: a) Start of CATIA b) Service Pack and hotfix level c) Project file d) Start templates e) Catalogs f) Standard definition in the drafting XML file
60
b) Service Pack and Hotfix Level Currently, the start scripts do not check whether the correct CATIA version is started. This may be changed in future versions. You are responsible for the installation of the correct CATIA version, Service Pack and hotfix level. To check, start CATIA and select Help/About CATIA. Service Pack 5, Build Number B16 Hotfix 46 is the currently required level.
Hotfix 46
61
c) Project File In TOOLS/OPTIONS/Compatibility, the Project File name must be set to CATIA.PROD.PRJ.MAP and locked!
d) Start Templates #CATIAV5.TEMPLATES in FILE/OPEN, the following start templates must appear:
62
Please consult the Daimler C@D manual in case you need more information on the use of the start templates! e) Catalogs In File/Open, the following catalogs should appear:
f) Standard Definition in the Drafting XML File In Tools/Standards 'drafting', DC_ISO_R16_V1_1.xml must be available and selected.
63
g) CAA Functions Check the availability and functionality of the CAA functions. Read the documentation on these applications in the srv/B16/Doc directory. BMST: Daimler Masterdata & Weight Management (CATPart)
DC Masterdata: (CATDrawing)
64
SFK Workbench
DrwFastener
DCWeld3
Powerfeature Powerfeature requires a CATIA V5 KT1 license und and additional licenses from Transcat!
65
XML Writer
h) SAM-Light Start on Windows XP: Start/Programs/ Daimler Supplier Package B16_5/SAMlight Start on UNIX: <Supplier_UNLOAD>cl/sam_light/samlight
66
i)
Further Test
On the Engineering Portal, you find a scenario for a further interactive environment test.
20 Uninstall
20.1 Unix
On UNIX systems, delete the directory <SUPPLIER_PACKAGE_UNLOAD>. rm rf <SUPPLIER_PACKAGE_UNLOAD>
20.2 Windows XP
On Windows, use the Windows Software Manager to uninstall the Supplier Package. Close all open applications of the supplier package before you remove the installation. Remark: A running CATIA session will be canceled by the uninstall job!
67
If you also installed the WBK software, after uninstall of the supplier package, you will have to delete the directory structure <SUPPLIER_PACKAGE_UNLOAD>/srv which will still contain the WBK files.
68
21
Known Problems
In the following, you will find a list of known problems that will be resolved in the next Supplier Package version.
Product General
Description Some toolbars point to macros which are not delivered with the supplier package but are only for Daimler internal use. In this case, you just will see the macro name, but no icon. These macros, as they are not part of the package will not work. Just ignore these definitions!
Platform UNIX XP
Example:
File/Open
There are some DLNames defined in the CATSettings where the underlying directories and there content does not exist . This DLNames are only for Daimler internal use. Just ignore these messages or delete them from the environment: Example: