Skip to main content

Software  >  Information Management  >  Enterprise Content Management  >  

Known problem: Creating the server profile for eDiscovery Manager in a non-default directory causes problems

 News
 
Abstract
If you create the server profile for IBM InfoSphere eDiscovery Manager in a directory other than the default directory (WAS_HOME\profiles), eDiscovery Manager is successfully installed but deployment problems can occur, which differ depending on the type of your application server environment.
 
Content
In WebSphere Application Server Base environments, a timeout error occurs during the deployment of eDiscovery Manager. An example of a timeout error is:

    com.ibm.websphere.management.exception.ConnectorException

      [wsadmin] org.apache.soap.SOAPException: [SOAPException:

    faultCode=SOAP-ENV:Client; msg=Read timed out;

    targetException=java.net.SocketTimeoutException: Read timed out]


In WebSphere Application Server Network Deployment environments, you receive an error that the eDiscovery Manager Web client or work manager could not be deployed. If you follow the instructions to search the eDiscovery Manager installation log file, you find a log file entry like this:

    INSTALL_APPS_STDERR=The system cannot find the path specified.

To resolve these deployment problems:
  1. Manually undeploy eDiscovery Manager. (WebSphere Application Server Base environments only)
  2. Prevent timeouts from occurring during deployment.
  3. Manually deploy eDiscovery Manager.

Manually undeploy eDiscovery Manager

(This procedure is relevant only in WebSphere Application Server Base environments. It is necessary because a timeout can occur at one of several times during deployment; no way exists to determine at which point the deployment failed.)

To manually undeploy eDiscovery Manager:

1. Use the WebSphere Administrative Console to manually remove any eDiscovery Manager objects.


    Servers

      In Application servers > eDM_app_server > Process definition > Environment Entries:
      • LIBPATH (C:/IBM/eDM/lib)
      • PATH (C:/IBM/eDM/lib)
    Applications
      • EDMClient
      • EDMWorkMgrServer
    Async beans work managers
      • EDMClientWorkManager
      • EDMServerWorkManager
      • EDMWorkItemManager
    Mail, Mail Session
      • EDMMailSession
    Shared libraries
      • EDMLibraries
      • EDMWorkMgrLibrary
      • EDMClientLibrary
    JVM Properties
      • heap size=254, max heap size=1 GB
      • classpath, for example, on Windows:
        C:/IBM/eDM/config/resources;C:/IBM/eDM/config;C:/Program Files/IBM/db2cmv8/cmgmt
      • In the Generic JVM arguments:

        -DedmBinDir=C:/IBM/eDM/bin/

      • An additional parameter in the Generic JVM argument:

        -Djava.security.auth.login.config=eDM_HOME\config\
        jaas.conf.WebSphere

2. If necessary, manually remove eDiscovery Manager from the WebSphere Application Server by entering one of the following commands:

    AIX

      eDMAppConfig.sh uninstall-all [WAS_admin_username WAS_admin_password]

    Windows

      eDMAppConfig.bat uninstall-all [WAS_admin_username WAS_admin_password]

Prevent timeouts from occurring during deployment

To prevent timeouts from occurring during deployment, change the value of the property com.ibm.SOAP.requestTimeout from its default value of 180 to a value of 0.

(This procedure is relevant for both WebSphere Application Server environments.)

1. Edit the file soap.client.props to set the value of the com.ibm.SOAP.requestTimeout property to 0.


    The file soap.client.props exists in the properties subdirectory of the path to the WebSphere Application Server profile for eDiscovery Manager.


For complete information about the SOAP request timeout property, see Java Management Extensions connector properties topic in the WebSphere Application Server Version 6 information center.

It can be useful to leave the value of this property at 0 even after eDiscovery Manager is successfully deployed. Doing so prevents subsequent uninstallation commands from timing out if you later decide to remove eDiscovery Manager from the system.



Manually deploy eDiscovery Manager

To manually deploy eDiscovery Manager:

1. Edit the file eDMAppConfig.bat to remove the following two exits at the end of the file.


    exit 0
    exit %rc%


2. Edit the file setenv.sh (on AIX) or setenv.bat (on Windows) to change the value of the parameter ANT_CMD to point to the path of the eDiscovery Manager server profile, for example:

    AIX
      export ANT_CMD=/usr/MyWASProfiles/eDMServer/bin/ws_ant.sh
    Windows

      set ANT_CMD=E:\MyWASProfiles\eDMServer\bin\ws_ant

    The file setenv.* exists in the scriptsWAS subdirectory of the eDiscovery Manager installation directory.

3. Edit the file scriptsWAS\appdeploy.properties to change the value of the property WASProfilePath to the path of the eDiscovery Manager server profile, for example:

    AIX
      WASProfilePath=/usr/MyWASProfiles/eDMServer

    Windows

      WASProfilePath=e\:/MyWASProfiles/eDMServer
4. Manually deploy eDiscovery Manager from the scriptsWAS subdirectory of the eDiscovery Manager installation directory by running one of the following commands:

    AIX

      When installing eDiscovery Manager for the first time:
      eDMAppConfig.sh install-all
      WAS_userid WAS_password >> out.out

      When upgrading eDiscovery Manager:
      eDMAppConfig.sh update-all
      WAS_userid WAS_password >> out.out

    Windows

      When installing eDiscovery Manager for the first time:
      eDMAppConfig.bat install-all WAS_userid WAS_password >> out.out

      When upgrading eDiscovery Manager:
      eDMAppConfig.bat update-all WAS_userid WAS_password >> out.out
5. Run the shell script postinstalledm.sh to perform some necessary post-installation tasks.

    The eDiscovery Manager scripts are in the scripts subdirectory of the eDiscovery Manager installation directory. For example, enter the following command to run the script on a WebSphere Application Server that has security enabled:

      /opt/IBM/eDM/scripts/postinstalledm.sh TRUE WAS_admin_username
         
      WAS_admin_password

    If security is not enabled on the WebSphere Application Server, run the script with only the FALSE parameter. For example:

      /opt/IBM/eDM/scripts/postinstalledm.sh FALSE
 
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Enterprise Content Management
 Search & Discovery
 eDiscovery Manager
 Operating system(s):
  AIX, Windows 2003 server, Windows 2008
 Software version:
  2.1.1.0
 Reference #:
  1399125
 IBM Group:
 Software Group
 Modified date:
 2009-09-18

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.