db/explain.depesz.com
1
0
Fork 0
mirror of https://gitlab.com/depesz/explain.depesz.com.git synced 2024-11-30 09:06:42 +02:00
Code
Webpage for showing easier to read version of PostgreSQL explains
88 Commits 2 Branches 0 Tags 938 KiB
Perl 38%
CSS 22.8%
PLpgSQL 22.2%
JavaScript 9.6%
Shell 3.1%
Other 4.3%
cd980e2c24
Go to file
John Poole cd980e2c24 Update README.md 
Further instructions
2014-10-31 06:00:30 -07:00
layout new version of explain.depesz.com, by metys - llewandowski.pl 2011-03-10 15:19:34 +00:00
lib perltidy run 2013-10-30 12:47:28 +01:00
public update user history layout 2013-10-30 12:45:03 +01:00
sql Users almost done 2013-10-29 14:35:04 +01:00
t Test syntax change in new mojo 2013-05-14 19:43:16 +02:00
templates update user history layout 2013-10-30 12:45:03 +01:00
explain.json Users almost done 2013-10-29 14:35:04 +01:00
explain.pl Apparently new Mojo changed the way app is started 2013-05-14 19:24:58 +02:00
hypnotoad.conf make the config for production 2011-03-15 10:59:46 +00:00
LICENSE missing license 2014-06-05 15:05:09 +02:00
README.md Update README.md 2014-10-31 06:00:30 -07:00

README.md

explain.depesz.com

Setup

  1. Mojolicious

You have to have Mojolicious installed on your server. Mojolicious is a web framework for Perl. http://mojolicio.us/

Installation can be accomplished with one command line:

curl -L cpanmin.us | perl - -n Mojolicious

See the "Installation" section at http://mojolicio.us/ for details.

  1. Perl Dependencies: You will need the following packages installed in your version of Perl:

    DBD::Pg Date::Simple Mail::Sender Pg::Explain Email::Valid

Install the above packages using "cpan" then "i Date::Simple", "i Maill::Sender" &etc.

  1. PostgreSQL

A) Create a new database "explain". This will be were the explain server will store the "users" and "plans" tables in the default schema "public".

B) Run SQL scripts. Log into postgres as postgres. Switch to the "explain" database.
Execute the SQL scripts located in the "sql" directory in the following order:

\i create.sql
\i patch-001.sql
\i patch-002.sql

The "create.sql" will create tables in the explain database "public" schema, i.e. "plans" and "users".

B) Create a user role. I use "explaind" [explain daemon] and remember to provides it a password and then configure the explain.json file to reflect this new role and password.

C) Grant all rights to the tables in "explain" to your role "explaind":

 grant all on plans, users to explaind;

D) modify /etc/postgresql-9.3/pg_hba.conf so that it has the server as "127.0.0.1"

local   all             all             127.0.0.1               trust

If you do not want to alter /etc/postgresql-9.3/pg_hba.conf, then you might be able to modify the explain.json.dsn setting to specify the name of the value i n the server column from your /etc/postgresql-9.3/pg_hba.conf file, e.g. "localhost". This alternative approach has not been tested. It would be desirable to install this project with the minimal amount of configuration changes, so I encourage someone to come up with a solution that removes this step "D".

  1. Alter configuration file explain.json making sure you have the correct values for your database connection. See companion documentation file explain-json-notes.txt

  2. Shell

The explain server runs on port 3000. Make sure port 3000 is available and not in use by another process. You may have to specify a different port, e.g. 3200. I do not know where you do that, probably in Mojolicious.

In the trunk directory for this project, run in a shell:

 ./explain daemon

Then access the web page http://localhost:3000

  1. when you access the web page, remember to login and create an account for yourself so that your explain plans will be associated with your account.