SCOx-WSS 1.0
Web Services Substrate
May 1, 2004
############ RELEASE NOTES ############
Contents:
* CD Contents
* Installation
* Special Handling
* Known Issues
* Licensing
* Product Details
* Support
#######################################
CD Contents
This CD contains Web Services development and support tools:
* SCOx-WSS Support Site 1.0
- a web site containing help, references, tutorials and examples
* Ericom PT Host Pub 5.1
- enabling host applications to be used as Web services.
* WebFace Browser Application Engine 4.2
- a platform for delivering rich browser based applications.
* WebFace Studio
- the development environment for building WebFace applications.
* SQLe SQL Encapsulator 1.0 Beta
- a relational database to Web service generation tool.
* WAM Web Application Manager 1.0
- a Web based admin tool to assist in deploying Web applications.
* WSSProxy Web Services Substrate proxy 1.0
- a Web services support utility for proxying remote domain services.
* WSSDatacache Web Services Substrate data cache 1.0
- a Web services support utility for supporting Web based data applications.
More details on these products can be found in the Product Details section below
or
by browsing to /[your cd]/www/index.html prior to installation
or
by browsing to http://[your server or IP]/scox/ after installation.
NOTE: the above mentioned site works only in IE or Mozilla
#######################################
Installation
NOTE: You must have installed the SCOx-ENB packages
prior to installing WSS. These packages are included
on this CD for your convenience. They include Apache,
Jakarta Tomcat, PHP, Perl as well as other Web enablement
software. Install them by running the following command:
Insert and mount your CD
Place the WSS CD in your primary CD drive and run
the following commands:
mount /dev/cdrom/cdrom1 /mnt
sh /mnt/scox/install
NOTE: If you are running your server as a DHCP client and
your intranet is NOT running a dynamic DNS server you will
need to modify your /etc/hosts file to fool the MySQL
installation into thinking your server has a fully qualified
domain name. To do this run the script:
sh /mnt/scox/dhcpAddHostName.sh
After which the above install script will run through to
completion.
--------------------------------------
1) If your WSS CD is not already mounted then insert
and mount your CD by placing the WSS CD in your
primary CD drive and run the following command:
mount /dev/cdrom/cdrom1 /mnt
2) sh /mnt/install
3) hit Enter for each SSL certificate prompt.
(this accepts the defaults - you may of course
provide your true information during these
prompts)
4) hit the "delete" key anytime to abort installation
NOTE: The error "unable to write 'random state'" in the file
/var/sadm/install/logs/wss-scox.err is expected and cannot
be avoided.
NOTE: If you are running your server as a DHCP client and
you reboot your server after WSS installation - you may
get a new IP address. See the known issues below for instructions
in configuring your server under these conditions.
--------------------------------------
Once you've installed the WSS software please review
the readmeafter file located at the root of this CD or
the Post Installation document found on the WSS site either
on this CD at /www/ or on your server found at
http://[your server or IP]/scox/
#######################################
Special Handling
During installation you will be prompted to provide information used
to build an SSL certification key. This information is used exclusively
for securing Web communication originating from or directed to the
installed server. If desired you may accept the default information
for this SSL certificate by hitting Enter for each prompt. This SSL key
is then added to your Apache installation.
#######################################
Known Issues
SCOx-ENB incompatibilities
The SCOx-ENB packages javasoap and gsoap are incompatible with SCOx-WSS.
If you have installed these packages (they are part of the default
install for SCOx-ENB) the WSS installation will remove specific jar
files found in /opt/java2-1.4.2/jre/lib/ext/ which conflict with
most Tomcat applications.
Mozilla version
As of spring of 2004 Mozilla 1.4 is the minimum version which provides
enough basic functionality to support WebFace applications.
Unfortunately the latest UnixWare version of Mozilla available is 1.2.1.
Some WebFace applications may not work as expected using this
version of Mozilla.
A new version of Mozilla (1.6) should be available by summer 2004.
Please check our support Web site:
http://www.sco.com/scox/support/
for the lastest versions of Mozilla as well as the latest versions
of SCOx-WSS products.
IP Changes
If your server uses DHCP and/or you need to change the IP address of
the server you will need to update the /usr/lib/apache/conf/scox.conf
file to reflect the new IP addresses. OR you can run the WAM configuration
tool (from https://localhost/scox/webservices/SSL/wam/...) which
will query your server for the new IP and host name.
#######################################
Licensing
SCOx Web Services Substrate licensing configurations
The SCOx Web Services Substrate is available in a variety of configurations
to match the needs of any deployment. The configurations vary in capability
according to the following parameters:
Local Host only - the PowerTerm Host Publisher component will capture
the output of only those applications running on the same server as
the PowerTerm server.
Allow Remote Hosts - the PowerTerm Host Publisher component can be
configured to capture the output of applications running
on remote hosts of all types.
Restricted Emulations - the PowerTerm Host Publisher component supports
only three terminal types: SCO-ANSI, VT100, and Wyse60.
All Emulations - the PowerTerm Host Publisher component supports a long
list of terminals, including VT52 through VT525, BBS-ANSI, AT386,
Wyse 50/60, Televideo TVI 925/950/955, AIXterm, IBM 3270,
Data General D-412, Tandem 6530, HP 700/92 and others.
The following configurations, from least to most capable, are available:
1. Local Host Only, Restricted Emulations, up to 5 users - FREE.
2. Local Host Only, Restricted Emulations - 10 to 1000 sessions.
3. Allow Remote Hosts, Restricted Emulations - 10 or 25 sessions.
4. Allow Remote Hosts, All Emulations - 25 session special edition.
5. Allow Remote Hosts, All Emulations - 50 to 1000 sessions
Licensing for WebFace and SQL Encapsulator is limited to the number of
sessions on the Certificate of License and Authenticity, but is not
limited to Local Host in any configuration.
All configurations of the SCOx Web Services Substrate must be registered
at http://www.sco.com/registration in order to receive activation keys
that enable the capablilities purchased.
SCO Update for the Web Services Substrate
With the initial purchase of the product, customers are entitled to
three months of access to the SCO Update maintenance site. Additional
months of access can be purchased at the rate of 12% of list price for
the software covered. Registration at http://www.sco.com/registration
is required.
All configurations are available from your SCO Authorised Reseller.
#######################################
Product Details
* SCOx-WSS Support Site 1.0
* Ericom PT Host Pub 5.1
WSS Ericom PowerTerm Host Publisher enables a developer to use a
Microsoft Windows-based visual development tool to quickly define
what data in a console- based application should be exposed as one
or more Web Services. Then, it provides a Java application that makes
the Web Service available so applications may access it. Now data in
the console-based application may be accessed via the standard Web
Service just created, and data may be updated through the Web Service
back to the console-based application.
* WebFace Browser Application Engine 4.2
Requires no java applet or a plug-in of any kind.
Simple XML syntax makes creating user interfaces easy.
Effortless communication with any backend server including Java servlets,
SOAP services, ASP pages, JSP pages, PHP pages, Perl pages, etc.
Allows for complete customization through the use of JavaScript code,
embedded HTML and event handlers.
* WebFace Studio 4.2
SCO WebFace is a next generation Web application development environment,
allowing customers to easily create and deploy applications in a browser
without the need of installed plug-ins or Java. WebFace enables developers
to migrate existing applications onto the Web, regardless of operating system
or back-end technology.
In addition, WebFace greatly enhances the end-user experience for Service-Oriented
Architectures and seamlessly integrates with any Web Services platform, like J2EE,
WebSphere, WebLogic or .Net.
SCO WebFace, consisting of the WebFace Browser Application Platform and WebFace
Studio, is built on industry Web standards and supports the SCOx strategy of
extending the functionality of applications on the Web—allowing partners and
developers to re-purpose existing applications and integrate with future
applications. WebFace serves as a key element within the SCOx Web Services
Substrate - an application framework that benefits organizations by providing
legacy to web migration and web services capabilities, enabling the creation of
a Service-Oriented environment.
* SQLe SQL Encapsulator 1.0 beta
WSS SQL Encapsulator enables a developer to expose any data contained within a
SQL database as one or more Web Services with little or no coding. As a result,
access to databases does not happen at a low level but instead via a Web Services
layer, turning data access into intelligent, re-usable building blocks that can
be consistently managed and secured.
This release of this product includes a next generation interface supporting the
following features: insert, update, delete, custom services, stored procedure custom
services, security infrastructure, project storage, service description,
round-tripping, deployment packaging and integrated service testing.
* WAM Web Application Manager 1.0
WAM helps manage the deployment of web applications, including Web Services
applications, on SCO UNIX today. Specifically, it provides a web interface
for viewing what web applications have been deployed in the Apache Tomcat
application server on SCO UNIX and manages the deployment of that application
from Tomcat to the Apache Web Server. The web management interface also enables
the uploading of a new web application to the SCO UNIX machine as well provides
options to specify whether or not SSL security should be required for accessing
the web application.
* WSSProxy Web Services Substrate proxy 1.0
WSS Proxy allows third party SOAP calls to be made without a security warning
(IE) or security violation (Mozilla)
* WSSDatacache Web Services Substrate data cache 1.0
WSS DataCache provides persistent data store for a WebFace application when
cookies are not an option.
* Microsoft Windows Software
WSS also includes runtime design software for creating Ericom applications
as well as WebFace applications. These Windows installation files can
be found on this CD or you can download them from your server.
They are located under "Application Files" found by browsing to:
http://[your server or IP]/scox/
and then choosing either Ericom PT Host Pub
or
WebFace
from the navigation area to the left of the web page.
#######################################
Support
http://www.sco.com/scox/support/
and
http://www.sco.com/scox/support/forum/
are your first choice destinations for information regarding SCOx-WSS
products. In addition you will find excellent help, tutorials and examples
on this CD. Browse to www/index.html to view product documentation and help.
For more information, please contact your local SCO sales representative,
or: in the Americas, phone 1-800-SCO-UNIX (1-800-726-8649) or 1-831-427-6722
in the rest of the world, phone +353 (0) 1 260 6333
#######################################
Thanks for installing SCOx-WSS Web Services Substrate,
The SCOx Engineering Team.
s