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