QuickStart - Install GM Toolkit - CAD2008-02 (03/03/08)


========== GM Toolkit =========================================================

The GM Toolkit is comprised of three (3) separate packages. The GM Launch, GM 
Config and GM PDL. See the sections below for information on each of these packages.

========== GM Launch ==========================================================

Current version is:
  GM Launch 5.1 (should be current version, if not, upgrade!)

Download the following file from the GTAC Web site:
    gmlaunch_v5.1.tar.Z

Create a directory called /appl/gmlaunch5.1 (UNIX), C:\eng_apps\gmlaunch5.1(Windows).
Install (unzip/untar) the gmlaunch_v5.1.tar.Z file into this directory.

Create a directory called /data/gmlaunch (UNIX), C:\data\gmlaunch (Windows).
Copy the gmlaunch5.1.bat (Win) and/or gmlaunch5.1.ksh (Unix) file from the
gmlaunch5.1 directory above to this directory.

In your gmlaunch directory just above, edit the gmlaunch5.1.bat (Win) or
gmlaunch5.1.ksh (Unix) file to reflect your JAVA location, your GMLAUNCH_DIR
(the gmlaunch5.1 directory from above), and the location of your GMLAUNCH_DAT_FILE
(this should be /data/gmlaunch/gmlaunch.dat (UNIX), or
C:\data\gmlaunch\gmlaunch.dat (Windows)). If you used the suggested paths for
windows you will only have to change the R to a C for GMLAUNCH_DAT_FILE.

To launch the menu just create a shortcut on your desktop for the gmlaunch5.1.bat
file.

========== GM UG Config ========================================================

Current version is:
  GM UG Config 3e (should be current version, if not, upgrade!)

Download the following files from the GTAC Web site:
    gmconfig_3e_unix_07242006.tar
    gmconfig_3e_win_07242006.zip

In your UGNX base directory, unzip/untar the GM Config file for your platform.
You should then have a directory called gmconfig_3e_win\config (Windows) or 
gmconfig_3e_unix/config (UNIX) under the UGNX base directory.

In your gmlaunch.dat file, set the GMUG_CONFIG_DIR value to the above directory path
(UGNXBASE DIRECTORY/gmconfig_3e_unix/config or
C:\UGNXBASE DIRECTORY\gmconfig_3e_win\config).
(This should already be set in the GEES_GMlaunch_sample_CAD2008-02.dat file.)

***************************************************************************
***************************************************************************
You will need to go to GMSupplyPower and download the latest posted Material 
files, this notice should be located under the "Application Change Management" 
folder under GEES Links on the website. The latest ones were not included within
the 3e config package.
*****************************************************************************






========== GM PDL ==============================================================

Current version is:
  GMPDL 3-d.3.2

Download the following files from the GTAC Web site:
    tk_gmpdl3-d.1_base_common.tar.Z
    tk_gmpdl3-d.1_base_hp.tar.Z
    tk_gmpdl3-d.1_base_sun.tar.Z
    tk_gmpdl3-d.1_base_win.tar.Z
    tk_gmpdl3-d.3_patch_common.tar.Z
    tk_gmpdl3-d.3_patch_hp.tar.Z
    tk_gmpdl3-d.3_patch_sun.tar.Z
    tk_gmpdl3-d.3_patch_win.tar.Z
    tk_gmpdl3-d.3.2_patch.tar.Z


Create a directory called /appl/gpdl3d32 (UNIX), C:\eng_apps\gpdl3d32 (Windows). 

In your gpdl3d32 directory, unzip/untar the files in the following order:
  tk_gmpdl3-d.1_base_common.tar.Z
  Then each of the 3-d.1 platform base dependent files as needed.
  tk_gmpdl3-d.3_patch_common.tar.Z
  Then each of the 3-d.3 platform patch dependent files as needed.
  Then tk_gmpdl3-d.3.2_patch.tar.Z

In your gmlaunch.dat file, set the GMPDL_BASE_DIR value to your gpdl3d32
directory path. (This should already be set in the
GEES_GMlaunch_sample_CAD2008-02.dat file.)


========== gmlaunch.dat ========================================================

Download the following file:
  GEES_GMlaunch_sample_CAD2008-02.dat  

* you will rename this file to gmlaunch.dat

**If you do not replace your current gmlaunch.dat file you should compare
the new one to yours for added or changed variables? ****************

For UG/GMPDL workstations WITHOUT GM TcAE, Simply ignore any references to IMAN
or TcAE within this file.

The SUGGESTED location for the gmlaunch.dat file for easier maintenance, is a
shared drive. The SUGGESTED shared drive and directory is /data/gmlaunch (UNIX)
or C:\data\gmlaunch (Windows). You can put this file anywhere you want. 
Follow the instructions above to configure your GM Launch to know where you 
put it and what you called it.











The majority of the variables in the file will not require modification and should
be left alone. In most cases, the only variables that need to be modified are:

If you installed items in locations other than the suggested or default locations
then you may need to modify:

  UGII_BASE_DIR= the directory you installed UG-NX. (see NOTE below).
  UGII_LICENSE_FILE= your FlexLM license server(s).
  UGII_FLEX_BUNDLE= your FlexLM Package name(s).
  IMAN_DATA= the location you put your data directories. Multiple entries.
  WEB_BROWSER_EXE= location of Web Browser
  GMPDL_BASE_DIR= location of GM PDL
  GMUG_CONFIG_DIR= location of GM UG Config files
  
*NOTE:* The specified path to the GM TcAE installation is REQUIRED. You should NOT
      change the IMAN_ROOT= setting.






SPECIAL NOTE: On Windows platform workstations, the path settings can not include
spaces. Therefore, if you installed UG NX in it's default path then the
UGII_BASE_DIR settings must be specified in DOS 8.3 format. For example:

    C:\Program Files\EDS\Unigraphics NX3
      would probably be
    C:\Progra~1\EDS\Unigra~1
      in DOS 8.3 format.

You will have to check your workstation to find out for certain. ('dir /x' will show
path)


NOTE: On workstations without TcAE (NX only), when you run the Validate Resource
      File, you will get several warnings referring to TcAE/IMAN settings, these can
      be ignored or commented out of the file to remove the warning.

================================================================================