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.