• Installation Guide for ChecksumPillar

• Installation Guide for the ReferencePillar

• Installation Guide for a Non-Reference Pillar

For the ChecksumPillar to be able to run, the following is required on the machine, before installation:

• Requires Java v. 8 (can be either Oracle or OpenJDK)

• Requires installation of PostgreSQL.

• Requires open firewall to the ActiveMQ of the setup.

For configuring the ChecksumPillar to be able to participate in a repository-setup, the following is required:

• A certificate in pem
  
  

  • Can either be created locally (see Create self signed certificate) or delivered from those who administers the central Repository.

  • This certificate must be registered at the ActiveMQ, so the pillar can use it for communication.

• The pillar ID for the ChecksumPillar

• ReferenceSettings.xml

  • Can be downloaded at https://github.com/bitrepository/reference/raw/bitrepository-parent-1.6/bitrepository-integration/src/main/resources/quickstart/conf/checksumpillar/ReferenceSettings.xml.

  • See configuration.

• RepositorySettings.xml

  • Must contain a Permission section with the certificate, and at least one Collection containing the PillarID.

  • This file must also be distributed to all other component (services, client and other pillars) in its newest form.

Download the software for the ChecksumPillar:
> wget http://sbforge.org/nexus/content/repositories/releases/org/bitrepository/reference/bitrepository-reference-pillar/1.6/bitrepository-reference-pillar-1.6-distribution.tar.gz

Unpack the package:
> tar xvf bitrepository-reference-pillar-1.6-distribution.tar.gz

Start in the root of the installation directory, and run the following through a terminal:

> createuser -P -s -e bitmag
(write 'bitmag' for both username and password)
> createdb checksumdb
> createdb auditdb
> psql -d checksumdb -f sql/postgres/checksumDBCreation.sql
> psql -d auditdb -f sql/postgres/auditContributorDBCreation.sql

Place the RepositorySettings.xml, the ReferenceSettings.xml and the certificate in the 'conf' directory.

Change the following in the ReferenceSettings (The dots means parts of the ReferenceSettings, which you can ignore):

<ReferenceSettings xmlns="http://bitrepository.org/settings/ReferenceSettings.xsd">
...
  <PillarSettings>
    <PillarID>YOUR_PILLAR_ID</PillarID>
    <PillarType>CHECKSUM</PillarType>
...
    <AuditTrailContributerDatabase>
      <DriverClass>org.postgresql.Driver</DriverClass>
      <DatabaseURL>jdbc:postgresql:auditdb</DatabaseURL>
      <Username>bitmag</Username>
      <Password>bitmag</Password>
    </AuditTrailContributerDatabase
    <ChecksumDatabase>
      <DriverClass>org.postgresql.Driver</DriverClass>
      <DatabaseURL>jdbc:postgresql:checksumdb</DatabaseURL>
      <Username>bitmag</Username>
      <Password>bitmag</Password>
    </ChecksumDatabase>
...
  </PillarSettings>
</ReferenceSettings>

Change the path to the certificate in the bitmag.sh file in the 'bin' folder.