WAR Management Portlet

From Gcube Wiki
Jump to: navigation, search

This is the user guide to WAR Management Portlet, if you are looking for the Development Guide please look a this page.

The WAR Management Portlet lets users import and manage Web Applications in the infrastructure. In order to deploy or manage a deployed web application please refer to the Web Application Management Portlet guide.

The War Management Portlet

Through the WMP portlet you can:

  • Import a new Web Application
  • Update an existing Web Application
  • Remove an existing Web Application

War import

The Web Application form

A new Web Application can be imported into the infrastructure using the War Import Wizard.

  1. Click on the Upload War button on the bottom right corner of the portlet, an import wizard window will be open
  2. Select the source (in the current version only local desktop is allowed)
  3. Select the war file to import and click upload.
  4. After the upload all information about the application need to be filled:
    • Category name and description, both are mandatory. The category allow the user to group its web applications.
    • Application name, mandatory, and description.
    • Version, mandatory, composed by three positive and integer numbers.
    • Entry points: the entry points the your application. The root is added automatically by the hosting service.
  5. Finally the war import start and a bar will show the current progress.

The import and the web application publication are asynchronous procedures, therefore the web application will not appear immediately into the web applications list. In this case the user should refresh the list few seconds later.

Both Category name and Application name are alphanumeric string without spaces or special symbols.

Web application update

At any time the user can update its web applications:

  1. Right-click in the application list on the web application to update.
  2. Select Update.
  3. Select the new war file and click on the upload button.
  4. Update the application information or keep the current one.
  5. The application will be updated.

Web application removal

The user should right-click on the web application to remove and select remove. The portlet will ask to confirm the action and then will delete the application.

The remotion and the web application un-publication are asynchronous procedures, therefore the web application will not disappear immediately from the web applications list. In this case the user should refresh the list few seconds later.