DEFORM-3D Version 6.

1(sp1)
Unix/Linux Installation Notes
10-10-2007

2545 Farmers Drive, Suite 200

Columbus, Ohio, 43235
Tel (614) 451-8330
Fax (614) 451-8325
Email support@deform.com

Contents
UNIX/LINUX SYSTEM INSTALLATION............................................................................................... 3
INSTALLING DEFORM-3D ............................................................................................................... 3
Mounting the CD ........................................................................................................................... 3
Platform Specific Mounting Instructions................................................................................................. 4
Running the INSTALL Script .................................................................................................................. 5
Manual Installation (In case the automatic installation has problems)................................................. 7
Installing the password file...................................................................................................................... 7
Setup a user account .............................................................................................................................. 7

System Execution ......................................................................................................................... 9

Installation related problems ...................................................................................................... 10
Simulation aborted by the user............................................................................................................. 10
Invalid program copy............................................................................................................................. 10

FINAL COMMENTS .............................................................................................................................. 11

Unix/Linux System Installation

In order to load the DEFORM-3D system on your machine, you need the version of the
operating system labeled on the CD or on the DEFORM website and a FORTRAN compiler if
you need to use user routines (optional). Approximately 1 GB of disk space will be required for
this installation. The installation script INSTALL3D located on the CD-ROM will install the required
files on your system. The platform independent file contains the manuals, labs, examples and
other utilities. The platform specific file contains the DEFORM executables and Python.

Installing DEFORM-3D
The first step in the installation is to mount the installation CD-ROM. Mounting a CD-ROM makes
the files from the CD available for use in the file structure of the system. On some systems (SGI,
Sun) this is accomplished automatically by an auto mount daemon. On other systems this task
must be performed manually. In most cases administrative privileges (root) are required to mount
a disk. Note: The CD must be mounted in a manner such that long filenames are available,
otherwise the installation script will not work properly. The DEFORM-3D installation disk is
created using the ISO9660 format with both Rock Ridge and Joliet extensions.

Mounting the CD
Note: With few exceptions, these steps must be performed as root. The devices and mount points
used in the examples may vary from system to system. Consult a System Administrator for
details about a specific system.
If the directory where the CD is to be mounted does not exists create it. A typical mount point for
a CD is /cdrom. This directory can be created using the command: # mkdir /cdrom The CD
directory will be referred to as /cdrom in this installation procedure. If it is different, substitute the
site dependent directory name. Load the release CD-ROM in the CD-ROM drive and mount the
CD-ROM using the following commands (to use this you must be logged in as root).

Platform Specific Mounting Instructions

HP TRU64
% mount -r /dev/device /cdrom or % mount -t cdfs /dev/device /cdrom as needed to
mount the CD with long filename support.

HP-UX
To properly mount a DEFORM CD on HP-UX the following procedure must be
followed:
This is a summary of instructions detailed at http://www.faqs.org/faqs/hp/hpuxfaq/ Section 5.3.8
Create (or alter) /etc/pfs_fstab to include a line as follows: /dev/dsk/c0t0d0 /CDROM pfsrrip xlat=rrip 0 0 Where /dev/dsk/c0t0d0 is the device and /CDROM is an existing
directory where you will be mounting the device. Start the pfs daemons with the
following commands: # nohup pfs_mountd & # nohup pfsd 4 & Mount the drive: #
pfs_mount /dev/dsk/c0t0d0 /CDROM Note: You must use pfs_umount to unmount a disk
mounted with pfs_mount.

Linux
mount /mnt/cdrom

Running the INSTALL Script

Note: The installation is generally performed as an ordinary user, not as root.
Once the CD-ROM is mounted, DEFORM may be installed using the following
commands:
1. Change to the CDROM directory (as appropriate for your system): % cd /cdrom
2. Run the installation script as follows:
% ./INSTALL3D
+---------------------------------------------+
| SCIENTIFIC FORMING TECHNOLOGIES CORPORATION |
+---------------------------------------------+
DEFORM-3D INSTALL SCRIPT
Telephone: (614) 451-8330
Fax : (614) 451-8325
E-Mail : support@deform.com
Web Site : http://www.deform.com
+--------------------------------------------+
| NOTE : If at any time you want to stop the |
| installation process, press Ctrl-C
|
| to abort the process.
|
+--------------------------------------------+
Press the Enter key to continue...
3. After pressing Enter the user should receive the following message:
DEFORM is a licensed product protected by copyright law
and international treaties. Unauthorized use,
reproduction and/or distribution of this program, or
any portion of it, may result in severe civil and
criminal penalties, and will be prosecuted to the
maximum extent possible under the law. By installing
and/or using DEFORM or any portion of DEFORM, you agree
to the terms and conditions, as specified in the DEFORM
license agreement. You will not be able to use,
download, or install any DEFORM software unless you
agree to the terms of such end user license agreement.
Any use of the software beyond the scope of the DEFORM
License Agreement, would be a violation of the license
and possibly, copyright law. Scientific Forming
Technologies Corporation (hereafter "SFTC") shall not
be liable for any damages of any kind through the use
of DEFORM, including without limitation, loss of
profits, loss of use, interruption of business, and
indirect, special, general, incidental, or
consequential damages, arising out of or in connection
with the furnishing, use or operation of the Software.
SFTC reserves the right to change products, services,
prices, and programs at any time, at its sole
discretion, without notice. Any rights not expressly

