PiggyBank complete implementation setup instructions

This sample contains the PiggyBank design model and the complete source code for the PiggyBank online banking application. To run the PiggyBank online banking application sample, import the PiggyBank complete implementation sample and follow these steps.

System prerequisites

To run the sample, you must perform the following tasks:

  • Import the PiggyBank complete implementation sample from the overview page.
  • Install the IBM® WebSphere® Version 6.0 test environment. If you did not select this option during installation, you can install this feature with the IBM Rational Software Development Platform installer.

The PiggyBank online banking application uses the Cloudscape database, which is included with IBM Software Development Platform. Cloudscape is an embedded Java database and no special installation is required.

Starting the application

The PiggyBank sample must be built before it can be deployed to a server. By default, the workbench is set to automatically build projects. If this option is disabled, click Project > Build all to build all of the projects in the workspace. This may take a few moments for the code to compile.

Once the code is built, you can follow these steps to configure and start the PiggyBank online banking application:

  1. Start the server
  2. Deploy the application
  3. Explore the application
  4. Starting the server

    To start the server:

    1. Click Window > Open Perspective > Other. The Select Perspective window opens.
    2. Select J2EE and click OK to open the J2EE perspective.
    3. Click the Servers tab to open the Servers view and display the available servers.
    4. Select WebSphere Application Server v6.0 and click the Start the server button to start the server.
    5. The server status changes to Started in the Servers view. 

    Deploying the application

    To deploy the application:

    1. In the Servers view, right-click the new server; then click Add and remove projects.
    2. To move ItsoAdEAR to the Configured projects, under Available projects, click ItsoAdEAR and click Add.
    3. To move ItsoAdCItyBankEAR to the Configured projects, under Available projects, click ItsoAdCityBankEAR and click Add.

    Exploring the application

    To run the creating customers and accounts UI:

    1. In the Project Explorer, expand Application Client Projects and select ItSoAdCustomerAccountManagerClient.
    2. Click Run > Run...
    3. In the Configuration list, select Websphere V6.0 Application Client and click New.
    4. In the Name type a configuration name. Ensure that the Enterprise Application value is set to ItSoAdEAR and Aplication client module is set to ItSoAdCustomerAccountManagerClient
    5. Click Run.
    6. In the PiggyBank application, enter a Customer ID, Customer name, and Account number and click Apply to create a customer and account.

    To run the teller UI for depositing cash:

    1. In the Project Explorer, expand Application Client Projects and select ItSoAdTellerClient.
    2. Click Run > Run...
    3. In the Configuration list, select Websphere V6.0 Application Client and click New.
    4. In the Name type a configuration name. Ensure that the Enterprise Application value is set to ItSoAdEAR and Aplication client module is set to ItSoAdTellerClient
    5. Click Run.
    6. In the PiggyBank application, enter the Credit Account Number, Check reference (can be any value - is not currently validated), and Amount (should be less than $100) and click Cash check to deposit a check.

    To run the customer UI for transferring cash:

    1. In the Project Explorer, expand Dynamic Web Projects, and select ItSoAdServlet.
    2. Click Run > Run... > Run on Server...
    3. In the Server Selection wizard, ensure that the current server is selected and click Finish.
    4. The PiggyBank web UI opens automatically. Click PiggyBank Home Banking system and enter the customer ID that you created in the previous step to use the online banking system.