Step-by-step Install Guide for Windows XP (x86)

Install & Configure Apache

Download and install the newest Apache from here.
Enable Apache modules
- Edit httpd.conf and uncomment the following line:

LoadModule rewrite_module modules/mod_rewrite.so

LoadModule dav_module modules/mod_dav.so
LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule dav_lock_module modules/mod_dav_lock.so

LoadModule ldap_module modules/mod_ldap.so
LoadModule authnz_ldap_module modules/mod_authnz_ldap.so

Include conf/extra/httpd-vhosts.conf
Include conf/extra/httpd-dav.conf

Create the virtual site
- Edit httpd-vhost.conf, add two virtual hosts.

NameVirtualHost *:80
<VirtualHost *:80>
   ServerAdmin chao.zhou@utt.fr
   DocumentRoot "C:/wwwroot/argos.local.hypertopic.org"
   ServerName argos.local.hypertopic.org
   <Directory "C:/wwwroot/argos.local.hypertopic.org">
     Options Indexes FollowSymLinks
     AllowOverride All
     Order allow,deny
     Allow from all
   </Directory>
 
#   <Location /actor/>
#	   AuthType Basic
#	   AuthName LDAP
#	   AuthBasicProvider ldap
#	   AuthzLDAPAuthoritative off
#	   AuthLDAPURL ldap://ldap.local.hypertopic.org:10389/ou=system?cn
#	   AuthLDAPBindDN "uid=admin,ou=system"
#	   AuthLDAPBindPassword "secret"
#	   require valid-user
#   </Location>
   AllowEncodedSlashes On
   ErrorLog "logs/argos.local.hypertopic.org-error.log"
   CustomLog "logs/argos.local.hypertopic.org-access.log" common
</VirtualHost>
 
<VirtualHost *:80>
   ServerAdmin chao.zhou@utt.fr
   DocumentRoot "C:/wwwroot/agorae.local.hypertopic.org/public"
   ServerName agorae.local.hypertopic.org
   <Directory "C:/wwwroot/agorae.local.hypertopic.org/public">
     Options Indexes FollowSymLinks
     AllowOverride All
     Order allow,deny
     Allow from all
   </Directory>
   ErrorLog "logs/agorae.local.hypertopic.org-error.log"
   CustomLog "logs/agorae.local.hypertopic.org-access.log" common
</VirtualHost>

- Edit httpd-dav.conf and delete following content:

Alias /uploads "C:/Apache2.2/uploads"
   
<Directory "C:/Apache2.2/uploads">
...
</Directory>

Create Directory for those virtual hosts.
Checkout source codes from the sourceforge svn server.

SVN co https://argos-viewpoint.svn.sourceforge.net/svnroot/argos-viewpoint/trunk foldername
SVN co https://agorae.svn.sourceforge.net/svnroot/agorae/trunk foldername

Map the localhost IP to the virtual hosts (edit hosts)

notepad C:\WINDOWS\system32\drivers\etc\hosts

Add following codes:

127.0.0.1       argos.local.hypertopic.org
127.0.0.1       agorae.local.hypertopic.org
127.0.0.1       ldap.local.hypertopic.org

install & configure PHP

Extract the PHP package to a directory of your choice (e.g. c:\php-5.2.8)
Add your PHP directory, C:\php-5.2.8 to the PATH environment variable.
Copy php.ini-recommended (in your PHP directory) to php.ini
Edit php.ini and add following content to your php.ini

error_log = c:\php-5.2.8\error.log

Uncomment the following contents

extension=php_pdo.dll
extension=php_pdo_oci.dll
extension=php_ldap.dll

Edit Apache configure file "httpd.conf" and add following content:

LoadModule php5_module "C:/php-5.2.8/php5apache2_2.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php-5.2.8"

Install Apache Directory Server

Download and install Eclipse 3.4.1
Download and install Apache Directory Server 1.5

Manager LDAP Server

Install Apache Directory Studio

You can download Apache Directory Studio 1.3.0 as a standalone RCP application: Apache Directory Studio

Or you can install it directly in Eclipse using this update site: http://directory.apache.org/studio/update/1.x/

Creating a connection to the DS server

Hostname: The hostname or IP address of the LDAP server.

Port: The default port for openLDAP is 389, for Apache Directory Server is 10389.

Input the default bind DN (uid=admin,ou=system) and default password ("secret")

There is also a Ldap Browser alternative. You can download and install from Jxplorer.

Create Users and Groups on LDAP

Users:

dn: cn=eric.ramberg,ou=users,ou=system
objectClass: organizationalPerson
objectClass: person
objectClass: inetOrgPerson
objectClass: simpleSecurityObject
objectClass: top
cn: eric.ramberg
sn: Ramberg

