Generating the createInstance.properties file

The createInstance.properties file contains required parameters for the Ant targets. The file is used to create and configure instances; it must be available when these Ant targets are run. Use Configuration Manager to generate the file, then edit the file as necessary before running the Ant targets.

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.