Independent software vendors have a number of special needs when installing WSO2 SOA Enablement Server in their products. These include needing to install WSO2 SOA Enablement Server without user input, special concerns when porting WSO2 SOA Enablement Server to a server or embedding it in an application, and management issues, including the need to customize the Administration Console.
This book addresses these needs in particular. There is also much useful information in the rest of the documentation. An ISV Reader's Guide to the documentation follows:
For installing WSO2 SOA Enablement Server without user interaction:
Please read Quiet Installation. It describes how to preset installation parameters using Installation Options.
For porting WSO2 SOA Enablement Server into a remote HTTP engine:
Porting WSO2 SOA Enablement Server for ISVs gives a high-level overview. For instructions, start with Porting WSO2 SOA Enablement Server Overview. This includes a table of servlet engines and links to the porting instructions in Guides for Application Servers. It may also be useful to read Built-In Transports, particularly the sections on servlet transport and JMS transport.
For embedding the WSO2 SOA Enablement Server HTTP engine inside a customer's application:
Porting WSO2 SOA Enablement Server for ISVs gives a high-level overview. Also see Embedding.
For deploying a Web service with WSO2 SOA Enablement Server ported to a remote engine:
The Deployment Scenarios chapter in this book provides an overview. A practical introduction to the subject is provided in Jumpstart. This is all you need for most use-cases. The concepts behind publishing and deployment, such as service instances and endpoints, and the lifecycle of a Web service are explained in WS Components and Lifecycle. Advanced issues in persistent deployment are covered in Using Persistent Deployment. Tools are discussed in Deployment Tools Introduction. Specific tools of interest are WaspPackager, Deploy Tool and Undeploy. The Administration Console GUI for using these tools is described in Package Management.
For runtime publishing of a Web service with WSO2 SOA Enablement Server embedded inside a customer's application:
Deployment Scenarios for Embedded or Ported WSO2 SOA Enablement Server provides an overview. For how-tos, begin with Overview. This is sufficient for most use cases. The concepts behind runtime publishing and persistent deployment, such as service instances and endpoints, and the lifecycle of a Web service are explained in WS Components and Lifecycle. Advanced scenarios in Runtime Publishing are covered in Runtime Publishing.
For web-service management issues:
Read both Integration of WSO2 SOA Enablement Server Management and Modifying the Administration Console, and then relevant sections of the Administrator's Guide.
For plugging in a custom transport protocol:
See Custom Transports.
Additional high-level discussion of these issues:
This is provided in WSO2 SOA Enablement Server Remoting.