Thank you for your interest in percerons!

Percerons is a client-server application that requires two components in order to run properly (provided in the same download file - see below):
Percerons Client: This application is responsible for performing the static analysis and store results in a local database
Percerons Server: This application is retrieving the results of static analysis from the local database, synthesizes them, and visualizes them through your web browser, as you see them in this website! Note that the analyzed OSS projects are not available in the local percerons version, since this is intended to serve for your personal Java projects analysis.

Please have in mind that percerons is an actively developed project that is continuously updated! In order to ensure that you are up-to-date, visit this website and check for updates regularly!

When using percerons.com for research reasons, please refer to it by using the url of this website and one of the original works that introduced this website original research efforts

Prerequisites

-    Apache Server for vizualizing the results (proposed XAMPP)
-    SQL DB for storing data (proposed mySQL, bulit-in in XAMPP installation)
-    JRE 1.7 or previous , to check your java version type: java -version in a command line window

Installation Instructions

1. start Apache Server and mySQL (please note that in order to start Apache, you might need to exit Skype and open it again when the Apache service is running)
2. visit the mySQL admin page, by visiting: localhost/phpmyadmin in a web browser
3. create a new db schema, named depre
4. install Percerons_Client from the provided download file
5. extract the Percerons_Server folder from the provided download file into the local folder of xampp instalation. Usually C:\xampp\htdocs\ , this would lead in the creation of a folder named C:\xampp\htdocs\percerons.com

Execution Instructions

1. Client-Side
i. right-click the PerceronsClient icon, and select Run as Adminstrator ,
ii. set your preferred settings (for first time usage only - use the Settings option on the top menu):
   (a) url: localhost,
   (b) username: root,
   (c) password: (blank, unless you have changed it)
   (d) java path: (you need to add the ./bin folder of your jre instalation - version earlier than 1.8),
   (e) memory: (especially if you are interested to perform design pattern detection),
iii. create application domain. In case of OSS project analysis you are encouraged to use the actual domain, in case you are analysing company data, you are encouraged to use the name of your company (this will help in the visualization step in the server side),
iv. create application sub-domains,
v. select the source folder directory or the url from where it can be downloaded in the url fieldset,
vi. select the jar file,
vii. indicate if you want to perform design pattern instance detection,
viii. perform static analysis Perform Static Analysis ,
ix. store results in the DB Store Results.
**Note: If you want to use upper-case and lower-case letters in the names of domains and sub-domains you must edit your my.ini file inside C:/xampp/mysql, and add the line lower_case_table_names=2.

2. Server-Side
i. open your web browser and visit localhost/phpmyadmin/www.percerons.com/
ii. be sure that you have analyzed at least two projects from each application domain
iii. browse the local website, as you have already done with the online one
iv. for detailed instructions of usage see here .