WebSphere brand IBM WebSphere XML Document Management Server, Version 7.0

Installing using the interactive installer

Launch the interactive installation to install XDMS and desired components.

Before you begin
You must have met the following requirements:
About this task
To install IBM XDMS and the XDMS enterprise applications, perform the following steps at the deployment manager node:
  1. Insert the XDMS installation CD into the CD-ROM drive.
  2. Change directories (cd) to the CD-ROM drive.
  3. Set the proper file permissions on the installer by entering the following from the command prompt:
    chmod 755 setup
  4. Issue the following command to launch the interactive installer:
    ./setup
  5. In the Introduction pane, click Next.
  6. Select I accept the terms of the License Agreement.
  7. Click Next. The installer checks to verify that the correct version of WebSphere Application Server is installed and returns a list of qualified WebSphere Application Server installations.
  8. Select a WebSphere Application Server installation.
  9. Click Next.
  10. Select the machine profile for the machine where you are installing. For machines hosting only managed nodes, you should only install the IBM XDMS core files and not the component applications.
  11. Click Next.
  12. Enter your WebSphere Application Server host and security information.
    1. Type the SOAP port address for your WebSphere Application Server.
    2. If security is enabled, select The WebSphere Environment is secure.
    3. Type an administrative user ID.
    4. Type the password for the administrative user ID.
  13. Click Next. The installer looks for an installation of the OSGi bundle for IBM XDMS version 7.0. If none are found, the installation configuration screen displays with the XDMS Core Files selected.
  14. Optional: You may choose additional components to install. Additional components include:
    • Shared List
    • Presence Rules
    • Aggregation Proxy
    • Shared Policy
    • Shared Group
    • Shared Profile
    Note: The process described in this document will be repeated for each selected component.
  15. Click Next. The installation configuration is the next screen.
  16. Configure the installation:
    1. Select the target scope for the component, for example WasScope[type]:ServerCluster[cluster]:SharedListCluster for the Shared List component.
    2. Click Next.
    3. Type the required information in the fields for the component you selected.
      Table 1. Resource Environment Provider values
      Field Value
      XCAP Root The XCAP Root of the Aggregation Proxy, if installed, or the XCAP Root of the local server (recommended value: http(s)://hostname:ports/services)
      Super User User A user configured with the super-admin role (recommended value: superadmin)
      Super User Password Password for the super-admin role (recommended value: none)
    4. Click Next.
    5. Select the database type you are using:
      • DB2 IBM DB2
      • Oracle Oracle
    6. Type the required information in the database fields for the component you selected.
      Table 2. Enabler data source information
      Field Value
      Database Driver Directory db_client_root/java/
      Note: Where db_client_root is the path where your database client has been installed.
      Database Server Host The host name of your database server, for example dbServerhostname.
      Database Port The database port number designated for client communications, for example 50001.
      Database Name or Oracle SID The database name for the XDMS, for example xdms.
      Database User The administrative user name for the database instance.
      Database Password The password for the database administrative user.
    7. Click Next.
    8. Select a storage type for Service Integration Bus data: Data Store or Files Store.
  17. Click Next. If you have selected another component, that component's installation configuration appears next. Repeat the steps for each component.
    Note: If you selected to install multiple enablers, the common configuration information previously entered for the first one is retained. As each panel is presented, you may change the information as needed.
  18. Configure the Service Integration Bus data source.
    Note: This data source will be common to all installed enablers.
    1. Select the database type you are using: Data Store or Files Store.
    2. Type the required information in the database fields:
      Table 3. Service Integration Buss enabler data source information
      Field Value
      Database Driver Directory db_client_root/java/
      Note: Where db_client_root is the path where your database client has been installed.
      Database Server Host The host name of your database server, for example dbServerhostname.
      Note: For Oracle users this field is not needed and is grayed out.
      Database Port The database port number designated for client communications, for example 50001.
      Note: For Oracle users, this field is not needed and is grayed out.
      Database Name or Oracle SID The database name for the XDMS. This should be xdmssib.
      Database User The administrative user name for the database instance.
      Database Password The password for the database administrative user.
  19. Click Next.
  20. Optional: Select Yes to configure a usage record database.
    1. Click Next.
    2. Select the database type you are using:
      • DB2 IBM DB2
      • Oracle Oracle
    3. Type the required information in the database fields:
      Table 4. Usage Record enabler data source information
      Field Value
      Database Driver Directory db_client_root/java/
      Note: Where db_client_root is the path where your database client has been installed.
      Database Server Host The host name of your database server, for example, dbServerhostname.
      Note: For Oracle users this field is not needed and is grayed out.
      Database Port The database port number designated for client communications. For example 50001.
      Note: For Oracle users, this field is not needed and is grayed out.
      Database Name or Oracle SID The database name for the XDMS. This should be xdmsurdb.
      Database User The administrative user name for the database instance.
      Database Password The password for the database administrative user.
  21. Click Next. The Pre-Installation summary panel appears.
  22. Click Install.
  23. Perform these installation steps again on any remote nodes, installing only the XDMS core files.
    Note: If there are multiple nodes on the same machine as the deployment manager, you do not need to rerun the installer on that machine.
  24. Start the servers for the installed application.
    Note: During the startup, you can safely ignore any error messages that refer to problems with the UsageRecordWriter.properties file.



Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.