Deprecated feature

Creating a WebSphere Commerce Payments instance

The first step in migrating WebSphere Commerce Payments is to create a Payments instance.

Procedure

  1. Start Configuration Manager. If WebSphere Commerce Payments is on a separate node from WebSphere Commerce, ensure that the Configuration Manager server on the WebSphere Commerce Payments node is started.
    For IBM i OS operating systemNote: Important consideration for DBCS users

    When creating an WebSphere Commerce Payments instance, start Configuration Manager using a user profile that has the required CCSID for the language in which you want your instance created. Valid CCSIDs are listed in Creating a user profile.

    For example, a WebSphere Commerce Payments instance might not be created with a CCSID of 5026 (CRTPYMMGR CCSID(5026)). You can create and run an instance on a system where the CCSID *SYSVAL is 5026.

    Before creating a WebSphere Commerce Payments instance under a different WebSphere Application Server instance, you need to stop and then restart the Configuration Manager server and client.

  2. Select WebSphere Commerce > hostname > Payments and right-click Instance List.
  3. From the pop-up menu, select Create Payments Instance. The Payments Instance Creation wizard starts.
    • For IBM i OS operating system The length of the WebSphere Commerce or Payments instance name you enter cannot be greater than 10 characters long and cannot include the following characters: / \ " | < > ? * : &
    • SolarisLinuxWindowsAIX The length of the Payments instance name you enter into WCIM cannot be greater than 12 characters long, and cannot include the following characters: / \ " | < > ? * : &
  4. Complete the Payments instance creation wizard information.
    • When completing the WebSphere Commerce Payments instance creation wizard, ensure that the value you enter in the Site Admin ID field is the WebSphere Commerce Site Administrator ID.
    • On the WCSRealm page, ensure that you enter the fully qualified host name for the WebSphere Commerce Web server in the Commerce Web server Hostname field. If you are using a separate Web server for WebSphere Commerce Payments , ensure that you do not enter the host name of the Web server you are using for WebSphere Commerce Payments , enter the name of the Web server for WebSphere Commerce.
  5. When you have completed all the necessary information in all the panels, the Finish button is enabled. Click Finish to create the WebSphere Commerce Payments instance.
  6. You are prompted for the following information:
    • OracleYou are asked if you want to populate the Oracle database. Select Yes if you want your database to be populated, or No if you do not want your database to be populated.
    • DB2If you choose to use an existing DB2 database, you are asked if you want to populate the database. Select Yes if you want your database to be populated, or No if you do not want your database to be populated.
  7. The time required to create an instance depends on the speed of your system. The progress bar that displays when you start creating the instance will indicate when the process has finished.
  8. When instance creation is complete, a dialog box appears containing a summary. Click OK to close the dialog box. Ensure that you review contents of the dialog. It might contain additional instructions.
  9. Exit Configuration Manager by clicking on Console and Exit.
  10. Verify the creation of the WebSphere Commerce Payments instance.

    The configuration information for the new WebSphere Commerce Payments instance is stored in the following file. Confirm that this file exists before checking the log files produced during instance creation.

    • payments_instance_name\xml\payments_instance_name
    • SolarisLinuxAIX WC_installdir/instances/payments_instance_name/xml/payments_instance_name
    • For IBM i OS operating system WC_userdir\instances\payments_instance_name\xml\payments_instance_name

    where payments_instance_name is the name of WebSphere Commerce Payments instance.

    The log files are in the following directory:

    • DB2 WC_installdir\instances\payments_instance_name\logs
      • createdb.log
      • createdb.err.log
    • For IBM i OS operating system WC_userdir/logs directory:
      • Configurator.1.log This log file will be required by IBM support if there was a problem with the Payments instance creation.
      • WCSconfig.log
  11. Continue by following the instructions in the Mandatory post-instance creation tasks in the WebSphere Commerce Installation Guide. Complete the following instructions for WebSphere Commerce and WebSphere Commerce Payments to function correctly.
  12. Configure Commerce instance to connect to Payment instance
    1. Open the Configuration Manager.
    2. Select WebSphere Commerce > hostname > Commerce > Instance List > instance_name > Instance Properties and click Payments.
    3. Make sure that the value filled in for the "Web server Hostname" field is the fully qualified hostname of the machine where WebSphere Commerce Payments is installed. If it is not, then update it. Complete any other necessary fields and click Apply. For help on completing the fields, click Help.