Installation Guide Install Projectivity

From Projectivity Documentation
Jump to: navigation, search
Go back to Installation Guide main section

Contents

Install Projectivity

Installing Projectivity (that bundles JBoss Application Server) is simple as unpacking the archive in the desired directory.

Suggested directories (configuration files are set by default to suggested directories)

  • On Linux: /opt/projectivity-3.0
  • On Windows: C:\projectivity-3.0

Edit the file

projectivity-3.0/bin/run.conf

Make sure to set the JAVA_HOME variable to suit you system configuration.

Make the scripts executable (Linux only)

on Linux
[root@py root]# chmod +x /opt/projectivity-3.0/utils/*.sh
[root@py root]# chmod +x /opt/projectivity-3.0/bin/*.sh

Create the Projectivity DB

Once PostgreSQL is installed and configured you can create the DB used by Projectivity.

NOTE: Projectivity ships with PostgresSQL 8 jdbc driver. In order to use it with PostgresSQL 9.x you need to update the driver shipped with Projectivity. Follow this link for more information.

You create the pydb data base using psql command and create_pydb.sql sql script shipped with Projectivity download archive (you find it under install directory) as follows:

on Linux
[root@py root]# cd /opt/projectivity-3.0/utils/install
[root@py install]# psql -h 127.0.0.1 -U postgres < create_pydb.sql
on Windows
..> cd c:\projectivity-3.0\utils\install
[root@py install]# psql -h 127.0.0.1 -U postgres < create_pydb.sql

The sql script used to create the DB, also creates the user projectivity with default password projectivity. You might want to update the password for security needs.

To change the password of the data base projectivity user proceed as follows:

[root@py root]# psql -h 127.0.0.1 -U postgres pydb              <-- replace the ip accordingly
you will be prompted for the postgres password
pydb=> ALTER ROLE projectivity WITH PASSWORD 'password';

If you update the password, make sure to update it in the file:

projectivity-3.0/server/projectivity/deploy/projectivity-postgres-ds.xml

Create the Projectivity Repository

Projectivity holds documents in a Subversion repository. Subversion is a Version Control System. Visit the Subversion Web Site for more information.

In this step we will create a document repository that will hold the documents managed by Projectivity. In order to do this we will use (SVNKit) a Subversion Java implementation.

Please refer to Choose the deployment architecture section if you plan to store documents in a different host than Projectivity.

When choosing the directory that will hold the repository data, take into the disk space requirements. Documents repositories tend to require significant disk space.

Default repository directory are:

  • On Linux: /opt/projectivity-3.0/documents-repo
  • On Windows: C:\projectivity-3.0\documents-repo

Make sure that the directory is writeable by the system user that runs Projectivity.

on Linux
[root@py root]# cd /opt/projectivity-3.0/utils
[root@py utils]# java -cp lib/svnkit.jar:lib/svnkit-cli.jar org.tmatesoft.svn.cli.SVNAdmin create /opt/projectivity-3.0/documents-repo

on Windows
..> cd C:\projectivity-3.0\utils
..> java -cp lib\svnkit.jar;lib\svnkit-cli.jar org.tmatesoft.svn.cli.SVNAdmin create C:\projectivity-3.0\documents-repo

Edit the file documents-repo/conf/svnserve.conf as follows:

[general]
anon-access = none
auth-access = write
password-db = passwd
realm = Projectivity Repository

Edit the file documents-repo/conf/passwd as follows:

[users]
projectivity = projectivity   <-- this is the password to access the repository.

Set Projectivity Properties

Edit the file:

projectivity-3.0/server/projectivity/deploy/projectivity-properties-service.xml

And set the properties to suit your needs. Configurations examples (for both Linux and Windows) are in the file.

NOTE: since the default values are valid for Windows only, for Linux you need to edit the file. Instructions are in the file.

NOTE: for Windows style path you need to double the back slashes. For instance C:\\projectivity-3.0\\email_templates

Initialize Projectivity

Now it is the time to initialize Projectivity. This step creates the admin account (with password adminadmin) and a basic Framework (Generic Framework).

If you plan to install a Framework bundle you can skip this section and refer to the Framework bundle documentation.

on Linux
[root@py root]# cd /opt/projectivity-3.0/bin
[root@py utils]# ./run.sh -c projectivity -b 127.0.0.1

on Windows
..> cd C:\projectivity-3.0\bin
..> run.bat -c projectivity -b 127.0.0.1

NOTE: Projectivity is a server that runs forever thus the command console (Command Prompt on Windows and Terminal on Linux) you used to run it will be busy until you stop it. In order to run the initializer script you'll need to open a new console. You can also run Projectivity as a service (refer to Run Projectivity as a Service for more information)

Wait a couple of minutes to have the system started (when you'll be able to display the login page) and run the initializer script.

Now run (in a new terminal) the initializer command.

on Linux
[root@py root]# cd /opt/projectivity-3.0/utils
[root@py utils]# ./initializer.sh file:///opt/projectivity-3.0/documents-repo projectivity projectivity

on Windows
..> cd C:\projectivity-3.0\utils
..> initializer.bat file:///projectivity-3.0/documents-repo projectivity projectivity

The first argument is the repository URL. The second and third arguments are the repository user and password defined in the file documents-repo/conf/passwd

You should see the following output:

Connected to Projectivity.
System Initialized.

You can now login Projectivity:

URL: http://127.0.0.1:8080/py/secure/projectivity.iface
id: admin
password: adminadmin

You can check the log files for any problems:

projectivity-3.0/server/projectivity/log/projectivity.log

Personal tools
Downloads
Other Resources