Delete a virtual portal
We can delete a virtual portal using the Virtual Portal Manager portlet.
We cannot delete the initial portal installation. After the virtual portal resource is deleted, the scoped resources of that particular virtual portal are deleted later by a scheduled cleanup service. The URL mapping created when the virtual portal was created is also deleted. The following resources are not deleted:
- The unscoped resources that were available in the virtual portal; they belong to the initial portal installation and are therefore not deleted.
- Extra URL mappings which administrators might have created manually are not deleted.
If we delete a virtual portal and to create a new virtual portal immediately after the deletion using the same URL context, we do not have to wait for the scheduled cleanup service. Run the cleanup task for deleting resources by running the XML script Task.xml of xmlaccess.sh. Then, we can create the new virtual portal. For details, see Work with the XML configuration interface.
Prepare the deletion of virtual portals
Virtual portals can be created in environments where multiple portal installations share database domains, such as Community or Customization. This environment can be in a staging environment or for different lines of production. In this case some portal resources, such as page customization within a virtual portal, can be visible in several of these installations. If we delete a virtual portal, then this portal installation cannot determine whether the corresponding resources can be deleted or if they are still valid in the context of other portal installations and must be preserved. It is the responsibility of the portal administrator to decide whether clean-up of related resources in shareable database domains is required before a virtual portal is deleted. The administrator must decide whether these resources are obsolete or still in use. We can complete the cleanup in two ways:
- Manual cleanup of virtual portal resources in shared database domains. To clean up manually:
- Connect to the virtual portal that to delete.
- Clean up the two database domains Community and Customization. Run the XML configuration scripts DeleteSharedCommunityContent.xml and DeleteSharedCustomizationContent.xml.
- Delete the virtual portal.
- Automated cleanup of virtual portal resources in shared database domains. Run the configuration task delete-virtual-portal and specify either the URL context or the host name of the virtual portal that to delete. Example syntax for both options:
- For IBM i:
ConfigEngine.sh delete-virtual-portal -DremoveResourcesInSharedDomains=true -DVirtualPortalContext=URL_context_of_the_VP
- For Linux:
ConfigEngine.sh delete-virtual-portal -DremoveResourcesInSharedDomains=true -DVirtualPortalContext=URL_context_of_the_VP
- For Windows:
ConfigEngine.bat delete-virtual-portal -DremoveResourcesInSharedDomains=true -DVirtualPortalContext=URL_context_of_the_VP
For a list of database domains that can be shared, read the topic about Shared database domains and sharing database domains for our environment.
Cleaning up remaining resources if a virtual portal has been deleted already
If a virtual portal was deleted already without prior cleanup of resources in shareable database domains, and if these resources cannot be accessed by any other portal installation that shares the database domains...to remove the remaining resources:
- Run the cleanup task for deleting resources by running the XML script Task.xml of xmlaccess.sh.
- Re-create the virtual portal that was deleted using the identical URL mapping.
- Follow the instructions to delete a virtual portal, including cleanup of resources in shareable database domains. This cleanup was described in the preceding section about Preparing for the deletion of virtual portals.
Parent Tasks for administering virtual portalsRelated reference:
Task: delete-virtual-portal
Related information
Technotes for virtual portals
Work with xmlaccess.sh
See alsoSample XML scripts