3. Installing Penrose Server 2.0

For more detailed instructions to install Penrose Server 2.0, see the Penrose Admin's Guide.

3.1. Installing Penrose Virtual Directory

A virtual directory maps information from disparate data sources, such as directory services and databases, into a single location for users to access, while keeping the virtual service lightweight and simple to administer. Penrose Server establishes the virtual directory.

Download the RPMs. There are two packages for Penrose Server, one for the core server and the other for client tools.
Install the packages. For example:
```
rpm -i vd-server-2.0-build#.el5.noarch.rpm vd-client-2.0-build#.el5.noarch.rpm
```
The Penrose Server components are installed in the /opt/vd-server-2.0 and /opt/vd-client-2.0 directories.
Make sure that the proper JDK is configured for Penrose Server to use:
1. Open the vd.conf file with the Penrose Server directory.
```
vim /opt/vd-server-2.0/etc/vd.conf
```
2. Add the JAVA_HOME environment variable, pointing to Sun JDK 1.5.0. For example:
```
JAVA_HOME=/usr/lib/jdk1.5.0_17/
```
3. After editing the vd.conf file, copy it into the host's /etc directory.
```
cp /opt/vd-server-2.0/etc/vd.conf /etc
```

Run a configuration script to reset the server hostname, give the admin username and password, and set the port numbers and other information for the associated LDAP and JMX services. Hitting Enter accepts the defaults in the brackets.

For example:

[root@server bin]# ./vd-config.sh
Configuring VD Server:
----------------------

Hostname [server.example.com]:
Root DN [uid=admin,ou=system]:
Root Password [*****]: secret12
User account [root]:
Group account [root]:

Configuring OpenDS Service:
---------------------------

LDAP Enabled [true]:
LDAP Port [389]:
Secure LDAP Enabled [true]:
Secure LDAP Port [636]:
SSL Certificate Name [server-cert]:
Key Store Type (JKS/PKCS12) [PKCS12]:
Key Store File [config/keystore.p12]:
Key Store PIN File [config/keystore.pin]:


Configuring JMX Service:
------------------------

RMI Port [1099]:
RMI Transport Port [40888]:

3.2. Installing Penrose Studio

Red Hat Penrose Studio is a simple user interface for administering entries, mapping, and data sources in Penrose Server, as well as a browser for the virtual directory. Penrose Studio is a client to access Penrose Server and can be installed on different machines, even different platforms, than Penrose Server itself.

3.2.1. On Red Hat Enterprise Linux

Download the RPM.

Install the packages. For example:

rpm -ivh vd-studio-2.0-build#.el5.i386.rpm

Penrose Studio is installed in /opt/vd-studio-2.0 on Red Hat Enterprise Linux systems.

NOTE

The default username and password for Penrose Studio to use to connect to the Penrose Server is uid=admin,ou=system and secret, respectively.

3.2.2. On Windows

Download the Windows installer.
Double-click the .exe file, and go through the installer.

Penrose Studio is installed in C:\Program Files\Identyx Corporation\VD Studio 2.0 on Windows systems.

NOTE

The default username and password for Penrose Studio to use to connect to the Penrose Server is uid=admin,ou=system and secret, respectively.