Useful PostgreSQL commands

Check whether PostgreSQL is running

Type: ps -ef | grep postgres

If PostgresSQL is running, you see multiple lines of output. If it is not running, you see nothing.

Access the Reports database on the primary server

• docker exec -it rpd-reports-postgres psql -U PostgreSQL_user_name -d database

  or

• podman exec -it rpd-reports-postgres psql -U PostgreSQL_user_name -d database

For example, if you use the default values for Database and User name on the Database settings page, enter:

• docker exec -it rpd-reports-postgres psql -U rpdreports -d history

  or

• podman exec -it rpd-reports-postgres psql -U rpdreports -d history

Expected output:

After accessing the Reports database

Use these commands to retrieve information about the database, database tables, and contents:

\d

List the database tables that exist on the system.

\dt rpt.*

List the databases on the system that are in the rpt schema. Any databases that you migrate from the DB2 database that older versions of the Reports fieature used to save data are in this schema.

\d+ database_table_name

Show the format of the specified table. For example, \d+ job_history shows that format of the job_history database table.

select * from database_table_name;

List all data from the specified table.

select column_name[,column_name2,column_name3,...] from job_history;

List the data from the specified columns in the requested table.

COPY database_table_name TO 'directory_path_and_filename' DELIMITER ',' CSV HEADER;

Write data stored in the database to a CSV file.

For database_table_name, type the name of the PostgreSQL database table that you defined as the value of the Database table name property in the data collector.

For directory_path_and_filename, type the full directory path and name of the CSV that you want to capture the data to.

This example captures data in the job_history table and exports it in CSV format to the test.csv file in the /aiw/aiw1 directory:

COPY job_history TO '/aiw/aiw1/test.csv' DELIMITER ',' CSV HEADER;

\q

Exit PostgreSQL.

Stop the Reports database

Open a command prompt and type this command:

• docker stop rpd-reports-postgres

  or

• podman stop rpd-reports-postgres

  or

• pg_ctl stop -o "-p portnumber" -U rpdreports

  Where and portnumber is the port that RICOH ProcessDirector uses to access the Reports database.

  or

• /usr/pgsql-version/bin/pg_ctl stop -o "-p portnumber" -U rpdreports -P testpassword -D /aiw/aiw1/data/ -l /aiw/aiw1/trace/postrgres.trace

  Where version is the installed version of PostgreSQL, rpdreports and testpassword are the name and password for the PostgreSQL user, and portnumber is the port that RICOH ProcessDirector uses to access the Reports database.

Start the Reports database

• docker start rpd-reports-postgres

  or

• podman start rpd-reports-postgres

  or

• pg_ctl start -o "-p portnumber" -U rpdreports

  Where rpdreports is the user name of the PostgreSQL user and portnumber is the port that RICOH ProcessDirector uses to access the Reports database.

  or

• /usr/pgsql-version/bin/pg_ctl start -o "-p portnumber" -U rpdreports -P testpassword -D /aiw/aiw1/data/ -l /aiw/aiw1/trace/postrgres.trace

  Where version is the installed version of PostgreSQL, rpdreports and testpassword are the name and password for the PostgreSQL user and portnumber is the port that RICOH ProcessDirector uses to access the Reports database.