Setting up a Project.net Developer Workstation on BEA Server 9.2

Overview

A project.net development and build environment can be created on any operating system platform that supports Java, the BEA WebLogic application server, the ant utility, and a Subversion client.

Configuration Steps

Follow the steps below to configure a developer workstation to build and run the Project.net application on the BEA WebLogic application server.

1. Download the needed 3rd party software

1. BEA WebLogic Express 9.2 MP1 (9.2) application server
   • Download: http://commerce.bea.com/showproduct.jsp?family=WLS&major=9.2&minor=1
   • How to Install: Refer to 4 below
2. JDK 1.5
   • Download: http://java.sun.com/javase/downloads/index_jdk5.jsp
   • How to Install: http://java.sun.com/j2se/1.5.0/install.html
3. ANT 1.6.5
   • Download: http://ant.apache.org
   • How to Install: http://ant.apache.org/manual/index.html
4. Subversion (svn) client v1.2.3
   • Download: http://subversion.tigris.org
   • How to Install: http://svnbook.red-bean.com/
5. Oracle Database 10g (10.2) Enterprise Edition
   • http://www.oracle.com/technology/software/products/database/oracle10g/index.html

2. Checkout the Project.net Source Code from the Subversion Repository

Refer to this page for directions on downloading a copy of the the Project.net source tree.

3. Install and Setup the Oracle Database

1. Install Oracle 10.2 Enterprise Edition
2. Run the Oracle "Database Configuration Assistant" to create a database instance for the Project.net Application. Create an Oracle database instance (called v83dev or any name you want). Set and remember the SYSTEM password.
3. Run the Project.net database schema creation script
   1. Go to the database script directory in the source code tree: core\db\oracle\createscripts\admin.
   2. Edit the pnetMasterDBBuild.bat (or pnetMasterDBBuild.sh) file. Set the environment variables in this script to match your database configuration. Further instructions are available in the script file.
   3. To start the database installation, run the batch command pnetMasterDBBuild.bat (or pnetMasterDBBuild.sh) from within the core\db\oracle\create-scripts\admin directory.
   4. Check the logs in the log file location you have specified inside of the pnetMasterDBBuild file. You will notice some errors in the logs about public synonym already exists, etc., but there should be only about 55 lines in the log file with the word "ERROR".
   5. If the script fails and you need to re-run it, it's best to run the core/db/oracle/create-scripts/tools/drop_pnet_and_user_schemas.sql script to clean everything up before trying again.

4. Install and setup BEA WebLogic application server

Windows Installation:

1. Double click on the executable server920_win32.
2. Accept the license agreement.
3. Choose the BEA Home directory.
4. Choose custom option.
5. Select all the WebLogic Server components and deselect the Workshop for WebLogic Platform components as it's not required.
6. Select the Mercury profiling tools (optional).
7. Accept the license agreement if Mercury profiling tool is selected.
8. Accept the default Product installation directory.
9. Accept default for node manager service.
10. Accept default for shortcut location option.
11. Click next to install.
12. After installation uncheck the Run Quickstart checkbox.

5. Configure BEA WebLogic application server

1. Go to Start->Programs->BEA Products->Tools->Configuration Wizard.
2. Select Create a new WebLogic domain option.
3. Accept the default option for Select Domain Source.
4. When prompted enter the password.
5. Select the Sun JDK 1.5.0_04.
6. Select the option in Customize Environment and Services Settings.
7. Change the Administration Server Name to myserver and select the SSL enabled checkbox.
8. Click next in Configured Managed Servers.
9. Click next in Configure Machines.
10. Click next on Review WebLogic Domain.
11. Change the Domain name to pnet.
12. Select the Start Admin Server check box.
13. Extract the Java security policy files (local_policy.jar and US_export_policy.jar) from the downloaded zip file jce_policy-1_5_0.zip into <Drive>:\bea\jdk150_04\jre\lib\security directory.
14. Copy the core\lib\endorsed directory from Project.NET into <Drive>:\bea\jdk150_04\jre\lib directory.

6. How to configure Project.net to run on BEA WebLogic application server

