View Source

h1. Background

Some users do not want to use some of the provided applications and would like to remove them from being visible in the UI

h1. Procedure

For this document we will use Cacti as the example application to disable from the UI.

# First you will need to login as the portal administrator. The default user is {{root}} but if you changed this, you will need to use the updated user account.
!01-login.jpg|thumbnail!
# Go to {{Portal Navigation}}
!02-portal-navigation.jpg|thumbnail!
# Select {{Edit Navigation}}.
!03-edit-navigation.jpg|thumbnail!
# Scroll down to Advanced and expand the {{+}} symbol. Then Right click the {{Network Graphing}} item and select {{Delete Node}}
!04-delete-node.jpg|thumbnail!
# Do the same for the {{Network Map}} which is also part of Cacti.
# Now we want to replace the Cacti portlet as the default on the Advanced tab. Right click the {{Advanced tab}} and select {{Edit Node's Page}}
!05-edit-davanced-tab.jpg|thumbnail!
# Hover over the Cacti portlet placeholder and click the red {{X}} and confirm the deletion.
!06-delete-cacti-portlet.jpg|thumbnail!
# Now use the {{Page Editor}} to drag the {{NMS Nedi}} portlet from the Groundwork Portlets to the empty page template.
!07-add-nedi-as-deault-portlet.jpg|thumbnail!
# Add permissions so that the new portlet is visible when users click on Advanced. The default is {{Groundwork Administrators}} and {{\*}}.
!08-add-gwadmin-priv.jpg|thumbnail!
# Click the save button symbol on the top of the {{Page Editor}}.
!09-save-advnaced-tab.jpg|thumbnail!
# Click {{Save}} at the bottom of the {{Portal Navigation}} dialog.
!10-save-navigation.jpg|thumbnail!
# Open the {{User and Group Management}} window.
!11-user-group-mgmt.jpg|thumbnail!
# Select {{Membership Management}} and then the edit button symbol next to a Membership that has access to Cacti. Uncheck the box next to {{Cacti}} and then save.
!12-remove-cacti-perms.jpg|thumbnail!
# This should be repeated for each Membership that has the box for Cacti checked.
# You can now log in as a user other than {{root}} and navigate to the Advanced tab. You should no longer see the pages for {{Network Graphing}} and {{Network Map}}. Also the default portlet for Advanced should now be Nedi.
!13-confirm-cacti-removed.jpg|thumbnail!
# Since we are no longer using the cacti application, it makes sense to also disable related processes like the cronjob and feeder:
{noformat:title=run as root|titleBGColor=#DDDDDD}
crontab -l -u nagios | sed -e '/cacti/s/^/#/' | crontab -u nagios -
touch /usr/local/groundwork/core/services/feeder-cacti/down
/usr/local/groundwork/common/bin/svc -d /usr/local/groundwork/core/services/feeder-cacti/
mv /usr/local/groundwork/config/cacti.properties{,.disabled}
{noformat}
# As a final step you can block apache from proxying requests to these URI's by adding a Location block to the httpd.conf:
{noformat:title=/usr/local/groundwork/apache2/conf/httpd.conf|titleBGColor=#DDDDDD}
<Location */nms-cacti/*>
Order deny,allow
deny from all
</Location>
{noformat}
This will require a restart of apache to take affect.
{noformat:title=run as root|titleBGColor=#DDDDDD}
service groundwork restart apache
{noformat}