Task: create-virtual-portal

Portal ConfigEngine task that creates a new virtual portal.

Use the create-virtual-portal task to create a new virtual portal. This task creates the virtual portal itself, but it does not create any default content for the virtual portal or grant any access permissions to the virtual portal administrators. Run these tasks separately after creating the virtual portal. configuration interface create content and grant access permissions.

Parameters

VirtualPortalTitle	The title of the virtual portal. This option is required.
VirtualPortalRealm	The realm of the virtual portal. This input is required if we have realms enabled in our portal installation. If we do not have realms enabled, do not specify a value for the realm.
Virtual portal context or host name	We can address virtual portals using either a portal context or a virtual host name. If we specify a host name, the context is ignored: VirtualPortalContext The portal context of the virtual portal. The context must be unique. If we set the host name parameter described later, the VirtualPortalContext parameter is ignored. Either the host name or the context option is required. VirtualPortalHostName The host name of the virtual portal. If we specify the host name, the portal uses the host name, and the VirtualPortalContext parameter is ignored. We cannot use the same virtual portal host name twice in the same portal installation. After creating the virtual portal, we cannot change the host name specified for the virtual portal. Either the host name or the context option is required.
VirtualPortalObjectId	The Object ID is used to reference the virtual portal. If VirtualPortalObjectId is not specified, a new VirtualPortalID is generated.
VirtualPortalNlsFile	The national language support (NLS) file for the virtual portal. Provide the path and file name of the national language support file. This input is optional. We can create the own national language support file to specify more titles and descriptions in other languages for the virtual portal. If we specify an NLS file, the value given for the virtual portal title in that NLS file overrides the title specified by the VirtualPortalTitle input parameter. If we specify an NLS file, do not use prefixes in that NLS file. If we do not specify an NLS file, the virtual portal is created with the title that you give as the value to the VirtualPortalTitle input parameter only. But the virtual portal is created without titles in other languages and without descriptions. If we specify no NLS file, the value specified by the VirtualPortalTitle input parameter shows to users as the title of the virtual portal in all language environments. This action is independent of the system and browser locale and the user preferences. To pass a description for the virtual portal to the configuration task, specify this action in the NLS file.

Syntax

We can specify the parameter and value preceded by -D on the command line or define them in the file wkplc.properties. The property file must be encoded in the ISO 8859-1 character encoding format.

cd c:/IBM/WebSphere/wp_profile/ConfigEngine
./ConfigEngine.bat create-virtual-portal \
                 -DWasPassword=password \
                 -DPortalAdminPwd=password \
                 -DVirtualPortalTitle=MyVP \
                 -DVirtualPortalContext=myvp

Parent Portal ConfigEngine tasks for administering virtual portals

Related concepts:

Virtual portal roles and their capabilities
xmlaccess.sh
Language support
Command reference for the Portal Scripting Interface
Technotes for virtual portals