Post Installation Instructions
RECOMMENDED POST INSTALLATION PROCEDURE
The GRIP Library, as shipped, contains all needed source files but
no execution files and only part of the HTML files used for the HTML
documentation. The execution files can be created by compiling and
linking the Library, and there is a utility in the libmgr directory
that will build all the HTML files. If you do not have a GRIP
Development license (and have at least one GRIP Execute license),
see Space and Time Requirements under the Library Documentation for
suggestions or contact the Librarian for suggestions.
To compile and link all the group files in the library, perform the
following steps:
Locate the Library. It is usually in a subdirectory called "griplib"
under the base Unigraphics directory. To get the name of the base
directory, select Help, UG Log file from a session of UG and look
for UGII_BASE_DIR. If installed, a directory called "griplib"
should be in the directory that UGII_BASE_DIR points to.
For the rest of this process, we'll assume your starting directory
is griplib. The directory pathnames listed below are for UNIX users.
If you are using Windows NT, the "/" should be replaced by the "\"
character in the true path, but you will be navigating by mouse, so
it should not be a problem.
Make sure that you have write access to the following directories:
./source/libmgr
./source/grip/main
./source/grip/subs
In the ./source/grip/main directory, make sure the gri.sea file exits.
If it does not, you can create it from OS-Specific copies:
For UNIX systems, copy the gri.sea.ux file to the name gri.sea,
using a command similar to: "cp gri.sea.ux gri.sea"
For NT systems, click on gri.sea.nt, copy and paste it and rename
the pasted file to gri.sea
Bring up the UniProducts menu for this version of UG. Click on
UGOPEN-GRIP to bring up GRADE. Type "P" followed by [enter] to
display only errors during compile.
Change directory to the griplib directory using the "d" command,
then change it to source/libmgr (source\libmgr for NT users).
Type "c", [enter], [enter] to compile all the files in this directory.
Type "l", [enter] "l*" [enter], then "l", [enter], "b*", [enter] to
link the librarian and build routines in this directory.
Change directory to ../grip/subs (..\grip\subs for NT).
Type "c", [enter], "*", [enter] to compile all the subroutines.
Change directory to ../main (..\main for NT).
Type "c", [enter], "*", [enter] to compile all the main programs.
Type "l", [enter], "*", [enter] to link all the main programs.
Note: If some of the main programs did not link, make sure the gri.sea
file exists and contains ../subs (..\subs for NT). If the errors
persist, or you see compile errors, contact the librarian at
griplibmgr@patriot-machine.com
If you made it this far without errors, GRIPLIB is now usable. If
you have an Intranet at your company, or just want to use a
browser to explore GRIPLIB the next process will create the needed
HTML files.
To protect files against accidental deletion, set the permissions on
the libmgr, main and subs directory (and their contents) to read only.
To build the HTML files (for use on your company's intranet), perform the
following steps:
Locate the griplib directory.
Make sure that you have write access to the following directories:
./intranet/grip
./intranet/grip/downlaod
./intranet/grip/fonts
./intranet/grip/libmgr
./intranet/grip/main
./instrnet/grip/subs
Logon Unigraphics, Select File, Execute UG/Open, Grip. Navigate to
the GRIPLIB directory. Click on source then libmgr in the directory
area. Select build_html_files, then OK.
The program will attempt to locate GRIPLIB based on the UGII_BASE_DIR
variable. If it succeeds, it will display the results as a default in
a text box. If it fails, you will have to type in the correct path.
Select OK when the path is right, select OK.
The next prompt shows the program defaults. For 99% of the users, these
settings can be used. If you are setting up an Intranet for a large
company and want to set up downloading of GRIP source file sets, toggle
the first choice to .tar.Z before selecting OK. To use the downloading
feature, contact the Librarian to get a copy of the necesary files. Select
OK to start building HTML files.
Program will list each file as it is built.
When the program finishes, change the permissions for the intranet/grip
directory (and all subdirectories) to read only.
There are several ways to access the Library. If you want to make the
Library easy to use, set UG_initialGripDir: to the value of
$UGII_BASE_DIR/griplib/source/grip/main. When File, Execute UG/Open, GRIP
is selected, the Library programs will be displayed in the dialog.
CONFIGURING LIBRARIAN
If you want the company/contact information to default to a particular
person's name, you can edit _COMPANY_DATA.GRS and then follow the steps
below.
If you feel confident about editing GRIP source, you can edit
_COMPANY_DATA.GRS in the LIBRARIAN directory to reflect the person most
"connected" with the Library. If you would rather use interactive menus
to do this, you can wait until after the LIBRARIAN program is ready, then
use the EDIT COMPANY DATA option on the second main menu, then re-compile
_COMPANY_DATA and link LIBRARIAN.GRI. See LIBRARIAN.DOC for more information
on this option.
The Librarian program can be run from anywhere in your system. Since
it automatically locates the Library, it can be stored in a directory
other than LIBRARIAN and can be run in a directory other than LIBRARIAN.
If you have a system-wide grip executable directory you can move
LIBRARIAN.GRX there after these steps are finished. If you do not have
a system-wide GRIP executable directory, you can move Librarian to the
MAIN directory and use that as the system-wide executable directory.
Note: if the Library is not stored under the directory defined by
UGII_BASE_DIR, you will have to define a variable/logical called
UGII_GRIPLIB using the new location of the Library.
SELECTING AND TRANSLATING FONT FILES:
All the fonts in GRIPLIB were compiled and copied to $UGII_BASE_DIR/
ugii/ugfonts during the building of GRIPLIB. There is no additional
work needed to access all of the font files in GRIPLIB.
If you receive font source files from a supplier or customer, you will
have to compile them using the ugfontc utility then copy them to
$UGII_BASE_DIR/ugii/ugfonts and open up permissions as needed.
SHRINKING THE LIBRARY
Ideally, the entire library can be kept online for users to
access, modify, and learn from. Of course, few system managers
have unlimited resources, so there are several things that can
be done to reduce the size of the library.
First, all temporary files can be deleted. These are files that
are created during the installation of the Library and are not
needed to use it. You can use the option FLUSH TEMPORARY FILES
under the SPECIAL FUNCTIONS menu in the Librarian program.
Do not select either delete option, since this WILL affect the
operation of the Library. By default, this routine deletes only
non-essential files.
Once you have translated the fonts you want into your system, you
can probably delete the font files. (The only time you'll need
them is if you want to use a program, such as N_C_ENGRAVE that
reads the font files). For more information on font files, see
the topics FONT MAPPING SUGGESTIONS and FONT CHARACTER STATUS.
Second, if you do not plan to edit or examine the program source
code, all the source files can be deleted as well. Since they are
on the release CD, it would be easy to reload the source of programs
you do decide to edit.
Lastly, most of the Library could be deleted, leaving only programs
actively being used. This limits access of the Library, but may be
necessary on severely limited systems.
POSTING THE LIBRARY ON YOUR COMPANY'S INTRANET:
If you have a company-wide intranet that is not accessable from the
Internet, you can copy the entire directory structure starting at
the "intranet" directory to a file server. Add a link to a page on your
intranet, pointing to "intranet/grip/index.html". When this link is
used, the main page for the GRIP library will be displayed. From there
your users can access all online documenation relating to the GRIP
international library.
DO NOT POST THE GRIP INTERNATIONAL LIBRARY ON THE INTERNET! The information
in GRIPLIB is considered public domain but should not be accessible to
people who are not licensed UG users. If you want to know why, contact
the Librarian.
If your users have access to the Internet, you can use UGS' Customer Support
web page to access GRIP International Library online. You will need a Webkey
account & password to log in.