Install Unigraphics™ interface - M
Transcription
Install Unigraphics™ interface - M
Install Unigraphics™ interface Beginner Advanced markus.meinl@m-quest.ch © 1996–2009 M-Quest Software AG, Switzerland Experts Version 1.2 Prerequisites for this workshop • • • • • You are familiar with the operating system You have administrator rights The M-Quest suite is installed You know the installation directory of Unigraphics™ Unigraphics™ NX1, NX2, NX3, NX4, NX5 or NX6 is/are installed on the client or server Continue to read what this workshop can do for you … Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 2 In this workshop you learn • • • • • • • How you install the program code of the Unigraphics interface What M-Quest understands by the Unigraphics interface What you should concern if you would like to establish these How the interface is established How Unigraphics shall be started How you can setup fast many Unigraphics clients with a trick How M-Quest is invoked from Unigraphics Let us start now … Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 3 Before we start The setting of the Unigraphics interface is quite simple. M-Admin takes care of all customizations for you automatically. So that the installation can be done smoothly, you must ask yourself following questions first: 1. Is the M-Quest program code installed for the Unigraphics interface? 2. Is Unigraphics installed on this workstation? This workshop deals with all possible topics of the MQuest / Unigraphics interface. We will point out it to you in the appropriate place. Remark: Please note, that the name Unigraphics™ is a registered trade mark. We will use the name Unigraphics in this workshop without the trade mark symbol. Other manufacturers offers also extensions for Unigraphics or your company has special customizations which must also be considered. We show you in this workshop how simply M-Quest integrates the interface and where you can do your own modifications. Install Unigraphics™ interface 4 © 1996–2009 M-Quest Software AG, Switzerland Installing/repairing program code of Unigraphics … Are you not so familiar with the structure of M-Quest, then maybe you do not know whether the program code of the M-Quest / Unigraphics interface is installed yet so far. Simply follow the next explanations and you are sure then that this is installed correctly. 1 1. Start M-Admin from the icon on the workspace, over the Windows start menu or directly from the M-Quest start directory 2. Select the radio button “Modify or repair installation” 3. Push the button [Next] 2 Tip: If the variable %MQ_UGRAF_MODULE_DIR% is activated and the directory exists, the program code is then installed. You get more about this topic in the workshop “M-Quest Suite Environment”. 3 Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 5 Installing/repairing program code of Unigraphics 1. Activate the check box “Interface M-Quest – Unigraphics” 2. Push the button [Next] and follow the instructions of the assistant to complete the installation x. The installation program installs the missing files and loads the last patch automatically. M-Quest services are recognized are handled with care… 1 Information: Is the check box activated and the entry disabled, then the program code is already installed. You can continue and overwrite the program code again or you can push the button [Cancel] to exit M-Admin now. 2 3 4 Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 5 6 6 Interfaces to other applications Unigraphics M-Quest Suite Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland A short introduction how M-Quest establishes the interface to Unigraphics: 1. M-Quest extends the Unigraphics environment file %UGII_ENV_FILE% with additional M-Quest variables. 2. The M-Quest applications are deposited over an separate icon list. This information are defined in the file %UGII_CUSTOM_DIRECTORY_FILE%. 3. M-Quest creates a special CMD start script for the call of Unigraphics. This script initializes all necessary steps to start the interface. It checks automatically whether the Unigraphics installation is a 32- or 64-bit version. 4. M-Admin creates the start script in a way that every Unigraphics installation can be different from each other. If all Unigraphics workstations are setup identically, then M-Admin can take advantage of this installation method. 7 What has to be taken into account at the setting? Server + Client Single user station Server M-Admin creates the start script and modifies the Unigraphics environment automatically for you. The Unigraphics installation directory is used for it. It is therefore necessary that Unigraphics is installed on the computer. We therefore distinguish 2 variants: C:\Shared\mquest2005\run_win\M-Admin Client's \\<server>\mquest2005\run_win\M-Admin 1. Version server/client’s: The M-Quest Suite is installed, inclusive of the Unigraphics interface, on the server. The application Unigraphics is not available on the server. One or more clients obtain the M-Quest Suite from the server and have installed Unigraphics locally. The interface must be installed from the client. Start M-Admin with “\\<server>\mquest2005\run_win\M-Admin”. 2. Version single user station: Everything is locally available here. Start M-Admin directly on this computer and establish the Unigraphics interface. Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 8 Establishing interface M-Quest and Unigraphics … Variant: Server/Client Start M-Admin from a workstation (there, where Unigraphics is installed): Variant: Single user or Server and Client Start M-Admin locally from the start directory of the M-Quest Suite: This computer has established the MQuest Suite and therefore is able also administer this! This computer has not executed the installation of the M-Quest Suite and therefore does not have any administrator rights. Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 9 Establishing interface M-Quest and Unigraphics … 1. Choose the category “Setup this Workstation” 2. Push the button [Next] 3. The page for the details of the different Unigraphics installations appears. If no Unigraphics interface is established yet, everything is deactivated. 4. Choose the category “I would like to adapt Unigraphics” 3 1 4 2 Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 10 Establishing interface M-Quest and Unigraphics … 1. Choose the Unigraphics version 2. Indicate the base directory and press the key <Enter> or seek this value with the Directory Explorer. M-Admin will fill out the other entry fields with the defaults of Unigraphics 3. Check the root directory 4. Check the suggested environment file 5. Repeat this step if you use several Unigraphics versions at the same time 6. Push the button [Next] to continue 1 5 2 3 4 6 Unigraphics NX6 is available, if you use the M-Quest Suite 2005-R or higher. Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 11 Establishing interface M-Quest and Unigraphics … The assistant always reports to you which files are just edited or specified. At an error you immediately see which file problems has caused. The assistant will also ask you for the I-deas interface if this was established before. Please use these settings so that these are not removed from the installation. Push the button [Next] as long as, until the interface is established and M-Admin can be exited. On the next page we want to show you what M-Admin has created and how you can use this information. 1 2 Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 3 12 Establishing interface M-Quest and Unigraphics Variant: Server / Client modified: C:\Design\Unigraphics NX5-64\ugii\menus\custom_dirs.dat modified: C:\Design\Unigraphics NX5-64\ugii\ugii_env.dat created: \\Mqws02\shared\mquest2005\custom\hosts\mqws03\ugraf_nx5.cmd created: C:\Documents and Settings\All Users\Desktop\Unigraphics NX5 M-Quest 2005.lnk The Unigraphics base directory is local and points to “C:\Design\Unigraphics NX5-64”. The start script “ugraf_nx5.cmd” was created in the computerspecific directory of “custom\hosts\mqws03”. The call of this script is done via the short cut link “Desktop\Unigraphics NX5 M-Quest 2005.lnk”. You’ll find this icon on the desktop of the client. Variant: Single Workstation or Server and Client modified: C:\Design\Unigraphics NX5\ugii\menus\custom_dirs.dat modified: C:\Design\Unigraphics NX5\ugii\ugii_env.dat created: C:\Shared\mquest2005\interface\ugraf\ugraf_nx5.cmd created: C:\Documents and Settings\All Users\Desktop\Unigraphics NX5 M-Quest 2005.lnk created: C:\Shared\mquest2005\run_win\Unigraphics NX5.lnk The Unigraphics base directory is local and points to “C:\Design\Unigraphics NX5”. The start script “ugraf_nx5.cmd” was created in the system directory of “interface\ugraf”. The call of this script is done via the short cut link “Desktop\Unigraphics NX5 M-Quest 2005.lnk”. You’ll find this icon on the desktop of the client. The supplementary short cut “run_win\Unigraphics NX5.lnk” is still created into the start directory of M-Quest. We recommend beginners to establish the interface once from every client with M-Admin. M-Admin can then manage the customizations for you. Advanced administrators can simplify the installation of the clients. Put the start script of Unigraphics and the two files %UGII_ENV_FILE% and %UGII_CUSTOM_DIRECTORY_FILE% to a central place. Change local variables with UNC paths so that a client can read these files. All clients can use Unigraphics (without a local customization) automatically. Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 13 How is Unigraphics started? 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 @echo off setlocal rem # -------------------------------------------------------------------------rem # ugraf.cmd -rem # rem # Copyright (c) 1996-2008 M-Quest Software AG rem # -------------------------------------------------------------------------if "x%UGII_LANG%" == "x" set UGII_LANG=english rem # -------------------------------------------------------------------------set UGII_BASE_DIR=C:\Design\Unigraphics NX5 set UGII_ROOT_DIR=C:\Design\Unigraphics NX5\ugii set UGII_ENV_FILE=C:\Design\Unigraphics NX5\ugii\ugii_env.dat rem # -------------------------------------------------------------------------set MQ_BASE_DIR=C:\Shared\mquest2005 if exist "%UGII_ROOT_DIR%\msvcr80.dll" goto mqroot_64bit if exist "%UGII_ROOT_DIR%\MSCsrv32.exe" goto mqroot_64bit set MQ_ROOT_DIR=C:\Shared\mquest2005\binary\i686_windows goto mqroot_64bit_end :mqroot_64bit set MQ_ROOT_DIR=C:\Shared\mquest2005\binary\i686_windows\64 :mqroot_64bit_end set PATH=%MQ_ROOT_DIR%;%PATH% rem # -------------------------------------------------------------------------start "Title" "%UGII_ROOT_DIR%\ugraf.exe" %* rem # -------------------------------------------------------------------------endlocal @echo on Line 08 sets the interactive language of Unigraphics if this is not already set yet. The base directory in line 10 and the root directory in line 11 is set for Unigraphics. The line 12 defines the environment file of Unigraphics. All three variables are set explicitly in this script so that the modified values are used. Line 14 determines the M-Quest base directory and the lines 15 to 21 determines whether the installed Unigraphics version is a 32- or 64-bit version. Line 22 refines the search path so that the libraries of M-Quest are found. Line 24 starts Unigraphics and the CMD script is completed because Unigraphics is called with the start command. That’s all folks! Script „ugraf_nx5.cmd“ Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 14 Trick - Make the Unigraphics call for all clients central available … 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 @echo off setlocal rem # -------------------------------------------------------------------------rem # ugraf.cmd -rem # rem # Copyright (c) 1996-2008 M-Quest Software AG rem # -------------------------------------------------------------------------if "x%UGII_LANG%" == "x" set UGII_LANG=english rem # -------------------------------------------------------------------------set UGII_BASE_DIR=C:\Design\Unigraphics NX5 set UGII_ROOT_DIR=%UGII_BASE_DIR%\ugii set UGII_ENV_FILE=\\<server>\Shared\nx5\ugii_env.dat rem # -------------------------------------------------------------------------set MQ_BASE_DIR=\\<server>\Shared\mquest2005 if exist "%UGII_ROOT_DIR%\msvcr80.dll" goto mqroot_64bit if exist "%UGII_ROOT_DIR%\MSCsrv32.exe" goto mqroot_64bit set MQ_ROOT_DIR=%MQ_BASE_DIR%\binary\i686_windows goto mqroot_64bit_end :mqroot_64bit set MQ_ROOT_DIR=%MQ_BASE_DIR%\binary\i686_windows\64 :mqroot_64bit_end set PATH=%MQ_ROOT_DIR%;%PATH% rem # -------------------------------------------------------------------------start "Title" "%UGII_ROOT_DIR%\ugraf.exe" %* rem # -------------------------------------------------------------------------endlocal @echo on Copy the script to a place, for example “interface”, where M-Admin cannot delete this file. Make sure that all clients have the same Unigraphics environment. Adjust line 10 and 11 to do this. We put the environment file of Unigraphics on a central place on the server like defined in line 12. The M-Quest Suite must also be visible from every client, you reach this in line 14 by using a UNC path pointing to the server. Modify the lines 17 and 20 so that these also are set correctly. Create a Unigraphics short cut into the start directory. So the clients can start Unigraphics. The short cut points then at the modified CMD script. As next we must check the environment file of Unigraphics. Read on the next page how easy this is … Script „ugraf_nx5.cmd“ Important: You are now taking over the full responsibility. Do not contact us if Unigraphics does not start correctly… Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 15 Trick - Make the Unigraphics call for all clients central available … UGII_DEFAULT_MENU_DIR=${UGII_BASE_DIR}\ugii\menus UGII_CUSTOM_DIRECTORY_FILE=\\<server>\Shared\nx5\custom_dirs.dat # … UGII_CAE_AFUAPP=${UGII_BASE_DIR}\ugstructures\ftk\afuapp.jar # # -----------------------------[MQUEST_START]--------------DO-NOT-REMOVEMQ_UG_VER = nx5 MQ_BASE_DIR = \\<server>\Shared\mquest2005 MQ_ROOT_DIR = %MQ_BASE_DIR%\binary\i686_windows # MQ_UG_PRINT_FILE = ${MQ_ROOT_DIR}\mplot.ugraf.${MQ_UG_VER}.dll MQ_UG_SETUP_FILE = ${MQ_ROOT_DIR}\mplot_setup.ugraf.${MQ_UG_VER}.dll MQ_UG_SHOT_FILE = ${MQ_ROOT_DIR}\mshot.ugraf.${MQ_UG_VER}.dll # UGII_CGM_DEFAULTS = ${MQ_BASE_DIR}\fonts\ugraf_cgm.map # ------------------------------[MQUEST_END]---------------DO-NOT-REMOVE- At the installation of the Unigraphics interface, the Unigraphics environment file %UGII_ENV_FILE% was modified by M-Admin. You can search after the text “MQUEST_START”. replace the M-Quest base directory as well as the root directory with UNC paths here. So that Unigraphics gets also new icons, the file “custom_dirs.dat” must be stored centrally on the data server. Therefore change the path of the Unigraphics variable %UGII_CUSTOM_DIRECTORY_FILE% on the new location of the file. Environment file „ugii_env.dat“ # Customer modifications can follow on here # # -----------------------------[MQUEST_START]--------------DO-NOT-REMOVE# # UNIGRAPHICS \ M-QUEST - INTERFACE # # At this place, all icons and menus for Unigraphics are defined. We # decide not to copy all this files in the native UG installation. This # makes the installation muche safer. # ${MQ_BASE_DIR}\interface\ugraf\toolbar_nx3 # ------------------------------[MQUEST_END]---------------DO-NOT-REMOVE- Starts a client with a local Unigraphics installation the Unigraphics start script on the data server then the client uses the M-Quest environment automatically! The client does not have to be managed by M-Admin. The paths in this example are made up and must be specified for your installation. Customer menu file „custom_dirs.dat“ Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 16 Starting M-Quest applications inside Unigraphics • M-Plot • M-Plot Setup • M-Shot Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 17 Summary • Before the Unigraphics interface can be established, the program code must be installed. This must be made locally on the computer with M-Admin or directly during the installation. • If the computer also has installed Unigraphics, then you can establish the interface with M-Admin directly. • If you have other computers with Unigraphics which also want to take advantage of this installation, then start M-Admin over the UNC path “\\<server>\Shared\mquest2005\...” and install the Unigraphics interface • Unigraphics must be started with the link created on the Desktop, otherwise the M-Quest Suite is not visible inside Unigraphics If you have several Unigraphics clients which want to use the M-Quest Suite, then we recommend the central administration of the Unigraphics environment file, inclusive of the menu file. If you are familiar with the M-Quest Suite and you manage the M-Quest environment file centrally, then you are responsible for the correct call and the servicing. A local environment file will always be created by M-Admin, analogue the one of Unigraphics. Important: So you are able to access via UNC path you have to release the M-Quest installation on the server first. The clients must have write access in the M-Quest installation otherwise they cannot store their settings. You learn more about this topic in the workshop “M-Quest Suite Environment” … Install Unigraphics™ interface © 1996–2009 M-Quest Software AG, Switzerland 18