How to add a portal page

WAS THIS PAGE HELPFUL? Leave Feedback

Overview

Custom portal pages can be added to the GroundWork portal. Portal page administration is managed by a Portal Administrator (e.g., root/root) and is accessed from the toolbar options Group and Site Editor.

A Portal (e.g., GroundWork Monitor) contains Pages (e.g., Dashboards, Status, Event Console, custom pages) which contain various Portlets (e.g., Status: Host Health, Host Information). The GroundWork Monitor portal is built using Red Hat JBoss Portal Platform 6 which means that you can build additional web pages to customize and extend the portal and manage user access control.

Also, see Developing Custom Portlets, a quick developer guide to developing custom portlets with Java and JavaScript.

Steps

In the example below, we create a new top level portal page with an IFrame Web portlet.

1. Log in to GroundWork Monitor as a Portal Administrator (e.g., root/root).
2. Hover over Site Editor on the toolbar and select Add New Page.
3. At the top of the screen, the Selected Page Node reads the location a new portal page will be created, if you want it at a different level (e.g., top level), click the green arrow on the left to go to the new (e.g., /default) position.
4. Enter a Node Name (no spaces) and a Display Name (this will be displayed in the menu, spaces are permitted), click Next.
5. Select Empty Layout, click Next.
6. Select the Containers tab, and drag the One Row option over to the left panel.
7. Select the Applications tab, scroll down and select the Web category, and drag the IFrame portlet into the row container.
8. Next, to edit the portlet URL setting in the portlet, mouse over the IFrame Portlet title and select the pencil icon. Replace the existing URL with one of your choice, this could also be a link to a Grafana dashboard. In this example we use a Vi cheat sheet reference (e.g., http://www.lagmonster.org/docs/vi.html). Click Save.
   
   Figure: IFrame portlet URL
   
   
   
9. We also increase the size of the page, select the second tab Portlet Setting and enter a Portlet Title (e.g., Vi Cheat Sheet), a Height of 800px, click Show Info Bar, uncheck Show Portlet Mode, and Show Window State. Optionally, go through the other tabs to select an icon, theme, and set access permissions for this portlet.
10. Click Save and Close, and in the upper right corner select the Save icon and your new page should be displayed.
    
    Figure: New portal page