Making a new Nextel WSAD workspace

Purpose:

This document contains a procedure to build a laptop with WSAD and the online store applications.

WSAD will contain all the source code and 3 unit test servers.

Prerequisites:
    CVS access eg. username and password and permission to access the projects
            The file /app/was/oracle/tnsnames.ora from one of our develoment servers.
    Oracle client 8.1.7.4 in installed on the laptop
    WSAD 5.x is installed on the laptop.

Intial setup:
Create a new workspace
Open WSAD and specifiy an new directory path

    Setup CVS
        Windows -> Preferences -> Team
            click the box Use Incoming/Outgoing mode when synchronizing.

        Expand the "Team" node
        Click CVS in the left panel
            Set Default keyword substitution to -kkv.
                    FYI, this set the default substitution mode for the individual server-side files of new files that you you add from this workspace.
                    This does not effect retrievals because the WSAD CVS Plugin always uses the default substitution mode that the CVS server
                    has for the file.

           Click "Ignored Resources" in the left panel
                repeatedly hit the ADD button to add the following patterns
                classes
                bin
                *.class
                org
                ibm

These prevent storage of a bunch of unnecessary crap under SCM, and results in significant speed increase for WSAD synchronizations.
These changes have to be made for every WSAD Workspace that you use. (This is because these settings are saved in the workspace, and therefore apply only to the current workspace).
Turn off the automatic build feature of WSAD
Window->Preferences->Workbench
uncheck the "Perform build automatically when resource is modified"

Import the project files from CVS:
    Connect to CVS
        Window -> open perceptive -> CVS repository Exploring
        Right Click-> New -> respository location

            Host    nhqsnpr1.nextel.com
            Repository path:    /cvs/cvsrepos
            Username
            Password
            Connection Type: Extssh
        Click Finish

Turn off validation for the moment
    Window->Preferences->Validation
    Click "Deselect All"
    Click "OK"

Import the projects from CVS
    Select the following modules, from the left panel:
        accountMeditor-ejb
        aisleAdmin-ejb
        aisleCore-ejb
        ast-ear
        astSchedulerDaemon-jar
        ast-web
        callFraudCheck.jar
        catalog-ejb
        coreFramework-jar
        corePresentation-jar
        creditCheck-jar
        emt-ear
        emt-ejb
        emt-jar
        emt-web
        oswnp-ejb
        payment-ejb
        ratePlan-ejb
        salesTax-jar
        shop-ejb
        storeAccount-ejb
        store-ear
        store-web

Right Click -> Check out as project

Go get coffee.... This will take about 10 minutes..

Create the external library directory
Create the following direcitory : C:\NEXTEL_EXTLIBS

    Open the CVS repository view
        Right click the "extlibs" folder -> Check out as project
        Click "OK"

    Locate the files in the workspace using Windows Explorer
        The files are as follows:
            taxcommon.jar
            classes12.zip

It is located in the following directory:
<workspace>\extlibs

Copy these files into the C:\NEXTEL_EXTLIBS directory

    Copy the other jar files
    Locate the following jar files:
           g1c1matc.jar
           ldapjdk.jar
           log4j-113.jar
           struts-1.0.2.jar
           fraudImports.jar

    They located in the
            <workspace>\store-ear
    Copy this file into the C:\NEXTEL_EXTLIBS directory

Acquire the coreEJB.jar file
    Open the CVS repository view
        Right click the "core-ejb" folder -> Check out as
        Select Java on the left panel and Java Project on the right panel
        Click "Next"
        Type the project name = "temp"
        Click "Finish"

    Import the the JAR file
        File->Import->EJB JAR file
        Browse to the <workspace>\temp\bin
        Select coreEJB.jar
        new project name = core-ejb
        Click existing
        For the Enterprise Application click "Browse" and select any of the existing EARs

    Remove the temp module for WSAD
        Right click "temp" select Delete
        Select "Also delete contents under ..."

Acquire the fraudProcessor.jar file
    Open the CVS repository view
        Right click the "fraudProcessor-ejb" folder -> Check out as
        Select Java on the left panel and Java Project on the right panel
        Click "Next"
        Type the project name = "temp"
        Click "Finish"

    Import the the JAR file
        File->Import->EJB JAR file
        Browse to the <workspace>\temp\bin
        Select fraudProcessor.jar
        new project name = fraudProcessor-ejb
        Click existing
        For the Enterprise Application click "Browse" and select any of the existing EARs

Define the NEXTEL_EXTLIBS variable
        Right click the "temp" project -> properties -> Java Build Path ->Libraries
        Click Add variable-> New
            Name:     NEXTEL_EXTLIBS
        Click "Folder" and navigate to the following path:
               Path :       C:\NEXTEL_EXTLIBS
        Click "OK"
        Click "Extend"
        Select any file
        Click "OK"

    Remove the temp module for WSAD
        Right click "temp" select Delete
        Select "also delete contents under..."

Synchronize the workspace with the repository
    Select all of the modules
    Now deselect the binary projects
        fraudProcessor-ejb
        core-ejb
    Then Right click the remaining modules and select Team->"Synchronize with Repository"

Select all the top level modules in the "Synchronized" view (lower right hand panel)
Right click and select "Override and Update"

The source code is now loaded

Configuration:

Turn on the automatic build feature of WSAD
Window->Preferences->Workbench
Check the "Perform build automatically when resource is modified"

Turn on validation
    Window->Preferences->Validation
    Click "Select All"
    and then deselect "HTML Validation"
    Click "OK"

Rebuild the entire workspace
Project->Rebuild-All

Import the servers project from CVS

Use the same exact procedure that you used to check out your other CVS modules

Extract the zip file from the servers project

In the "servers" directory of your workspace there should be a zip file.
Unzip this zip file (preserving directories) to the root of your C: drive.

Configure Oracle
    Open the <OracleHome>/network/ADMIN/sqlnet.ora with a text editor
    check to see if the NAMES.DIRECTORY_PATH has "tnsname" as one of the items.
        If not you will need help - call Blaine

Copy the tnsnames file from : C:/App/temp/oracle/tnsnames.ora
to the <Oraclehome>/network/ADMIN

    Fix the location of the Oracle lib files
        Open the server perspective
        Click the Variables tab
        Under Node settings, Select the variable "ORACLE_HOME"
        Click "Edit"
        Set the value of this variable to point to the location of your Oracle directory
            For example: C:\oracle\ora81

Setting up WSAD with CVS