Configuration Manager - Commerce - Instance

The Instance page of the Configuration Manager is used to specify basic information about the instance.

Instance Name
Enter the name that you want to call the WebSphere Commerce instance. The default name for a WebSphere Commerce instance is demo.

Each WebSphere Commerce instance must have a unique name.

The instance name cannot be changed after the instance is created. To change the name of an instance, you must delete the instance you want to rename and create a new instance with new name

i5/OSiSeries The instance name must contain 9 characters or less.
Windows The instance name must contain 12 characters of less.

Merchant Key
Enter a 16-digit hexadecimal number for the Configuration Manager to use as an encryption key. The merchant key must meet the following criteria:
  • Must contain at least one numeric character (0 - 9)
  • Must contain at least one alphabetic character (a - f)
  • Cannot contain any upper-case alphabetic characters
  • Cannot contain four consecutive occurrences of a character
  • The same character cannot appear more than four times

A hexadecimal number contains the following numbers and letters: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e, and f.

The merchant key is not displayed after the instance is created.

After creating an instance, the merchant key can be changed using the Database Update Tool. However, do not change the merchant key after publishing a store.

PDI encrypt
Select this check box to encrypt the information specified in the ORDPAYINFO and ORDPAYMTHD tables. Payment information will also be stored in the database in encrypted format when this check box is selected.
Enable Struts-based Web application
Select this check box to have the WebSphere Commerce instance configured to use the Struts framework.

The struts framework is the Apache Software Foundation's open source framework for building Java Web applications. For more information about Struts, visit the official Struts home page at http://struts.apache.org/.

Clear this check box to have the WebSphere Commerce instance configured to use the Web application framework used in WebSphere Commerce Version 5.6 and lower. This is also referred as the traditional WebSphere Commerce Web application framework.

You may move from the traditional WebSphere Commerce Web application framework to the Struts-based framework at a later point, but you cannot move from the Struts-based framework to the traditional WebSphere Commerce Web application framework.

URL mapping file
Enter the path to the file you will be using for URL mapping. The default URL mapping file is WC_installdir/xml/mapping/urlmapper.xml
Site Admin ID
Enter the ID used for the WebSphere Commerce Site Administrator.
Site Admin Password
Enter a password for the WebSphere Commerce Site Administrator. The password must meet the following criteria:
  • Must contain at least 8 characters
  • Must contain at least 1 numeric character (0-9)
  • Must contain at least 1 alphabetic character (a-z, A-Z)
  • Cannot contain four consecutive occurrences of a character
  • The same character cannot appear more than four times
Confirm Site Admin Password
Re-enter the Site Administrator's password.
Generate properties file only
This check box only displays in the Instance Creation wizard.

Select this check box if you do not want to create an instance but you want to populate a properties file. The properties file can be used with the CreateInstance Ant target to create a WebSphere Commerce instance.

The properties file is found in WC_installdir/instances/instance_name/properties/createInstance.properties.

Feedback