4.

5.

6.

7.

granted herein are reserved. This Agreement may not be

and shall not be deemed or construed to have been
modified, amended, rescinded, canceled or waived in
whole or in part, except by the express written consent
of an SFTC executive.
Enter "YES" to accept the agreement or "NO" to cancel
the installation. Yes
After entering YES, the following information is available (the text for the Linux
installation is seen below):
Starting installation. Installation files found in:
/cdrom/LINUX_2.6.8-24.5-DEFAULT Enter "YES" to install
in the default directory /usr/local/deform/3d/v61 or
"NO" to select another directory. No
Enter YES or NO based on whether the default directory is correct or not. If NO
is entered, please enter the different installation directory.
Starting installation. Enter the full path to
installation target directory: /home/deform/3d/v61 The
directory /home/deform/3d/v61 does not exist. Do you
want to create the directory /home/deform/3d/v61 ? y
(optional) If the directory desired does not exist, the user will be prompted
whether or not to create this directory. Enter y if the directory should be created.
Installing platform dependent files in
/home/deform/3d/v61 Please wait...
.......................................................
.......................................................
.......................................................
.......................................................
.
Installing platform independent files in
/home/deform/3d/v61 Please wait...
.......................................................
.......................................................
.......................................................
.......................................................
.
INSTALL COMPLETE
The installation is finished at this stage. Please continue on in the installation
notes for other important steps. Note: This script installs DEFORM from files
on the installation CD or from a user defined directory. The default configuration
is installed in a user specified directory depending on the platform and product. If
this script does not work the installation can be performed manually. DEFORM
products for Unix/Linux platforms consist of one platform specific file and one
platform independent file. These files are tarred using GNU tar
http://www.gnu.org/software/tar/ and they are best extracted with GNU tar for the
installation. Additionally the installation files are compressed using the standard
Unix/Linux compress function.

Manual Installation (In case the automatic installation has

problems)
In order to install the DEFORM(tm) software manually perform the following steps:
You have two options: a) Mount the CD b) Copy the files into a temporary directory from
another system or the DEFORM User Area. Here is an example of an installation of
DEFORM-3D in the ~/deform3d directory on a Linux system: The user is deform with
a home directory of /home/deform . (In this case the dollar sign $ is the command prompt
for a non-root user.) The CD is inserted into the drive and mounted on /mnt/cdrom . The
installation directory is created: $ mkdir ~/deform3d $ cd ~/deform3d The required files
for the DEFORM-3D on Linux are: The platform specific file:
3DV61_BETA2_LINUX_2.4.20-28.7.TAR.bz2 And the platform independent file
DEF3DV61.TAR.bz2 Since our platform has bunzip and GNU tar in default path we can
extract them in the current directory using the following command: $ tar -xvjf
/mnt/cdrom/3DV61_ALPHA_LINUX_2.4.20-28.7.TAR.bz2 $tar -xvjf
/mnt/cdrom/DEF3DV61.TAR.bz2

Installing the password file

A file named DEFORM.PWD should have been sent by e-mail with the
installation. Please copy this file the main directory where DEFORM-3D has
been installed (i.e. where the folders LABS, DATA and MANUALS are located).
Make sure that this file has read permissions enabled for all users. If a password
is required please contact Ms. Engelbrecht and mengelbrecht@deform.com.

Setup a user account

Make sure the default login shell is "C" shell (csh). We will assume the
DEFORM-3D user name is "user1" and the login directory is "/disk1/user1".
Log into the user account and edit 'C' shell login command file, ".cshrc", to
include the following two command lines: setenv DEFORM3_DIR
'/usr/deform/3d/v61' source $DEFORM3_DIR/CONFIG.COM The first command
line defines the global symbol "DEFORM3_DIR" to be the DEFORM-3D
directory. The second line executes the DEFORM configuration file
"CONFIG.COM". Note : The user can use any shell (csh,bash,tcsh...) but the "C"
shell file must have the above lines. Also the settings should be active for all
shells, not just interactive shells.
You may log out the system at this time. Next time you log into the system, the
above command lines will be executed automatically.
If you decide to stay in the system at this time, you need to execute ".cshrc"
manually since its contents have changed. To do that, enter % source .cshrc
To verify the definition of DEFORM3_DIR, you may enter "printenv" or "setenv"
from the keyboard. The system will display the definition of DEFORM3_DIR and
DEFORM_USER: DEFORM3_DIR=/usr/deform/3d/v61
DEFORM_USER=/disk1/user1

