********************************************************
# FILE NAME:     HOWTO
#                : How To Install Web+ on Unix/Linux/Solaris ... 
#
# Copyright (c) 2000 by talentsoft, inc.
# ALL RIGHTS RESERVED
#
# DESCRIPTION:
# Documentation:  How To Install Web+ on Unix/Linux/Solaris ... 
#
# NOTE:
#
# COMMENT:
#
# MAINTENANCE LOG:
# DATE      ADDITION/MODIFICATION  DESCRIPTION
# --------  ---------------------  ------------------
# 02/16/97  All                    Web+ 3.0 Unix release
# 09/30/98  Great                  Web+ 4.0 Unix release
# 4/01/00   Update                Web+ 4.6 Unix release
#******************************************************


TalentSoft Web+ for Sun Solaris/Linux Install HOWTO 
v4.6 Feb 1998
===============
         TalentSoft, Talent Information Management.
	 Tech Support: 612-338-8900
            email: support@talentsoft.com
check link  web:   http://www.talentsoft.com/scripts/webpconference/frameset.wml



This document provides an overview of the process through which one would install
Talentsoft Web+.


1. Introduction
===============
1.1. Assumptions
This document assumes that you have purchased or are using an
evaluation copy of Web+ 4.6 and that you have the proper permissions
to carry out all of the commands mentioned herein.  This particular
document goes offers support for Webplus 4.6 available for Solaris, 
Linux, FreeBSD versions of UNIX.  

1.2. Information Sources
There is a significant amount of information available on
Talentsoft's WWW site (http://www.talentsoft.com) as well as
technical support for paying customers.


2. File Location
================
2.1. Gunzip and Untar
The first step to installing the Web+ software package is to
gunzip and untar the file with the following command:
    gunzip -c webplus46.tar.gz | tar xvf -
    or
    gzip -cd webplus46.tar.gz | tar xv
    or even
    tar xvfz webplus46.tar.gz

2.2. INSTALL Script
Then you need to run the "install.sh" script inside the untar directory
above.  Remember that you have to be logged in as the superuser of the  
system to succesfully run the install script. The "install.sh" script will
install Webplus 4.6 onto your system by installing the software into the 
correct directories.  In the event of an install script failure, please email 
technical support at support@talentsoft.com.  

3. Configuration
================
3.1 Database Connectivity 
In most cases, you can achieve database connectivity using the native drivers 
supplied with Webplus 4.6. The following dababases are cuurently supported by 
Webplus 4.6: mySQL 3.22, postgreSQL 6.5, Oracle 7 (Solaris).  
ODBC is only necessary if you need to access a database not listed above.
Please refer to /<xyz>/webplus/odbc/HOWTO.

3.2. Setup Web+ Client and Web+ Server
You need to then set up your Web+ Client (webplus.conf) and
Web+ Server (webpsvr.conf) at:
    /<xyz>/webplus/bin/webpsvr.conf, and 
    /<httpd root>/cgi-bin/webplus.conf.

3.3. Startup Script 
The Web+ startup script is located at:
    /<xyz>/webplus/webpadmin
Depending upon your  initialization scheme, you can
copy this file to the appropriate place in the rc.d hierarchy:

    cp /<xyz>/webplus/webpadmin /etc/rc2.d/S176webpadmin
    or
    cp /<xyz>/webplus/webpadmin /etc/rc.d/rc.webpadmin
You can also add the following code to rc.local
    #Start talentsoft Webplus server
    /webplus/webpadmin sart

Please consult your operating system's documentation for more details if you 
encounter any problems, or Webplus does not seem to be automatically starting.

4. Starting and stopping the Server
======================
You must start your service with the command:
    /webplus/webpadmin start
    or
    /etc/rc2.d/S176webpadmin start
    or
    /etc/rc.d/rc.webpadmin start

You can stop your webplus service with the command:
    /webplus/bin/webpadmin stop
    or
    /etc/rc2.d/S176webpadmin stop
    or
    /etc/rc.d/rc.webpadmin stop


Finally, you can point your browser to:
    http://your.domain.com/webplus/index.htm
and you are ready to go.

5. Install Database
Web+4.6 provides built-in support for MySQL, PostgresSQL, and Oracle 7  
(currently only available for Solaris 7.0 on Sparc systems). You can access other databases 
through ODBC.

To test database connectivity, run through the "Verify Install" section
of the startup page (http://your.domain.com/webplus/index.htm). If, for some 
reason the "Verify Install" fails, the scripts used to populate the webplus 
example database are located in the database directory, under the database you 
are using (mysql or potgresql) under the subdirectory example. The file is 
named webpdb.sql.  
Please read the HOWTO_DATABASE file for further instructions. 
