Ecrion Software Inc. Homepage
Forum Home Forum Home > XF Rendering Server > FAQ
  New Posts New Posts RSS Feed: Web Service installation and FAQ
  FAQ FAQ  Forum Search   Register Register  Login Login

Forum LockedWeb Service installation and FAQ

 Post Reply Post Reply
Message / View First Unread Post
radup View Drop Down
Admin Group
Admin Group

Joined: 19 May 2008
Posts: 90
Post Options Post Options   Quote radup Quote  Post ReplyReply Direct Link To This Post Topic: Web Service installation and FAQ
    Posted: 08 Sep 2011 at 11:40am
Ecrion’s Web Service FAQ 

The Web Service is our WSDL/SOAP interface “API”. For technical specifications of the SOAP API please see the end of this FAQ. 

If you installed the service using our setup, it will be accessible at: http://localhost/XFWS/ecrion/services/XFWS.asmx. Then the WSDL will be available at http://localhost/XFWS/ecrion/services/XFWS.asmx?WSDL and you will see the following screen at that location:

Here is the link to view the SOAP API code and parameters: 

Installation Issues 
Make sure you install the Web Service as the administrator: open a command prompt as an user with Administrative rights and run with a command line similar to the following:

msiexec.exe -i setup_name.msi  

Installation “interrupted” message with IIS7 
The web setup does not install on computers with IIS7 until the IIS6 compatibility layer is installed. 

Complete the following steps to install the IIS 6 compatibility layer: 
1.     Open Control Panel, and then open Programs and Features. 
2.     Click Turn Windows features on or off. 
3.     Expand Internet Information Services, expand Web Management Tools, and then expand "IIS 6 Management Compatibility". 
4.     Select "IIS Metabase and IIS 6 configuration compatibility". 
5.     Click OK. 

Here is an image for the compatibility settings: 

Other “Installation interrupted” or “Fatal Error Occurred” during installation suggestions 
This page might help you: 

In addition, make sure that the path you are installing to doesn't contain Unicode characters (like German for instance), because this might sometimes confuse installers. 

If that doesn’t help, here is the command line for msiexec which will create an installation log. Then, send that log to 

msiexec /i C:\XFWSSetup-6.5.0-3220.msi /l* c:\XFWSlogfile.txt

404 or 403 Errors: 
First, check that the ASP.NET extension is set to “allowed”

See MS KB articles for more info: 

Then, try creating a separate 2.0 .NET application pool: 
1.     uninstall UWS 
2.     configure a separate 2.0 .NET application pool 
3.     reinstall UWS in that app pool 

400 Errors: 

Parser Error 
If you see this type of parser error, it means that you are using .NET 1.1 and the Web Service requires .NET 2.0: 

Server Error in '/XFWS/ecrion/services' Application. 

Parser Error 
Description: An error occurred during the parsing of a resource required to service this request. Please review the following specific parse error details and modify your source file appropriately. 

Parser Error Message: Could not create type 'xfws'. 

Source Error: 

Line 1: <%@ WebService Language="C#" CodeBehind="~/App_Code/xfws.cs" Class="xfws" %> 

Source File: C:\inetpub\wwwroot\XFWS\ecrion\services\xfws.asmx    Line: 1 

Version Information: Microsoft .NET Framework Version:1.1.4322.2443; ASP.NET Version:1.1.4322.2470

Timeout errors 
Just increasing the timeout in IIS should work. This is something that IIS does (it will abort a web application/web page that is taking more time to respond) and is not under our control. 

“Error reading socket” or “Operation is not valid due to the current state of the object” error messages 
This can mean that the Web Service version you are using is out of sync with the Rendering Server, in which case you may need a new version from the website or support. If you have identical versions, check if an older version of Ecrion.Ultrascale.NET.dll is being picked up from somewhere, like the GAC (global assembly cache). 

Here is how to see if any Ecrion dlls are in your GAC: 
- Go to Control Panel\ Administrative Tools 
- Open Microsoft .NET Framework 2.0 Configuration 
- Expand My Computer\Assembly Cache 
- Remove any Ecrion*.dll you find there 

Further debugging 
Testing the Web Service functionality through the command line: 
Open a command prompt and try the following: 

cd C:\inetpub\wwwroot\XFWS\Samples\Bin 
(substitute c:\inetpub\wwwroot with your web site's root) WSRender http://localhost/XFWS/ecrion/services/xfws.asmx C:\inetpub\wwwroot\XFWS\Samples\HelloWorld.soap C:\Output.pdf

Miscellaneous Questions 
How do we use the Netlink Load Balancing Add-On with Web Services? 
Your Netlink instances can be configured by editing the web.config file: 

    <defaultXFServer address="" port="1099"/>
    <defaultRequestSettings retryFailedRequests="false" requestTimeout="0"/>
Uncomment the following xml and configure your XF Rendering Servers 
to be used by NetLink. 
      <server address="" port="1099"/>
      <server address="" port="1099"/>
    <defaultDASServer address="" port="50000"/>
    <defaultRequestSettings retryFailedRequests="false" requestTimeout="0"/>

Does the Web Service work with Tomcat? 
The Web Service was written for IIS. We do have a Web Service for Tomcat, written in Java.  Contact for more information.

Technical Specs 
The following technical standards are supported: 
WSDL 1.1 
WS-I Basic Profile 1.1 
SOAP 1.1 or higher 
SOAP binding style - Document literal 
SOAP Attachment - MTOM (; WS-I SwaRef can be implemented upon request (for example as an EJB that can be deployed for JBOSS). 
Security –HTTPS; WS-Security 1.0 ( is also a possibility. 
We can support concurrent web service requests. 

We can interface with a WebSphere Process Server.

Edited by radup - 31 Oct 2011 at 9:56am
Back to Top
 Post Reply Post Reply

Forum Jump Forum Permissions View Drop Down

Bulletin Board Software by Web Wiz Forums® version 9.69
Copyright ©2001-2010 Web Wiz

This page was generated in 0.078 seconds.