Deploying CentraSite Business UI Extension

Pre-requisites:

Before you deploy the CentraSite Business UI extension, make sure that you take a backup of the following files:

<CentraSiteInstall_Directory>\cast\cswebapps\BusinessUI\WEB-INF\web.xml

<CentraSiteInstall_Directory>\cast\cswebapps\BusinessUI\custom\conf\centrasite.xml

Note:
The <CentraSiteInstall_Directory> indicates the installation directory of CentraSite. For example: C:\SoftwareAG\CentraSite in Windows or /opt/softwareag/CentraSite in Linux.

Once the CentraSiteBUIExtension is compiled successfully, the BusinessUI extension has to be deployed.

To deploy CentraSite Business UI extension

1. Run the command ant deploy.

The command deploys the CentraSiteBUIExtension.

The syntax is of the format: C:\SoftwareAG\CentraSite\demos\CentraSiteBUIExtension>ant deploy

2. Open the web.xml file.

You can find the file in the folder <CentraSiteInstall_Directory>\cast\cswebapps\BusinessUI\WEB-INF\.

3. In the web.xml file, uncomment the following property lines:

<servlet>
<servlet-name>ExtensionServlet</servlet-name>
<servlet-class>com.softwareag.centrasite.bui.
extension.service.ExtensionServiceImpl</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>ExtensionServlet</servlet-name>
<url-pattern>/centrasitebuiextension/extensionService</url-pattern>
</servlet-mapping>

<servlet>
<servlet-name>ActionExecutionServlet</servlet-name>
<servlet-class>com.softwareag.centrasite.bui.
extension.core.service.action.ActionExecutorServiceImpl</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>ActionExecutionServlet</servlet-name>
<url-pattern>/centrasitebuiextension/action</url-pattern>
</servlet-mapping>

4. If the ActionExecutionServlet is not already available in the web.xml, add the following XML fragment below the entry ExtensionServlet:

<servlet>
<servlet-name>ActionExecutionServlet</servlet-name>
<servlet-class>com.softwareag.centrasite.bui.
extension.core.service.action.ActionExecutorServiceImpl</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>ActionExecutionServlet</servlet-name>
<url-pattern>/centrasitebuiextension/action</url-pattern>
</servlet-mapping>

5. Open the customization file, centrasite.xml, in a rich text editor.

You can find the centrasite.xml file on <CentraSiteInstall_Directory>\cast\cswebapps\BusinessUI\custom\conf.

6. Set the value of the attribute src to centrasitebuiextension/centrasitebuiextension.nocache.js.

src="centrasitebuiextension/centrasitebuiextension.nocache.js"

7. In the element <Extensions>, set the value of the attribute custom to true to enable an extension.

The element <Extensions> includes all the possible extensions in CentraSite Business UI.

8. To enable the custom actions that are available in the demos folder, uncomment the elements <Actions> and </Actions>.

If the custom action entries Action id="RunPolicyAction" and Action id="ChangeOwnerAction" are already available in the centrasite.xml file, then uncomment them.

If the custom action entries Action id="RunPolicyAction" and Action id="ChangeOwnerAction" are not available in the centrasite.xml file, then include the following property statements:

<Actions>

<Action id="RunPolicyAction" inbox="false" bulk="false"
group="basic"
icon='images/system/actionbar/execute_policy.png'
class="com.softwareag.centrasite.demos.bui.
actions.runpolicy.RunPolicyAction">Execute Policy
</Action>

<Action id="ChangeOwnerAction" inbox="false" bulk="true"
group="basic"
icon='images/system/actionbar/change_owner.png'
class="com.softwareag.centrasite.demos.bui.
actions.changeowner.ChangeOwnerAction">Change Owner
</Action>
</Actions>

9. Save and close the file.

10. Restart Software AG Runtime.