Other Application Servers

This option allows the deployment of a portlet in the JSR-168 standard, so that it can be used as a portal service.

The deployment is an installation of a file.war that may contain one or more portlets. The deployment of a file.war corresponds to the registration of only one service in the portal, which may have as many interfaces as there are portlets contained in the file.war. The registered service will be located in a directory in “lumisdata/def” and will be ready to be instantiated.

The following steps must be followed to perform the “Deploy”

1. Deployment Type: In this field, you can specify if it will be a "New service" or "Update existing service"
   • a) "New service" should be chosen when deploying a portlet for the first time
   • b) "Update existing service" is used when the portlet or portlets have been changed, therefore it is necessary to perform a new deployment of the file with the war extension.
   In the example, the option "New service" was chosen;
2. Deployment file: In this field specify the portlet service file. Ex:calcportlet.war;

   

3. Context path: you must specify what the context path of the application server where the portlet will be installed is. Ex: “/calcportlet”;

   

4. Service identifier: you must specify the service identifier, which must follow a directory hierarchy pattern, separated by (.). In this example, the hierarchy is: “portlet.lumis.calc”.
5. Export: exports a zip file of the deployment file to “/lumisdata/deployment”

If this directory does not exist, it will be created during the first portlet export

The zip file contains the war file modified by Lumis and the servicedefinition.xml so that the portlet can be registered as a service.

Therefore, after the export, the zip file must be unzipped and the portlet must be registered manually in the portal, through its servicedefinition.xml, located in "lumisdata/deployment/lumisdata/def/portlet/lumis”. To register, consult the Service Manager section.

Additionally, the unzipped war file must be effectively deployed on the application server. This unzipped war file is different from that indicated in the Deployment file field, and in its execution, it is necessary to share the shared lib of the portal.

The following figures display respectively the service instance “Calculator”, which is the result of a deployment of the portlet calcportlet; and a page with the rendered interface. The name of the service and its description were changed in “lumidata/def/portlet/lumis/calc/servicedefinition.xml".

The title bar of the interface above the calculator can be configured to be displayed or not. This configuration is done through the option “Display Title Bar”, in the properties of the interface, accessed from a right-click on it. By default, this property has a value of “no”.