For IBM i OS operating system

Opening Configuration Manager on an IBM i system

The Configuration Manager provides a graphical interface for configuring a WebSphere Commerce instance.

About this task

Configuration Manager consists of two components: a client component and a server component. The client component is a Graphical User Interface that is used to create or modify a WebSphere Commerce instance. The client is installed on a Windows system as part of the Remote WebSphere Commerce Management utilities component from the WebSphere Commerce installation package. The Windows system must be on the same network as the remote IBM i system.

The Configuration Manager server component runs on the remote IBM i system, which must have the licensed program for Java installed.
  • For IBM i Version 7.1, you need the licensed program for Java 5761JV1 installed
  • For IBM I Version 7.2, you need the licensed program for Java 5770JV1 installed.
The server component is installed as part of the WebSphere Commerce server runtime component on the remote IBM i system. The client and server components are able to communicate via RMI/IIOP protocol.
Note: The default user ID for Configuration Manager is configadmin and the default password is the password that was specified when the product was installed on the IBM i system. For example, config1admin.


  1. Prepare your IBM i system to start the Configuration Manager server.
    If modifying instance-specific properties using Configuration Manager, complete the following steps before starting the server.
    1. Log on to the IBM i system ensuring that the profile has a *SECOFR user class and is set up with the language specific settings for English or the desired default language for your instance. If you have not been set up as a user, see: Creating a user profile
    2. Start a Qshell session and switch to the WC_installdir/bin directory.
    If creating a new instance, complete the following steps before starting the server.
    1. Start a Qshell session and change the current directory to the QIBM/ProdData/WebSphere/AppServer/V8/ND/bin directory.
    2. Run the command osgiCfgInit -all. When the command has completed, the $ prompt will return in the Qshell.
    3. Change the current directory to the WC_installdir/bin directory.
  2. Start the Configuration Manager server: [-port server_port_number]

    The -port parameter is optional. If you do not specify this parameter, the default port of 1099 is used. The Configuration Manager server will listen on this port number.

    If the -port parameter is specified, the value must be between 1024 and 65535 and not currently in use on the IBM i system.

    Note: If you are using a system where your primary language is not the same as the language in which you are creating your instance, you must add the QSYSlanguage_feature_number library into your user profile's library list. Otherwise, the profile will try to locate it under QSYS. To add the language feature library, use the EDTLIBL command.
    When you receive the following messages, proceed to the next step:
    Registry created.
    CMServer bound in registry. 
  3. Start the Configuration Manager client:
    1. Using a command prompt on the system on which the Configuration Manager client is installed, change to the Configuration Manager directory.
    2. Issue the following command:
      configClient.bat -hostname IBM_i_host_name [-port server_port_number]
      The fully qualified host name of the server. Ensure the host name is entered as specified in the CHGTCPDMN command.
      The port number on the IBM i server on which the Configuration Manager is listening. You only need to specify this value if the server is listening on a non-default port. The port parameter is optional but if it was specified in the command, it needs to be specified here.
  4. In the Configuration Authentication window, type the Configuration Manager user ID and password and click OK.