(Developer)

Enable Workspaces in the WebSphere Commerce development environment

The development environment is not meant to be an authoring environment. Support is provided in the environment for customization purposes only. For example, to test changes to the content management functionality. The ability to propagate changes is not available. To change the content management workspaces, we cannot publish the changes out to another database.


Before beginning

Before you enable workspaces in the WebSphere Commerce development environment, ensure that:

  1. Change history is enabled in the development environment. Complete the following steps to enable it:

    1. Go to the WCDE_installdir/workspace/WC/xml/config/wc-server.xml.

    2. Open wc-server.xml and find <WorkspaceChangeHistoryEnabled enable="false"/>.

    3. Edit the settings to the following values: <WorkspaceChangeHistoryEnabled enable="true"/>.

    4. Save and close the file. Then, restart the server.


Procedure

  1. Exit the development environment.

  2. Issue the following command: 

      WCDE_installdir/bin/enableContentManagement.bat number_of_workspaces addWorkspace

    Where:

      number_of_workspaces
      Use the number_of_workspaces parameter if we are enabling workspaces in the WebSphere Commerce development environment for the first time.

      Enter the maximum number of workspaces we want on the authoring environment. Ensure that the number of workspaces that are allocated is sufficient to handle the number of concurrent workspace activities that might occur.

      The maximum number of workspaces is the maximum number of simultaneous activities that require data isolation. Multiple stores managed by the same organization can share a workspace. For instance, to work on two future events simultaneously and provide regular updates and a data-isolated area in which to complete emergency fixes, you need four workspaces per organization.

      The maximum number of workspaces specifies the number of database schemas that are allocated for workspaces. The number of allocated database schemas remains fixed. If a Workspace Manager creates more workspaces than the number of workspace database schemas available, task groups in workspaces without an available database schema cannot be activated until another workspace is completed or canceled.

      See Workspaces data model.

      addWorkspace
      Use the addWorkspace parameter if workspaces is already enabled in the WebSphere Commerce development environment.
      Specify the number of additional workspaces to create.

    If you encounter errors when you run the utility, review the enableContentManagement.log file for more detailed troubleshooting information. This file can be located within the following directory:

  3. Enable the WebSphere Commerce search index. Run the setupSearchIndex utility with the following workspace-specific parameters specified:

    • dbauser

    • dbauserpwd

    • createAll

    See Setting up the search index.

  4. Start the test server.

  5. (v9.0.0.1) Add the JVM argument, WorkspaceTaskListEnabled, which is needed for workspaces to function in Version 9.0.0.1.

    1. Open the Administration console, and go to Application Server > server > Process definition > Java Virtual Machine. server is the name of your server, and the default value is server1.

    2. In the Generic JVM argument field of the Configuration tab, add the following string. 

        -DWorkspaceTaskListEnabled=true

    3. Save our changes to the master configuration.

    4. Restart the test server.

  6. Optional: Enable email notification in workspaces.


Related concepts
Workspaces overview


Related tasks
Enable e-mail notification for workspaces
Running authoring environment update scripts
Creating an authoring environment
Configure a transport method for the site
Assigning a message type to a transport method for a site or store


Related reference
enableContentManagement utility