9 1:Default Installation Instructions

From Pnet-Community

Jump to: navigation, search

Contents

[edit] Instructions for Project.net Default Installation Package

[edit] Introduction

The Project.net Default Installation Package is a web based installation package, designed for easy deployment of Project.net (v9.1.1). Use this installer and instructions to quickly and easily install Project.net in order to evaluate the application. Note, the Default Installation will use default installation locations, user names/passwords and settings - suitable to evaluate Project.net.

For a "production" installation of Project.net we recommend following the instructions for a custom Project.net installation on Linux or Windows. These will result in a more secure, higher performing application. Alternatively, you can choose to have the Project.net Support team perform a professional installation. Please contact sales@project.net.

The Default Installation will install a copy of Apache Tomcat 6, Java 1.6 and Apache ActiveMQ pre-configured with Project.net, it is not necessary to install them separately. However, you will need a copy of Oracle 10g Enterprise or Express database; we recommend Oracle Express edition since it is free to use and is very easy to install. If you do not have a database installed, the Evaluation Installer will guide you when it is time to configure the database.

Please review these instructions before beginning the installation.

[edit] Starting the Installer (Windows)

  1. Download the zip file from the location listed at the bottom of this page.
  2. Extract the zip file (Do not extract on Desktop or into a folder with a space in its name).
  3. Locate startInstaller.bat in the extracted folder and run this batch file from a command prompt or by clicking on it in Windows Explorer.
  4. This will start the Tomcat, as well as open a browser window. If the browser window does not start automatically, open http://localhost:7070/
  5. Skip to section Installing and configuring Project.net.

Note: Tomcat will be running on Port 7070; please make sure this port is not used by another program.

[edit] Starting the Installer (Linux)

  1. Download the zip file from the location listed at the bottom of this page.
  2. Extract the zip file (Do not extract into a folder with a space in its name).
  3. Locate startInstaller.sh in the extracted folder and run this script file from a Bash shell.
  4. This will start the Tomcat, as well as open a browser window. If the browser window does not start automatically, open http://localhost:7070/
  5. Continue with the section Installing and configuring Project.net.

Note: Tomcat will be running on Port 7070; please make sure this port is not used by another program.

[edit] Installing and Configuring Project.net

Note: Make sure to complete Steps 8 and 9 of these instructions after you log into your Project.net server for the first time.

[edit] A License Agreement

Image:License Agreement.png

[edit] B Registration

Image:Registration.png

[edit] Step 1:- Basic Setup

Configuring the jars files required to run the Application

Image:Basic Setup.png

[edit] Step 2:- Database Setup

Configuring the Database Properties to be used by application when it will run

In the Database setup Screen the installer prompts you to enter the necessary details like database hostname, database name, Oracle Oradata path (e.g. C:\oracle\product\10.2.0\oradata or /home/oracle/oracle/product/10.2.0/oradata), plus, the database system user name and password.

First, the installer will ask for the database. If it is already present select “Yes” option, otherwise you can use the link to create a database.

Image:Database Setup 1.png

Step 2:- Database Setup (Continued…)

Image:Database Setup 2.png

Step 2:- Database Setup (Continued…)

Showing error message if invalid configuration

Image:Database Setup 3.png

Step 2:- Database Setup (Continued…)

After entering the necessary details Click on Complete DB setup option, then wait for a moment until the Installer creates the database schema befor running the Project.net application.

A progress bar showing the progress of the database installation

Image:Database Setup 4.png

Image:Database Setup 5.png

[edit] Step 3:- SMTP Setup

Configuring the SMTP Properties to be used by application

In the next screen the installer prompts for the SMTP mail server setup. Please provide your mail server DNS hostname or IP address and its port number (usually port 25). If your mail server requires authentication in order to send mail, please provide the user name and password Project.net should use when sending mail.

Image:SMTP Setup.png

[edit] Step 4:- Tomcat Setup

After configuring the database and SMTP properties, this step will configure Tomcat by setting the required application settings in context.xml.

Image:Tomcat Setup.png

Note: Please don’t close the browser and make sure the installer exits.

[edit] Step 5:- Restart Tomcat

At this point it is necessary to restart Tomcat, which stopped automatically once the Tomcat setup completed.

Image:Restart Tomcat.png

  • For Windows installations, browse to the Installer folder and find startTomcat.bat and run this batch file from a command prompt or Windows Explorer.
  • For Linux installations, browse to the Installer folder and find startTomcat.sh and run this script file from the bash.

[edit] Step 6:- Test Configuration

This step will check configuration done so far, if found error will show the appropriate message and ask to setup the settings again. In the browser click “Complete the Tomcat setup” and the installer will prompt you to test the DB and SMTP settings to ensure that the Project.net application is setup completely.

Note: If the Setup fails please start the installer from scratch.

Image:Test Configuration 1.png

Step 6:- Test Configuration (Continued…)

Image:Test Configuration 2.png

Step 6:- Test Configuration (Continued…)

After testing both configurations you will see a [Finish Installation] button.

Image:Test Configuration 3.png

[edit] Step 7:- Login to Project.net

You will see an installation complete message and Tomcat will stop. Restart Tomcat, as before, and click on [Login to Application].

Note: On this page you can find a link to a wiki page resource, which will be opened in a separate browser window tab, listing additional steps to configure project.net application on you local machine. Click on this link to see what additional tuning should be done. (steps described in section 8 of this wiki page)

Image:Login to Project 1.gif

Now you can see the Login Page of Project.net

Default administrator Username:- appadmin ; password:- appadmin

Image:Login to Project 2.png

[edit] Step 8:- Configure System Settings

Now that Project.net is up and running you need to configure a few details to match your environment, like setting the application administrator user account, checking Project.net's internal system settings and installing the license.

  • The Master License Properties and License Key files for Open Source installations are available from the Downloads page.

[edit] Step 9:- Your First Users and Projects

That's it, Project.net 9.1 is ready to go. Your next step is to create a regular user account for yourself by registering from the login page using the license key you installed above. With this user you can create businesses and projects, invite other users to those projects, and begin to explore the functionality of Project.net. Tutorials, training guides and documentation are available from the Using Project.net page.

[edit] More Help

Personal tools