Installing the Relay Server Components to IIS 7.x on Windows

After installing Sybase Unwired Platform, install the relay server component files to Microsoft Internet Information Service (IIS) 7.0 or 7.5 on Windows 2008 or Windows 2008 R2.

Prerequisites
Make sure Microsoft IIS 7.0 or 7.5 is installed on Windows 2008 or Windows 2008 R2, with the Microsoft IIS ISAPI Extensions feature on your server. This feature is not installed by default.
Task
  1. From the Installation package, get the relevant Relay Server ZIP file:
    • for 32-bit operating systems, use relayserver.zip
    • for 64-bit operating systems, use relayserver_x64.zip

    The ZIP file contains the required executables and DLLs for the Relay Server.

  2. Extract the ZIP file under C:\Inetpub\wwwroot\ to create the folder structure:
    C:\inetpub\wwwroot\ias_relay_server 
    C:\inetpub\wwwroot\ias_relay_server\Server 
    C:\inetpub\wwwroot\ias_relay_server\Client 
  3. Verify that all the DLL files copied under these folders are of the required version, for example, 11.0.1.2527.
  4. Check the Relay Server logs to make sure the first line reflects the new version. For example, from C:\windows\System32\inetsrv\ias_relay_server_host.log.
    I. 2010-12-04 07:22:28. < 3160.- > iAnywhere Relay Server Version 11.0.1.2527 
    I. 2010-12-04 07:22:28. < 3160.- > 
    I. 2010-12-04 07:22:28. < 3160.- > Copyright © 2001-2009, iAnywhere Solutions, Inc. 
    I. 2010-12-04 07:22:28. < 3160.- > Portions copyright © 1988-2009, Sybase, Inc. All rights reserved. 
    I. 2010-12-04 07:22:28. < 3160.- > Use of this software is governed by the Sybase License Agreement. Refer to http://www.sybase.com/softwarelicenses 
    ...  
  5. Modify the System Path variable to refer to include C:\inetpub\wwwroot\ias_relay_server\Server.
  6. Back up %SystemDrive%\Windows\System32\inetsrv\config\applicationHost.config.
  7. Open applicationHost.config in an editor, and merge the following sections into their respective locations in the file, then save the changes (detailed info follows):
    1. To add an application pool for the Relay Server, edit the applicationHost.config file to add the following code to the <system.applicationHost> » <applicationPools> section:
            <add name="RelayServer" queueLength="65535" autoStart="true" managedRuntimeVersion=""                           managedPipelineMode="Integrated">
                <processModel identityType="LocalSystem" idleTimeout="00:00:00" maxProcesses="20" pingingEnabled="false"                       pingInterval="00:00:30" pingResponseTime="00:01:30" />
                <recycling disallowOverlappingRotation="true">
                    <periodicRestart time="00:00:00">
                        <schedule>
                            <clear />
                        </schedule>
                    </periodicRestart>
                </recycling>
                <failure rapidFailProtection="false" />
                <cpu resetInterval="00:00:00" />
            </add>       
      
    2. To add the Relay Server application to the default site, edit the applicationHost.config file to add the following code to the <system.applicationHost> » <applicationPools> » <sites> » <site name="Default Web Site"> section:
            <application path="/ias_relay_Server" applicationPool="RelayServer">
                <virtualDirectory path="/" physicalPath="c:\inetpub\wwwroot\ias_relay_server" />
            </application>
      
    3. To add the Relay Server ISAPI extensions, edit the applicationHost.config file to add the following code to the <system.webServer> » <security> » <isapiCgiRestriction> section.
            <add path="c:\inetpub\wwwroot\ias_relay_server\Client\rs_client.dll" allowed="true" />
            <add path="c:\inetpub\wwwroot\ias_relay_server\Server\rs_server.dll" allowed="true" />
      
    4. To add the Relay Server handlers, edit the applicationHost.config file to add the following code to the <configuration> section.
      	<location path="Default Web Site/ias_relay_server/client">
      		<system.webServer>
      			<handlers accessPolicy="Execute, Script">
      			</handlers>
      		</system.webServer>
      	</location>
      
      	<location path="Default Web Site/ias_relay_server/server">
      		<system.webServer>
      			<handlers accessPolicy="Execute, Script">
      			</handlers>
      		</system.webServer>
      	</location>
      
      	<location path="Default Web Site/ias_relay_server">
      		<system.webServer>
      			<security>
      				<authentication>
      					<anonymousAuthentication userName="" />
      				</authentication>
      				<requestFiltering>
      					<requestLimits maxAllowedContentLength="2147483647" />
      				</requestFiltering>
      			</security>
      		</system.webServer>
      	</location>
      
  8. Open a Web browser, and ensure http://localhost:80 loads the default page correctly.
    Note: The Relay Server is set up for anonymous access based on these instructions. Proper security needs to be configured for IIS and the Relay Server based on your business requirements.
  9. Create a Relay Server service, as described Configuring a Relay Server to Run as a Windows Service.
  10. Start the Relay Server service, for example:
    C:\inetpub\wwwroot\ias_relay_server\Server > dbsvc -u SUPRelayServer
  11. Check Relay Server and IIS logs for errors:
    • Relay Server logs:
      • C:\windows\System32\inetsrv\ias_relay_server_host.log.
      • Log specified in the service's -o switch, for example: C:\Sybase\logs\rs.log.
    • IIS logs:
      • C:\inetpub\logs\LogFiles\W3SVC1
      • C:\Windows\System32\LogFiles\HTTPERR