Document toolboxDocument toolbox

(2024.1) PCR-360

Installation

  • Create application directories under /var/www/

    cd /var/www mkdir pcr360 cd pcr360/ mkdir configs prod licenses prod/logs data data/inbound data/outbound data/inbound-test data/outbound-test



  • Place the product license file pcr360.zl included in the installation package into the licenses directory. (This must be Apache readable)

  • Extract the application tarball pcr360.tar.gz included in the installation package to /var/www/pcr360/prod (the prod directory is in the tarball).

  • Create directories under /var/www/pcr360/prod/data

    cd /var/www/pcr360/prod/data mkdir archive archive/importfiles cache cache/page emails errors inbound reports reports/historical search uploads uploads/importfiles uploads/vh



Check to ensure that the new /var/www/pcr360/prod/data directory is writable and owned by Apache.

######### # Cent OS chown -R apache:apache * ######### # Ubuntu find /var/www/pcr360/prod/data -type d -exec chmod 775 {} + find /var/www/pcr360/test/data -type d -exec chmod 775 {} + chown -R www-data:linuxadmins-hosted /var/www/pcr360/prod/data chown -R www-data:linuxadmins-hosted /var/www/pcr360/test/data chown -R www-data:linuxadmins-hosted /var/www/pcr360/prod/logs chown -R www-data:linuxadmins-hosted /var/www/pcr360/test/logs # set file owners chown -R www-data:linuxadmins-hosted /var/www/pcr360/data # set file permissions find /var/www/pcr360 -type d -exec chmod 775 {} + find /var/www/pcr360 -type f -exec chmod 664 {} + # Grant the customer user read/write access o the data directory # note you mus FILL IN the customer user setfacl -R -m u:<CUSTOMER_USER>:rwx /var/www/pcr360/data setfacl -R -dm u:<CUSTOMER_USER>:rwx /var/www/pcr360/data # Grand the all PCR Admins read/write/execute on the entire pcr360 directory setfacl -R -m g:linuxadmins-hosted:rwx /var/www/pcr360 setfacl -R -dm g:linuxadmins-hosted:rwx /var/www/pcr360

Composer

  • Install Composer. Instructions can be found here. It is recommended that Composer be installed globally.

  • Install the Composer provided libraries:



Configuration

PCR-360 configurations are stored in a ini file in the /var/www/pcr360/configs/ directory created above.

  • This configuration file matches the file name specified in the Apache Virtual Host .

  • A starter file is included in the installation package with a place-holder license key. Please request a license key from PCR to replace the place-holder license in the configuration file.

  • The database settings here are specified when setting up and configuring (2024.1) Oracle or (2024.1) MySQL

  • Other various configurations are available and can be specified in this file. Consult PCR before setting any extra options from the (2024.1) Configuration Guide .



Crontab Entries

  1. Installing the default crontab entries that run background events is relatively simple.

  2. The jobs need to be running as the root to prevent issues with file permissions.

  3. su to root

  4. Now, open the cron job edit prompt with the following command:



  5. Then, copy and paste the appropriate line from below into the the cron job.

Test Application Cron Jobs

Production Application Cron Jobs

  1. Once pasted, save and close the cron job. In vim, this command is



  2. Verify the cron job is saved by using this command:



  3. Finally, press

    to exit the root user.