|
Unix
Installation
Unix
Installation
Troubleshooting
Resources
Unix
Installation
Web Crossing
is available for a wide variety of Unix servers. All
of them are
installed the same way, but you should make sure that you have
downloaded the correct version for your server. Here is a list
of the available versions as of this writing. More versions for
different Unix systems can be requested. If demand is there and
a development environment is available a new server version can
be created.
| Archive
File Name |
Unix
Version |
| webx-310-std-linux20.tar.Z
|
Intel
compatible Linux running kernel 2.0x, such as
RedHat 5.2
|
| webx-310-std-linux22.tar.Z
|
Intel
compatible Linux running kernel 2.2x, such as
RedHat 6
|
| webx-310-std-solaris26.tar.Z
|
Solaris
SPARC station running Solaris 2.6 |
| webx-310-std-solaris27.tar.Z
|
Solaris
SPARC station running Solaris 2.7 (Solaris 7) |
| webx-310-std-x86sol27.tar.Z
|
Intel
compatible Solaris 2.7 (Solaris 7) |
| webx-310-std-freebsd22.tar.Z
|
Intel
compatible FreeBSD kernel 2.2x (non-threaded) |
| webx-310-std-freebsd33.tar.Z
|
Intel compatible FreeBSD kernel 3.x (threaded) |
| webx-310-std-bsdi3.1.tar.Z
|
Intel compatible BSDi 3.1 |
| webx-310-std-macosx10.tar.Z
|
Mac OS X Server |
| webx-310-std-linuxppc22.tar.Z
|
LinuxPPC (PPC chip) |
| webx-310-std-cobalt41.tar.gz
|
Cobalt Qube (MIPS chip) |
| webx-310-std-decunixos40.tar.Z
|
DEC Unix |
| webx-310-std-hpux102.tar.Z
|
HP-Unix |
| webx-310-std-irix62.tar.Z
|
Silicon Graphics IRIX 6.2 |
In this
section, we will use webx-310-std-linux20.tar.Z for all
examples, because Web Crossing Harbor is currently
running under RedHat
5.2 (Linux kernel 2.0). Just substitute your own archive name
when uncompressing the archive. Everything else will
be the same.
One question
many people have when first installing Web Crossing on Unix is
where to expand the archive. It really does not matter.
Doug often has Web Crossing running in his own home directory.
That is certainly OK. If that is most convenient for you, then
do it there.
Another
convenient place is the directory where all the user
directories
are found. For example, when installing Web Crossing
on a customer's
Linux machine, Doug usually downloads the archive to
the /home
directory and expands it there. This creates a
/home/webx directory for the Web Crossing server. Of course, you
must have
root (system administrator) privileges to do
that.
|
Warning:
While you can install your Web Crossing server anywhere,
it is best not to install it inside the hierarchy
of your external web server (for example, in the Apache
htdocs directory). This could make your
webx.db database
and other files downloadable by people through
the web (depending
on how your web server is set).
|
In this
example, we have downloaded webx-310-std-linux20.tar.Z
to the /home directory. A look at the directory before
expanding the archive looks like the listing in
figure 1.
(See the Telnet section for
more information
on using Telnet and Unix FTP.)
Figure
1 - the contents of the /home directory after downloading the
archive
The first
thing you need to do is uncompress the archive. In
this example,
the command needed, as shown in figure 1, is
uncompress
webx-310-std-linux20.tar.Z.
After entering that command the compressed file is uncompressed
and a standard Unix "tar" archive file
webx-310-std-linux20.tar
replaces it in the current directory.
|
Note:
The Cobalt Qube version is compressed using a different
format from the other Unix versions. To
uncompress the Cobalt
Qube version use the gunzip command instead of the
uncompress command.
|
The next
step is to extract the contents of the tar archive
with the command
tar xvf webx-310-std-linux20.tar
When
you issue this command, the webx directory is
created and
lots of files are extracted and placed in the
directory. You will
see a stream of file names flash across your screen,
faster than
you can read them. (If you can follow the list of file names as
they go by either you read faster than Evelyn Wood or
your computer
is really, really slow).
Next,
you will want to change your current directory to the
webx directory with the command
cd webx
Once
in the webx directory you will enter the
command
./webx-install
to install
your Web Crossing server.
If you
follow the prompts provided by the installer, you will be able
to automatically install Web Crossing in either direct
web services mode or
CGI mode.
To start
your Web Crossing server, enter the command
./make-run
To stop
your Web Crossing server, enter the command
./make-quit
After
starting your Web Crossing server, proceed to
Connecting for the First Time and go through the
basic setup
of your server.
Troubleshooting
I accidentally
installed in CGI Mode when I really wanted to install in Direct
Web Service mode (or vice-versa). What should I do?
Resources
Refer
to the documentation included with your installer for
the latest
release information.
Web Crossing
FAQ:
|