HP Intel Xeon XC-2000 Cluster updates

How to install OpenFabrics Infiniband support
You should be running HPMPI 2.2.5.
The following steps need to be done on each node in the cluster:
1. Edit /etc/security/limits.conf
Add the following lines:
*
*

soft memlock 7000000

hard memlock 7000000

The values should be at least 75% of the installed memory.

2. Download and install the 32 bit version of sysfsutils.
#rpm -Uvh sysfsutils-1.2.0-1.i386.rpm
3. Copy vapi-linux-release into /etc/ if it does not already exist.
cp -p /var/lib/systemimager/images/base_image/etc/vapi-linux-release
/etc/vapi-linux-release
4. Download OFED-1.1.tgz from http://www.openfabrics.org/
# tar -xvzf ./OFED-1.1.tgz
# cd OFED-1.1
# ./build.sh
Select 2) "Build InfiniBand Software RPMs"
Select 1) "Basic (InfiniBand modules and basic user leve libraries)"
Select "Y" when asked "Do you want to include IPoIB configuration files (ifcfgib*)?"
Select a temporary directory or use the default "/var/tmp/OFED"
Select the default installation directory "/usr/local/ofed"
After it finishes (10 minutes at most), you can request that the temporary build
directory be removed.
Select Q to exit
5. Install the openfabrics build:
# ./install.sh
Select 2) "Install OFED Software"
Select 1) "Basic (InfiniBand modules and basic user level libraries)
Select Y when asked to continue

Select Y when asked "to configure IPoIB interface" you will probably want to
keep your prior configuration.
Select Q to exit
6. Reboot the entire cluster.
7. Notes:
You may need to configure the network interface. Here is a sample
configuration:
[root@n4 ~]# cat /etc/sysconfig/network-scripts/ifcfg-ipoib0
DEVICE=ipoib0
ONBOOT=yes
BOOTPROTO=static
IPADDR=172.22.0.4
NETMASK=255.255.0.0
BROADCAST=172.22.255.255
MTU=2044

System Execution
The following procedure may be used to run the DEFORM-3D system:
Log into the DEFORM-3D user account from an X-terminal
Invoke the DEFORM-3D System by issuing:
% DEFORM3D (Text based interface)
% DEFORM3 (QT Graphical based system)
% DEF3 (Motif Graphical based system)
Program modules in DEFORM-3D System can also be invoked independently
by issuing:
% DEF_PR3 (Motif-Based Pre-processor)
% DEF_PP3 (Motif-Based Post-processor)
% DEF_AMG3 (Automatic Mesh Generation Module)
% DEF_PRE3 (Input Preparation Module)
% DEF_SIM3 (DEFORM-3D Simulation)

Installation related problems

Simulation aborted by the user
Simulation stops after one step with the message SIMULATION ABORTED BY
USER. If the simulation status file protection is not set properly then the message
SIMULATION ABORTED BY USER will appear when trying to run a simulation. If
the status file is corrupted for any reason, a new status file can be generated
using the INSTALL3D script: Go to the DEFORM-3D directory % cd
/usr/deform/3d/v61 Run the script INSTALL3D and select the option 1 to create a
new status file % INSTALL3D
Invalid program copy
In order to run DEFORM on your computer a valid password file for the
computer is required. This file ensures that DEFORM will work only on a single
computer between the dates in the license agreement. If DEFORM is installed
on a computer for which a valid password is not present then DEFORM will not
work. The license file is stored in the DEFORM3_DIR directory in the file
DEFORM.PWD. This file is created when the system is installed or when a new
password is entered. The file has the company name and also one line for each
product that is licensed. Possible reasons for getting an INVALID PROGRAM
COPY message:
1. The license has expired.
2. The version of DEFORM that is installed is different from the one that is
licensed.
3. The computer on which DEFORM is installed is different from the one
that DEFORM is licensed on.
4. The environment variable DEFORM3_DIR does not point to the proper
directory.
5. DEFORM.PWD exists but there is invalid data in this file.
6. When copying this file from a PC the Ctrl-M characters were appended at
the end of each line.
Some of the above situations will not arise if DEFORM was working and
suddenly stopped working. In most situations the license has probably expired
and a new license has to be obtained from Scientific Forming Technologies
Corporation.

10

Final Comments
Unix is type-case sensitive. Most of the Unix commands are in lower case.
Please note that all the main DEFORM system files and commands are in
upper case. DEFORM system is copy protected. For this release, the
DEFORM system is set to expire on the date your current license expires. In
this document, we have briefly explained how to load and execute DEFORM
System. If you need further technical assistance, please contact us at the
following address/numbers:
Scientific Forming Technologies Corporation
2545 Farmers Drive, Suite 200
Columbus, Ohio 43235
USA
Phone: (614) 451-8330
Fax: (614) 451-8325
Email: support@deform.com
Web: www.deform.com

11