1. Creating the pnet data source
   1. Go to http://localhost:7001/console
   2. Login into WebLogic server console.
   3. On the left hand side under Domain Structure, go to Services->JDBC->Data Sources.
   4. Click on Lock and Edit on left hand side and then click on New button.
   5. JDBC Data Source Properties
      • Name: Pnet Data Source
      • JNDI Name: jdbc/PnetDB
      • Database Type: Oracle
      • Database Driver: Oracle's Driver (Thin) Versions: 9.0.1, 9.2.0, 10
   6. Accept defaults and click next.
   7. Connection Properties
      • Database Name: pnet
      • Host Name: localhost
      • Port: 1521
      • Database User Name: pnet (eg:)
      • Password: pnet (eg:)
   8. Click on Test Configuration to check the configuration settings.
   9. If successful click next.
   10. Select myserver check box and click finish.
   11. Click on Activate Changes.
2. Creating the pnet mail sessions
   1. On the left hand side under Domain Structure, go to Services->Mail Sessions.
   2. Click on Lock and Edit on left hand side and then click on New button.
   3. Mail Session Properties
      • Name: PNET-Mail-Session
   4. Click on PNET-Mail-Session and in the configuration tab enter the following and click on save.
      • JNDI Name: mail/PnetSession
      • JavaMail? Properties:
        • mail.transport.protocol=smtp
        • mail.smtp.host=SMTP-SERVER-NAME
   5. Click on Target tab and select the myserver and then click on save.
   6. Click on Activate Changes.
3. Build the project.net application
   1. Configure the build.properties, follow the instructions provided in build.properties
   2. run build.bat in core directory.

7. How to deploy Project.net on BEA WebLogic

1. On the left hand side under Domain Structure, go to Deployements.
2. Click on Lock and Edit on left hand side and then click on Install button.
3. Locate the pnet deployement to install present in <Drive>:\bea\user_projects\domains\pnet\applications directory and click next.
4. Select Targeting Style as Install this deployement as an application.
5. Accept default and click next.
6. Accept default and click Finish.
7. Click on Activate Changes.
8. On the left hand side under Domain Structure, go to Deployments.
9. Click on Lock and Edit on left hand side and then select the pnet deploymenet check box and click start? Servicing all requests.
10. Click Yes to Start Deployements.

8. Configure the Project.net Application

1. http://localhost:7001 Login as the application administrator.
   • username: appadmin
   • password: appadmin
2. Change the file path for document storage on your computer.
   1. Click "Application Space" on the lower left to view and change Project.net application configuration.
   2. Click the "Manage --> Doc Vault" link
   3. Enter a directory path for each of the three "Path to Repository Root" such as:
      • c:\pnet-doc-vault\one
      • c:\pnet-doc-vault\two
      • c:\pnet-doc-vault\three
3. You may also need to change some of the application settings on the Application Space --> Sys. Settings page to match your server. For instanace, if you are running on linux, you will need to change the postDataTempDir setting since it default to a Windows C:\temp directory.
4. If you want the URLs in the email notifications to match your machine, you will need to change three configuration tokens. Go to the Application Space --> Configurations --> Project.net configuration --> Tokens --> select Basic Branding --> click Filter
5. Modify the following tokens used to construct the email notification URLs, probably with the following values:

     prm.global.brand.defaulthost            localhost
     prm.global.brand.defaultjsprooturl      /
     prm.global.brand.defaultsitescheme      http://
   

9. Install License Files

See Installing Licensing Files.pdf from the Downloads page for instructions on installing the License Properties

10. Set up Eclipse development enviroment

1. Make an update from SVN (there are some files with some changes needed to run properly with the new configuration).
2. Open the Servers view.
3. Create a new BEA Server pointed to the server and domain that we create in the previous section.
4. Test the new server (run the server without the Project.net application deployed and verify that the server start and ends correctly).
5. Set the JAVA_HOME environment variable with the path of the SDK installed in the BEA server (or you can also install a new SDK 1.5, both are valid).
6. Add the SDK 1.5 to be use in the Eclipse workspace (in the installed runtimes section).
7. Change the configuration of the build.xml to run with the JRE 1.5 that we installed in the previous step.
8. Add the endorsed to the SDK referenced by the JAVA_HOME.