This is archived documentation for an older version of Nirvana (v6.1).

Please refer to documentation for the latest version if required.

Archive Documentation (v6.1):

Nirvana JavaScript: Server Configuration for HTTP Delivery

Nirvana can serve web content over both HTTP and HTTPS communication modes. This section discusses the steps necessary to configure a realm server to deliver web content over HTTP.

Creating a Nirvana HTTP (nhp) Interface

Nirvana provides its own protocol, the Nirvana HTTP Protocol (nhp) for the delivery of web content over HTTP. For web communication to take place an interface using this protocol must be created. Creating an interface can be done through the enterprise manager.

Serving Content through File Plugins

A Nirvana nhps interface delivers content to connected browsers through file plugins. Generally at least two file plugins will need to be configured to serve a page using the Nirvana JavaScript API. The first will be a pointer to the Nirvana JavaScript client libraries. The second will be a plugin pointing to the base directory of the web pages which use these libraries.

The Nirvana JavaScript client libraries are located in /lib/javascript in the nirvana base installation directory. To use these libraries in any content served from an interface a file plugin with a BasePath which points to this directory is necessary. The URL Path of the file plugin may be anything you wish, though it must be referenced the same in the include in your javascript code. For example, if you set the URL Path to /lib then the following code must be included in your pages:

        <script language="JavaScript" src="/lib/nirvana.js"></script>

The file plugin which points to your web content is configured in a similar way. The BasePath should point to the fully qualified path of your web directory. The URL Path is the resource location relative to your address. For example, serving content from the root of the website can be done by setting a URL Path of /

JavaScript Interface Properties

The behaviour of nhp interfaces when serving web content can be changed through the enterprise manager. These settings can be changed by editing configuration properties available in the JavaScript panel accessed through the interface tab.

Comet Configuration Properties

The Nirvana enterprise manager also provides realm wide configuration settings for Comet. These are available in the enterprise manager from the Comet Config panel.