IBM Support

Creating an unsecured custom search application in IBM Content Analytics (ICA)

Troubleshooting


Problem

The following instructions create a new customized, unsecured search application within an all-in-one ICA 3.0 for the embedded Jetty on a Windows environment. The custom application also only accesses specified collections. In this example, the new search application context root desired is http://:8393/sysadmin

Resolving The Problem

1. Find directory C:\Program Files\IBM\es\esadmin\master_config\searchapp create a copy of “search” folder and rename to “sysadmin”

2. Open C:\Program Files\IBM\es\esadmin\master_config\searchapp\sysadmin\ config.properties


    a. Set the value of the ignoreMasterConfig property to true (ignoreMasterConfig=true)

    b. Change the value of the applicationName parameter to the application ID that you will create or sysadmin (applicationName=sysadmin)

    c. Save and exit file.


3. Find file C:\Program Files\IBM\es\esadmin\master_config\searchapp\jetty-deployment.xml and add the below code between <Ref id="Contexts"> … </Ref> then save and exit.

    <!-- Deploy sysadminapp -->
    <Call name="addHandler">
    <Arg>
    <New class="org.mortbay.jetty.webapp.WebAppContext">
    <Set name="contextPath">/sysadmin</Set>
    <Set name="war"><SystemProperty name="jetty.home" default="."/>/searchapp/sysadmin</Set>
    <Set name="extractWAR">false</Set>
    <Set name="copyWebDir">false</Set>
    <Set name="defaultsDescriptor"><SystemProperty name="jetty.home" default="."/>/webdefault.xml</Set>
    </New>
    </Arg>
    </Call>

4. Find directory C:\Program Files\IBM\es\webapps\searchapp create a copy of “search” folder and rename to “sysadmin”

5. Open C:\Program Files\IBM\es\webapps\searchapp\sysadmin\WEB-INF\config.properties


    a. Set the value of the ignoreMasterConfig property to true (ignoreMasterConfig=true)

    b. Change the value of the applicationName parameter to the application ID that you will create or sysadmin (applicationName=sysadmin)

    c. Save and exit file.


6. Run esadmin system restart

7. Next specify which collections can be accessed by the application. Follow the instructions for associating applications with collections . Set the Application ID the same as the applicationName: sysadmin

8. Run esadmin system restart

9. Note: Changes to UI displayed name can be made under C:\Program Files\IBM\es\webapps\searchapp\sysadmin\WEB-INF\config.properties property displayedApplicationName (displayedApplicationName=Custom Name Here)



    a. Changes require esadmin searchapp.node1 restart

[{"Product":{"code":"SS5RWK","label":"Content Analytics with Enterprise Search"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"--","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.0","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
17 June 2018

UID

swg21977988

Page Feedback