Ronald D. Kriz*, Associate Professor
Randy T. Levensalor**, Graduate Research Assistant
* Engineering Science and Mechanics, and ** Computer Science
Virginia Polytechnic Institute and State University
Blacksburg, Virginia 24061
2.1.1 Required Software:
2.1.2 Additional Software Required if NPIB Uses Remote Execution:
2.2.1 Download and extract the contents for the npib.tar file
Choose a temporary installation directory
2.2.2 Create a directory for the NPIB support scripts.
This directory should not be web accessible.
mkdir /usr/local/npib
2.2.3 Copy ssh.exp, scp.exp, and local.sh files to the directory created in step 2.2.2
These files should have been extracted from the npib.tar file in step 2.2.1
cp ssh.exp scp.exp local.sh /usr/local/npib
2.2.4 Create a CGI-accesible directory for the NPIB scripts.
mkdir /apache/htdocs/cgi-bin
i.e. on our Web server we used apache virtual hosting
2.2.5 Copy npib.cgi, npib.command, and npib.config to the CGI directory
created in step 2.2.4
These files should have been extracted from the npib.tar file in step 2.2.1
cp npib.cgi npib.command npib.config /apache/htdocs/cgi-bin
2.2.6 Create a web-accessible "output" directory for archiving simulation results
This "output" directory is created so that web server has permission to write to it.
mkdir /apache/htdocs/output
2.2.7 Create a web-accessible directory for the Java Form file (form.jar)
Create this directory so the web server has permission to write to.
mkdir /apache/htdocs/form
i.e. on our Web-server /www/jwave/npib was created for the Java Form file
NOTE: This directory's relative web location will be required
when users create NPIB forms.
For simplicity we recommend that only one copy of form.jar be included in
NOTE: this same form.jar file can be used outside of a Web-accessible
Make the following changes:
Make the following changes:
b.) Change the path in the last line of the script so that it points the
Syntax: The npib.commands file will consist of multiple one-line records.
<researcher_output-directory_name>
<full path to each user's npib.commands file>
NOTE: in the example given above kriz and rkriz can be different for
kriz = <researcher_output-directory_name>
"a name recognized by Web users"
For each new user the Web-server system administrator needs to add one line
2.0 Installation
2.1. Software:
Apache was used to develop NPIB. It can be obtained from http://apache.org
It can downloaded from http://java.sun.com
already be installed on your system. For open source software
on Solaris OS go to: http://www.sunfreeware.com.
2.2 Setting up NPIB: Web-server system administrator
http://www.jwave.vt.edu/npib/npib.tar
tar -xvf npib.tar
where /apach/htdocs/ is replaced with /www/jwave/ and
"www.jwave.vt.edu" has been defined as a virtual host.
chmod 755 /apache/htdocs/output
chown nobody /apache/htdocs/output
only one user is using NPIB you can locate the output directory in
that users ~/public_html/ directory and let that user manage their
own archived results. For multiple users we have located the output
directory on an 18GB disk mounted in the /etc/vfstab file at mount
point /www/jwave/output/ and used cron to check and clean up
directories that exceed a predetermined number of months/weeks.
chmod 755 /apache/htdocs/form
such that the form.jar file can be accessed at
http://www.jwave.vt.edu/npib/form.jar
2.2.8 Copy form.jar to the Web-accessible Form directory created in step 2.2.7
(This file should have been extracted from the npib.tar file in step 2.2.1)
the CLASSPATH by all users. For example on www.jwave.vt.edu, form.jar was
copied to Web accessible directory shown below.
Web-server: http://www.jwave.vt.edu/npib/form.jar
directory to create NPIB forms. We anticipated that some users will want
to create NPIB forms on remote workstations. In this case the same form.jar
file can be placed some where in the users home directory on the remote
workstation. The NPIB User's Guide section on "How-to-create NPIB-forms"
will demonstrate how users can build NPIB forms on remote workstations but
save the NPIB-form file back to the Web server using form.jar.
2.2.9 Edit the npib.config file
This file was copied to the CGI-enabled directory in step 2.2.5
The npib.config file should look like:
outroot /www/jwave/output/
webroot /output/
commandfile npib.commands
tempname npib.in
sshScriptDir /www/jwave/cgi-bin/
hostname www.jwave.vt.edu
email npib-admin@spelunker.sv.vt.edu
outroot - change this to the directory you created in step 2.2.6
webroot - set this to the path of the outroot directory,
as seen by the web server.
commandfile - this does not need to be modified.
This file states where the users command files are located.
tempname - this does not need to be modified
sshScriptDir - set this to the path of the directory you created in step 2.2.2
hostname - set this to the full dns name of this web server
email - this address will be the FROM address used when results
are mailed to users. Set this as desired (i.e. npib-admin).
2.2.10 Edit the npib.cgi file in the CGI-enabled directory setup in step 2.2.5
The npib.cgi file should look like:
#!/bin/sh
export CLASSPATH
CLASSPATH=/usr/local/java2/lib/:/apache/htdocs/form/form.jar
/usr/local/java2/bin/java form.run.CGIReceiver $QUERY_STRING
a.) Set the CLASSPATH variable to include the jar file from step 2.2.8,
and the standard java runtime classes
java runtime binary on your machine.
2.2.11 Edit npib.commands file in the CGI-enabled directory set up in step 2.2.5
The npib.commands file should look like:
kriz   /export/home/rkriz/public_html/npib/npib.commands
farkas   /export/home/diana/public_html/npib/npib.commands
batra   /export/home/rbatra/public_html/npib/npib.commands
Each record is used to tell NPIB the location of each user's npib.commands
file. A line consists of two fields, delimited by a space:
easier indentification by Web users who can recall the researcher's
name but not their email name. Often user account names are created
the same as their email names which can be cryptic and hard to remember.
which is the directory appended to the outroot path defined in step 2.2.9
rkriz = <user_home-directory_name>
which is the name of the user's home directory
to this file for each NPIB user. All other NPIB setup procedures is done by
each user in their respective ~/public_html/ directories. This npib.commands
file discussed above "points-to" the npib.commands file created by each user
in their respective ~/public_html/npib/ directory. The format for the user's
npib.commands file is discussed below in the next section 3.0.
Contact: Dr. Ron Kriz
Created 6/24/01 | Revised 2/22/02
http://www.jwave.vt.edu/crcd/archives/npib1.6/usersguide/installation.html