F Appendix: Wallet Management Tool

When installing an Oracle Retail POS Suite application, the installer creates the cwallet.sso file and stores any user credentials that were entered on the installer screens in the file. If the user credentials change once the application is installed, the cwallet.sso file must be updated with the new passwords.

The Wallet Management Tool is provided to update an existing credential and add a new credential in the wallet file. It prompts for the required information.

To use the tool, the following files and directories are required:

• The cwallet.sso file is found in the installation directory from a previous successful install.

• The wallet.xml Ant file, ant directory, and ant-ext directory are available in the staging area directory created for installing each application.

• The cwallet.sso file and wallet.xml Ant file must be in the same directory.

Updating an Existing Credential

To update a credential that already exists, use the following:

ant -f wallet.xml update

• You are prompted for the user name alias, user name, old password, and new password.

• You must enter the old password before the tool allows you to enter the new password.

• If you attempt to update a credential that does not exist, a Java exception is displayed.

Adding a New Credential

To add a credential, use the following:

ant -f wallet.xml add

• You are prompted for the user name alias, user name, and password.

• If you attempt to add a credential that already exists, a Java exception is displayed.