Einsteiger Fortgeschrittene Profis markus.meinl@m-quest.ch Version 1.2
Voraussetzungen für diesen Workshop Sie sind mit dem Betriebsystem vertraut Sie besitzen Administrator-Rechte Die M-Quest Suite ist installiert Sie kennen das Installationsverzeichnis von Unigraphics Unigraphics NX1, NX2, NX3, NX4, NX5 oder NX6 ist/sind auf dem Server oder Client installiert Lesen Sie weiter, was dieser Workshop behandelt 2
In diesem Workshop lernen Sie Wie Sie den Programmcode der Unigraphics Schnittstelle installieren Was M-Quest unter der Unigraphics Schnittstelle versteht Was zu beachten ist wenn Sie diese einrichten möchten Wie die Schnittstelle eingerichtet wird Wie Unigraphics gestartet werden soll Wie Sie mit einem Trick viele Unigraphics Clients schnell aufsetzen Wie M-Quest aus Unigraphics aufgerufen wird Lassen Sie uns nun beginnen 3
Bevor wir loslegen Das Einrichten der Unigraphics Schnittstelle ist denkbar einfach. M-Admin erledigt alle Anpassungen für Sie automatisch. Damit die Installation reibungslos abläuft, müssen Sie sich zuerst folgende Fragen stellen: 1. Ist der M-Quest Programmcode für die Unigraphics Schnittstelle installiert? 2. Ist Unigraphics auf dieser Arbeitsstation installiert? Dieser Workshop behandelt alle möglichen Themen der M-Quest Unigraphics Schnittstelle. Wir werden Sie an der entsprechenden Stelle darauf hinweisen. Anmerkung: Bitte nehmen Sie zur Kenntnis, dass die Bezeichnung Unigraphics ein eingetragenes Markenzeichen ist. Wir werden in diesem Workshop den Namen Unigraphics ohne das Trade Mark Symbol verwenden. Andere Hersteller bieten ebenfalls Erweiterungen für Unigraphics an oder Ihre Firma besitzt spezielle Anpassungen, welche auch berücksichtigt werden müssen. Wir zeigen Ihnen in diesem Workshop, wie einfach M-Quest die Schnittstelle integriert und wo Sie gegebenenfalls abweichen können. 4
Programmcode von Unigraphics installieren/reparieren 1 Sind Sie mit der Struktur von M-Quest noch nicht so vertraut, dann wissen Sie vielleicht nicht, ob der Programmcode der M-Quest Unigraphics Schnittstelle installiert ist. Folgen Sie einfach den nächsten Ausführungen und Sie sind anschliessend sicher, dass dieser korrekt installiert ist. 2 1. Starten Sie M-Admin über das Ikon auf dem Arbeitsbereich, über das Windows Start-Menü oder direkt aus dem Startverzeichnis von M-Quest 2. Wählen Sie die Rubrik Installation ändern oder reparieren 3. Drücken Sie den Taster [Weiter] Tipp: Ist die Variable %MQ_UGRAF_MODULE_DIR% aktiviert und das Verzeichnis existiert, dann ist der Programmcode installiert. Mehr zu diesem Thema erhalten Sie im Workshop M-Quest Suite Umgebung. 3 5
Programmcode von Unigraphics installieren/reparieren 1 1. Aktivieren Sie das Kontrollkästchen Schnittstelle M- Quest Unigraphics 2. Drücken Sie den Taster [Weiter] und folgen Sie den Anweisungen des Assistenten um die Installation abzuschliessen x. Das Installationsprogramm installiert die fehlenden Dateien und lädt automatisch den letzten Patch nach. Laufende Dienste werden berücksichtigt 2 Information: Ist das Kontrollkästchen aktiviert und der Eintrag ausgegraut, dann ist der Programmcode bereits installiert. Sie können fortfahren und den Programmcode nochmals überschreiben oder Sie drücken Sie den Taster [Abbrechen] um M-Admin zu beenden. 3 4 5 6 6
Schnittstellen zu anderen Anwendungen Unigraphics M-Quest Suite Eine kurze Einführung, wie M-Quest die Schnittstelle zu Unigraphics einrichtet: 1. M-Quest erweitert die Unigraphics Umgebungs-Datei %UGII_ENV_FILE% mit zusätzlichen M-Quest Variablen. 2. Die M-Quest Anwendungen werden über eine eigene Ikon-Liste hinterlegt. Diese Information wird in der Datei %UGII_CUSTOM_DIRECTORY_FILE% definiert. 3. M-Quest erstellt ein eigenes Startskript (CMD-Skript) für den Aufruf von Unigraphics. Dieses Skript initialisiert alle notwendigen Schritte um die Schnittstelle zu starten. Dabei wird automatisch geprüft, ob es sich bei der Unigraphics-Installation um eine 32- oder 64Bit-Version handelt. 4. M-Admin erstellt das Startskript in einer Art, dass jede Unigraphics Installation für sich anders sein kann. Sind hingegen alle Unigraphics Arbeitsstationen identisch aufgesetzt, dann kann M-Admin diesen Umstand berücksichtigen. 7
Was muss beachtet werden beim Einrichten? Server Client(s) \\<server>\mquest2005\run_win\m-admin Server + Client Einzelplatzstation C:\Shared\mquest2005\run_win\M-Admin M-Admin erstellt das Startskript und modifiziert zwei Unigraphics-Dateien automatisch für Sie. Dazu wird das Basis- und das Wurzel-Verzeichnis sowie die Umgebungsdatei von Unigraphics verwendet. Es ist daher notwendig, dass bestimmte Unigraphics-Dateien auf dem Rechner vorhanden sind: Wir unterscheiden zwei Varianten: 1. Variante Server / Client(s): Die M-Quest Suite ist inklusive der Unigraphics Schnittstelle auf dem Server installiert. Die Anwendung Unigraphics ist nicht auf dem Server verfügbar. Ein oder mehrere Clients beziehen die M-Quest Suite vom Server und haben Unigraphics lokal installiert. Die Schnittstelle muss vom Client aus installiert werden. Starten Sie M-Admin mit \\<server>\mquest2005\run_win\m-admin. 2. Variante Einzelplatzstation: Hier ist alles lokal verfügbar, Starten Sie M-Admin normal auf dem Rechner und richten Sie die Unigraphics Schnittstelle auf diesem Rechner ein. 8
Schnittstelle M-Quest und Unigraphics einrichten Variante: Server / Client Starten Sie M-Admin von einer Arbeitsstation aus (dort wo Unigraphics installiert ist): Variante: Einzelplatz oder Server und Client Starten Sie M-Admin lokal aus dem Startverzeichnis der M-Quest Suite: Dieser Rechner hat die Installation der M- Quest Suite nicht durchgeführt und hat daher keine Administrator-Rechte. Dieser Rechner hat die M-Quest Suite eingerichtet und ist daher auch in der Lage diesen zu Administrieren! 9
Schnittstelle M-Quest und Unigraphics einrichten 1. Wählen Sie die Rubrik Diese Arbeitsstation einrichten 2. Drücken Sie den Taster [Weiter] 3. Die Seite für die Angaben der verschiedenen Unigraphics Installationen erscheint. Ist noch keine Unigraphics Schnittstelle eingerichtet, ist alles deaktiviert. 4. Wählen Sie die Rubrik Ich möchte Unigraphics anpassen 1 3 4 2 10
Schnittstelle M-Quest und Unigraphics einrichten 2 5 1 1. Wählen Sie die Unigraphics-Version 2. Geben Sie das Basis-Verzeichnis an und drücken Sie die Taste <Enter> oder holen Sie sich diesen Wert mit dem Verzeichnis-Explorer. M-Admin füllt die anderen Eingabefelder mit den Standardwerten von Unigraphics aus 3. Überprüfen Sie das Wurzelverzeichnis 4. Überprüfen Sie die vorgeschlagene Umgebungsdatei 5. Wiederholen Sie diesen Schritt, wenn Sie mehrere Unigraphics-Versionen gleichzeitig einsetzen 6. Drücken Sie den Taster [Weiter] 3 4 6 Unigraphics NX6 ist verfügbar, wenn Sie die M-Quest Suite 2005-S oder höher einsetzen. 11
Schnittstelle M-Quest und Unigraphics einrichten Der Assistent zeigt Ihnen immer an, welche Dateien gerade bearbeitet oder angepasst werden. Bei einem Fehler sehen Sie sofort, welche Datei Probleme verursacht hat. Der Assistent wird Sie auch nach der I-deas Schnittstelle fragen, sofern diese vorher eingerichtet wurde. Übernehmen Sie diese Einstellungen damit diese nicht entfernt werden. Drücken Sie den Taster [Weiter] solange, bis die Schnittstelle eingerichtet ist und M-Admin beendet werden kann. Auf der nächsten Seite wollen wir Ihnen aufzeigen, was M-Admin erstellt hat und wie Sie diese Informationen nutzen können. 1 2 3 12
Schnittstelle M-Quest und Unigraphics einrichten Variante: 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 Variante: Einzelplatz oder Server und 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 Das Unigraphics Basisverzeichnis ist lokal und zeigt auf C:\Design\Unigraphics NX5-64. Das Startskript ugraf_nx5.cmd wurde in das rechnerspezifische Verzeichnis custom\hosts\mqws03 erstellt. Der Aufruf dieses Skripts erfolgt über die Verknüpfung Desktop\Unigraphics NX5 M-Quest 2005.lnk. Dieses Ikon werden Sie auf dem Desktop des Clients finden. Das Unigraphics Basisverzeichnis ist lokal und zeigt auf C:\Design\Unigraphics NX5. Das Startskript ugraf_nx5.cmd wurde in das zentrale Verzeichnis interface\ugraf erstellt. Der Aufruf dieses Skripts erfolgt über die Verknüpfung Desktop\Unigraphics NX5 M-Quest 2005.lnk. Dieses Ikon werden Sie auf dem Desktop des Rechners finden. Ergänzend wurde die Verknüpfung noch in das Start-Verzeichnis run_win\unigraphics NX5.lnk erstellt. Einsteigern empfehlen wir, die Schnittstelle von jedem Client aus einmal mit M-Admin einzurichten. So kann M-Admin die Anpassungen für Sie verwalten. Fortgeschrittene Administratoren können die Installation der Clients vereinfachen. Legen Sie das Startskript von Unigraphics und die beiden Dateien %UGII_ENV_FILE% und %UGII_CUSTOM_DIRECTORY_FILE% an einen zentralen Ort. Ändern Sie lokale Variablen mit UNC-Pfaden, damit ein Client diese Dateien lesen kann. So sind alle Clients automatisch mit Unigraphics verwendbar (ohne lokale Anpassung). 13
Wie wird Unigraphics gestartet? 01 @echo off 02 setlocal 03 rem # -------------------------------------------------------------------------- 04 rem # ugraf.cmd -- 05 rem # 06 rem # Copyright (c) 1996-2008 M-Quest Software AG 07 rem # -------------------------------------------------------------------------- 08 if "x%ugii_lang%" == "x" set UGII_LANG=english 09 rem # -------------------------------------------------------------------------- 10 set UGII_BASE_DIR=C:\Design\Unigraphics NX5 11 set UGII_ROOT_DIR=C:\Design\Unigraphics NX5\ugii 12 set UGII_ENV_FILE=C:\Design\Unigraphics NX5\ugii\ugii_env.dat 13 rem # -------------------------------------------------------------------------- 14 set MQ_BASE_DIR=C:\Shared\mquest2005 15 if exist "%UGII_ROOT_DIR%\msvcr80.dll" goto mqroot_64bit 16 if exist "%UGII_ROOT_DIR%\MSCsrv32.exe" goto mqroot_64bit 17 set MQ_ROOT_DIR=C:\Shared\mquest2005\binary\i686_windows 18 goto mqroot_64bit_end 19 :mqroot_64bit 20 set MQ_ROOT_DIR=C:\Shared\mquest2005\binary\i686_windows\64 21 :mqroot_64bit_end 22 set PATH=%MQ_ROOT_DIR%;%PATH% 23 rem # -------------------------------------------------------------------------- 24 start "Title" "%UGII_ROOT_DIR%\ugraf.exe" %* 25 rem # -------------------------------------------------------------------------- 26 endlocal 27 @echo on Skript ugraf_nx5.cmd Zeile 08 setzt die Dialogsprache von Unigraphics wenn diese noch nicht gesetzt ist. In Zeile 10 wird das Basisverzeichnis und in Zeile 11 das Wurzelverzeichnis von Unigraphics gesetzt. Die Zeile 12 definiert die Umgebungsdatei von Unigraphics. Alle drei Variablen werden in diesem Skript explizit gesetzt, damit die richtigen (modifizierten) Werte verwendet werden. Zeile 14 Bestimmt das M-Quest Basisverzeichnis und in den Zeilen 15 bis 21 wird ermittelt, ob es sich bei der installierten Unigraphics-Version um eine 32- oder 64Bit Version handelt. Zeile 22 erweitert den Suchpfad, damit die Bibliotheken von M-Quest gefunden werden. Zeile 24 startet Unigraphics und das CMD-Skript wird beendet da dieses mit dem start Kommando aufgerufen wird. Das war schon alles! 14
Trick - Unigraphics Aufruf zentral für alle Clients verfügbar machen 01 @echo off 02 setlocal 03 rem # -------------------------------------------------------------------------- 04 rem # ugraf.cmd -- 05 rem # 06 rem # Copyright (c) 1996-2008 M-Quest Software AG 07 rem # -------------------------------------------------------------------------- 08 if "x%ugii_lang%" == "x" set UGII_LANG=english 09 rem # -------------------------------------------------------------------------- 10 set UGII_BASE_DIR=C:\Design\Unigraphics NX5 11 set UGII_ROOT_DIR=%UGII_BASE_DIR%\ugii 12 set UGII_ENV_FILE=\\<server>\Shared\nx5\ugii_env.dat 13 rem # -------------------------------------------------------------------------- 14 set MQ_BASE_DIR=\\<server>\Shared\mquest2005 15 if exist "%UGII_ROOT_DIR%\msvcr80.dll" goto mqroot_64bit 16 if exist "%UGII_ROOT_DIR%\MSCsrv32.exe" goto mqroot_64bit 17 set MQ_ROOT_DIR=%MQ_BASE_DIR%\binary\i686_windows 18 goto mqroot_64bit_end 19 :mqroot_64bit 20 set MQ_ROOT_DIR=%MQ_BASE_DIR%\binary\i686_windows\64 21 :mqroot_64bit_end 22 set PATH=%MQ_ROOT_DIR%;%PATH% 23 rem # -------------------------------------------------------------------------- 24 start "Title" "%UGII_ROOT_DIR%\ugraf.exe" %* 25 rem # -------------------------------------------------------------------------- 26 endlocal 27 @echo on Skript ugraf_nx5.cmd Kopieren Sie das Skript an einen Ort, wo M-Admin diese Datei nicht löschen kann (zum Beispiel interface ). Stellen Sie sicher, dass alle Clients dieselbe Unigraphics Umgebung haben. Passen Sie dazu Zeile 10 und 11 an. Die Umgebungs- Datei von Unigraphics legen wir an einen Zentralen Ort auf dem Server wie in Zeile 12 definiert. Die M-Quest Suite muss auch von jedem Client sichtbar sein, das erreichen Sie in Zeile 14, indem Sie einen UNC-Pfad auf den Server verwenden. Ändern Sie die Zeilen 17 und 20 ab, so dass diese ebenfalls korrekt gesetzt sind. Erstellen Sie eine Unigraphics Verknüpfung in das Start- Verzeichnis. So können die Clients Unigraphics starten. Die Verknüpfung zeigt dann auf das modifizierte CMD-Skript. Als nächstes müssen wir die Umgebungsdatei von Unigraphics überprüfen. Lesen Sie auf der nächsten Seite wie das geht Wichtig: Sie übernehmen jetzt die volle Verantwortung. Kontaktieren Sie uns nicht, wenn Unigraphics nicht korrekt startet 15
Trick - Unigraphics Aufruf zentral für alle Clients verfügbar machen 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-REMOVE- MQ_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- Umgebungsdatei ugii_env.dat Bei der Installation der Unigraphics-Schnittstelle, wurde die Unigraphics Umgebungsdatei %UGII_ENV_FILE% durch M-Admin modifiziert. Sie können nach dem Text MQUEST_START suchen. Ändern Sie dort das M-Quest Basisverzeichnis sowie Wurzelverzeichnis mit UNC-Pfaden ab. Damit Unigraphics auch neue Ikons erhält, muss die Datei custom_dirs.dat, zentral auf dem Datenserver abgelegt werden. Ändern Sie daher den Pfad der Unigraphics- Variable %UGII_CUSTOM_DIRECTORY_FILE% auf die neue Lage der Datei. # 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- Kundenmenüdatei custom_dirs.dat Startet ein Client, mit einer lokalen Unigraphics- Installation, das Unigraphics Startskript auf dem Daten- Server, dann benutzt dieser Client die M-Quest Umgebung automatisch! Der Client muss von M-Admin nicht gewartet werden. Die Pfade in diesem Beispiel sind frei erfunden und müssen für Ihre Installation angepasst werden. 16
M-Quest Anwendungen in Unigraphics aufrufen M-Plot M-Plot Setup M-Shot 17
Zusammenfassung Bevor die Unigraphics Schnittstelle eingerichtet werden kann, muss der Programmcode installiert sein. Das muss lokal auf dem Rechner mit M-Admin oder direkt bei der Installation erfolgen. Hat der Rechner auch Unigraphics installiert, dann können Sie mit M-Admin die Schnittstelle direkt einrichten. Haben Sie andere Rechner mit Unigraphics, welche diese Installation auch benutzen wollen, dann starten Sie M-Admin über den UNC-Pfad \\<server>\shared\mquest2005\... und installieren die Unigraphics Schnittstelle Unigraphics muss mit dem auf dem Arbeitsbereich erstellten Link gestartet werden, anderenfalls ist die M-Quest Suite nicht in Unigraphics eingebunden Haben Sie mehrere Unigraphics Clients, welche die M-Quest Suite benutzen wollen, dann empfehlen wir die zentrale Verwaltung der Unigraphics Umgebungsdatei inklusive der Menü- Datei. Wenn Sie mit dem Aufruf der M-Quest Suite vertraut sind und die M-Quest Umgebungsdatei ebenfalls zentral verwalten, dann sind Sie für den korrekten Aufruf und die Wartung zuständig. M- Admin wird immer eine lokale Umgebungsdatei anlegen, analog derjenigen von Unigraphics. Wichtig: Damit Sie via UNC-Pfade Zugreifen können, müssen Sie die M-Quest Installation auf dem Server freigeben. Die Clients müssen über Schreibrechte in der M-Quest Installation haben. Mehr hierzu erfahren Sie im Workshop M-Quest Suite Umgebung 18