Preparing the createInstance.properties file

You can prepare the createInstance.properties file by using Configuration Manager or you can create it manually.

  • Preparing the properties file by using Configuration Manager: The Instance Creation wizard guides you through the appropriate and required values, validates the provided values, and indicates whether there are any errors in the input.
  • Preparing the properties file manually: Use this option with caution. Values are not validated during instance creation. If values are not correct, errors can occur during the instance creation process. Recovering from errors can be difficult and time consuming.

Preparing the properties file by using Configuration Manager

Procedure

  1. Open the Configuration Manager
  2. In the Configuration Manager wizard, select the Generate properties file only check box.
  3. Complete the wizard as if you were creating and configuring your WebSphere Commerce instance. Select values appropriate to your target environment – the environment where you are planning to use the Ant targets to create and configure instances.
    Note: Generate your properties file on the same server where you run the Ant targets.
    The generated properties file is stored in:
    • WC_installdir/instances/instance_name/properties/createInstance.properties
    • For IBM i OS operating systemWC_userdir/instances/instance_name/properties/createInstance.properties
  4. To change additional values to match your Ant target environment, open the following file in a text editor:
    • WC_installdir/instances/instance_name/properties/createInstance.properties
    • For IBM i OS operating systemWC_userdir/instances/instance_name/properties/createInstance.properties
  5. Change the values, as required, to match your Ant target environment. Typically, you only modify the password values in the file.
    Warning: Do not store data for the following fields in the createInstance.properties file as it poses a security risk:
    • siteAdminPassword
    • merchantKey
    • dbaPassword
    • dbUserPassword
    • ftpUserPwd (if using a remote web server and FTP mode)
    These variables can be passed as parameters when you run the config_ant utility.
    Every parameter is described in comments in the file. All required parameters are provided by generating the file using the wizard. There are additional optional parameters in the file that are blank; do not provide values for these parameters. The following parameters require additional explanation beyond the comments in the file:
    WASJDBCDriverType
    The JDBC driver used by WebSphere Application Server. The possible values are:
    db2
    For DB2 databases
    oracle
    For Oracle databases.
    For IBM i OS operating systemdb2_iseries_toolbox
    For IBM i OS operating systemUse with a DB2 remote database.
    For IBM i OS operating systemdb2_iseries_native
    For IBM i OS operating systemUse with a DB2 local database.
    ejbType
    Specifies the data source type that your EJBs are deployed to. Accepted values are:
    db2
    For DB2 databases.
    oracle
    For Oracle databases
    For IBM i OS operating systemos400
    For IBM i OS operating systemFor use with a DB2 database.
    sqldir
    Specifies the folder under WC_installdir\schema where the DDL are loaded from. The accepted values are:
    db2
    For DB2 databases.
    oracle
    For Oracle databases
    For IBM i OS operating systemos400
    For IBM i OS operating systemFor use with a DB2 database.

Preparing the properties file manually

Procedure

  1. Make a copy of the WC_installdir/config/deployment/properties/createInstance.properties template and save the file to a temporary location.
  2. Edit the file to provide the appropriate values.
  3. Save the file to the following location:
    • LinuxAIXWindowsWC_installdir/instances/instance_name/properties/createInstance.properties
    • For IBM i OS operating systemWC_userdir/instances/instance_name/properties/createInstance.properties
    Note: instance_name is the name that you provided inside the properties file.