dn: cn=auguste.laporte,ou=users,ou=system
objectClass: organizationalPerson
objectClass: person
objectClass: inetOrgPerson
objectClass: simpleSecurityObject
objectClass: top
cn: auguste.laporte
sn: Laporte

dn: cn=jean.claude.ranquin,ou=users,ou=system
objectClass: organizationalPerson
objectClass: person
objectClass: inetOrgPerson
objectClass: simpleSecurityObject
objectClass: top
cn: jean.claude.ranquin
sn: Ranquin

Groups:

dn: ou=groups,ou=system
objectClass: organizationalUnit
objectClass: top
ou: groups

dn: cn=qualite,ou=groups,ou=system
objectClass: groupOfNames
objectClass: top
cn: qualite
member: cn=eric.ramberg,ou=system

dn: cn=achats,ou=groups,ou=system
objectClass: groupOfNames
objectClass: top
cn: achats
member: cn=jean.claude.ranquin,ou=system

dn: cn=etudes,ou=groups,ou=system
objectClass: groupOfNames
objectClass: top
cn: etudes
member: cn=auguste.laporte,ou=system

Configure Oracle

Create Database Administrator

- Open the following URL in your web browse:

https://yourip:1158/em

- Navigate to Serveur->Sécurité->Utilisateurs->[Créer]
- Input the user information:

Nom: argos_dba
Rôles: CONNECT, DBA
Privilèges système:

ADMINISTER RESOURCE MANAGER ALTER ANY INDEX ALTER DATABASE ALTER TABLESPACE ALTER ANY TABLE ALTER USER CREATE USER CREATE ANY INDEX CREATE ANY SEQUENCE CREATE ANY VIEW CREATE ANY TRIGGER CREATE ANY TABLE

- You also will be able to create the dba account by following SQL command:

CREATE USER "ARGOS_DBA" PROFILE "DEFAULT" IDENTIFIED BY "*******" ACCOUNT UNLOCK;
GRANT ADMINISTER DATABASE TRIGGER TO "ARGOS_DBA";
GRANT ALTER ANY INDEX TO "ARGOS_DBA";
GRANT ALTER ANY TABLE TO "ARGOS_DBA";
GRANT ALTER DATABASE TO "ARGOS_DBA";
GRANT ALTER TABLESPACE TO "ARGOS_DBA";
GRANT ALTER USER TO "ARGOS_DBA";
GRANT CREATE ANY INDEX TO "ARGOS_DBA";
GRANT CREATE ANY SEQUENCE TO "ARGOS_DBA";
GRANT CREATE ANY TABLE TO "ARGOS_DBA";
GRANT CREATE ANY TRIGGER TO "ARGOS_DBA";
GRANT CREATE ANY VIEW TO "ARGOS_DBA";
GRANT CREATE USER TO "ARGOS_DBA";
GRANT "CONNECT" TO "ARGOS_DBA";
GRANT "DBA" TO "ARGOS_DBA";
GRANT "RESOURCE" TO "ARGOS_DBA";

Configure Argos

Run the Argos installation script by accessing install/index.php in your favorite web browser.

If you installed Argos in the root directory, you should visit: http://example.com/install/index.php
If you installed Argos in its own subdirectory called myargos, for example, you should visit: http://example.com/myargos/install/index.php

Screenshot
Step 1. Configure Database Setting	Step 2. Create Read Only User for Database	Step 3. Configure Argos Misc Parameters

IMPORTANT! After installation is complete remove install/ subdirectory in your Argos script directory.

Configure Agorae

The Agorae includes a directory named agorae.example.com in the public/conf direcotry, please copy this directory and rename it as your domain name.

copy agorae.example.com/config.xml yourdomain.com/config.xml

Edit the config.xml with your favorite text editor.

<?xml version="1.0" encoding="UTF-8"?>
<configdata>
        <!-- application base url is your agorae web location. //-->
        <application_base_url>http://agorae.example.com</application_base_url>
        <application_title>Agorae Example</application_title>
        <!-- application main actor you can specified an actor to filter the viewpoint list//-->
        <application_main_actor>mainActor</application_main_actor>
        <!-- List of hypertopic server //-->
        <hypertopic_servers>
                <server>http://argos.example.com</server>
        </hypertopic_servers>
        <!-- LDAP Server for authentication//-->
        <ldap>
                <server1>
                        <host>ldap.example.com</host>
                        <baseDn>dc=example,dc=com</baseDn>
                </server1>
        </ldap>
</configdata>

Finish

Now, you should be able visit Agorae by the following address:

http://agorae.local.hypertopic.org

Contents