Configure IIS to Serve the LANSA Composer Web Components

LANSA Composer

Configure IIS to Serve the LANSA Composer Web Components

The LANSA Composer Windows server installation does not re-configure the LANSA for the Web IIS plug-in if it is already installed. This is deliberate, to avoid interfering with existing working LANSA for the Web applications, but it also means that you cannot immediately execute the LANSA Composer Web components (for example, the Operations Console) until you manually alter the IIS plug-in configuration.

There are several ways to do this. The following describes an example procedure to accomplish this.

You should refer to the applicable LANSA and IIS documentation for full details.  The example procedure shows one way to configure the IIS plug-in for this purpose.  The specific screens and the most appropriate configuration steps and values may differ on your system according to your circumstances and requirements.

 

The major steps in the example procedure are:

1.  In IIS, add a new site binding for LANSA Composer

2.  In the LANSA Web Administrator, add a data/application server for LANSA Composer

3.  Copy LANSA Composer's web images, styles and script files

4.  In LANSA Composer, alter System Settings to use the new port number

 

When you have finished, continue with:

Running the LANSA Composer Client on the Windows Server

 

1.  In IIS, add a new site binding for LANSA Composer

By default, the existing LANSA for the Web application is being served using the default port 80.

You can choose a new port number on which to serve the LANSA Composer Web components.  Usually you should use a port number greater than 1000 to avoid conflict with "well-known" port assignments used for other protocols such as FTP.

Once you have chosen the port number (for example, 8080), perform the following steps to configure the web site to serve that port:

a.  Open the Microsoft Internet Information Services (IIS) Manager and select the web site in which the LANSA for the Web IIS plug-in (lansaweb) is installed.

b.  Open the Site Bindings window for the selected web site and click Add to add a new binding.

c.  In the Add Site Binding window, type the new port number.

d.  Make sure you have saved all your changes.  There is no need to restart IIS services yet.

 

2.  In the LANSA Web Administrator, add a data/application server for LANSA Composer

Perform the following steps to configure LANSA for the Web to invoke LANSA Composer to serve web requests made using the new port number:

a.  Open the LANSA Web Administrator and open the active LANSA web configuration (for example, l4w3serv.cfg in the WebServer\IISPlugIn folder of the LANSA system directory in which the IIS plug-in is installed)

b.  Select Maintain Systems from the Tools menu and click Add.

c.  On the Web Server tab of the Add LANSA System window, type the specific port number determined above.

 

d.  On the Data/Application Server tab of the Add LANSA System window, type the name of the LANSA Communications Administrator entry for LANSA Composer.  Click the ellipsis (…) button to open the LANSA Communications Administrator if necessary.  Type the user and password details necessary for LANSA for the Web to connect to the LANSA Composer application server.

Note: the specified user profile need to be an authorized user in the SQL database (if using Microsoft SQL Server)

 

e.  Test the connection, save your changes and close the LANSA Web Administrator.

f.  Finally you should restart IIS now to cause the new configuration to take effect.

 

3.  Copy LANSA Composer's web images, styles and script files

The LANSA Composer Windows server installation program installed the web images, styles and script files for LANSA Composer in the WebServer\Images directories of the LANSA Composer installation location.

You will need to copy these files to the equivalent WebServer\Images directories of the LANSA system directory in which the IIS plug-in is installed.

The following files need to be copied:

  • Image files named xfd*.* in WebServer\Image  s
  • Cascading style sheet files (.css) named xfd*.css in WebServer\Images\style 
  • JavaScript files (.js) named xfd*.js in WebServer\Images\script 

 

4.  In LANSA Composer, alter System Settings to use the new port number

Once IIS and LANSA for the Web are configured, you need to change the base URL used by LANSA Composer for the Operations Console.

To do this, start the LANSA Composer client and select System Settings from the navigator on the left.  In the list of system settings, select Base URL for browser interface.  In the Value edit box on the right, change the URL to use the new port number that has been bound to the LANSA for the Web IIS plug-in.