From b191bd1e83ad0ca152afc3a1c6c7823d9f4e683c Mon Sep 17 00:00:00 2001 From: Sam Pearson Date: Wed, 3 Oct 2018 08:51:49 +0100 Subject: [Docs] Use service command in examples This changes a handful of example commands that restart the fixmystreet application server to use the `service` command rather than the script in `/etc/init.d`. This should be compatible with systems using either of `systemd` or `sysvinit`. [skip ci] --- docs/install/database.md | 7 ++++--- docs/install/troubleshooting.md | 18 ++++++++---------- 2 files changed, 12 insertions(+), 13 deletions(-) (limited to 'docs/install') diff --git a/docs/install/database.md b/docs/install/database.md index f282c8985..5b5ffa19f 100644 --- a/docs/install/database.md +++ b/docs/install/database.md @@ -12,14 +12,15 @@ title: Database troubleshooting At this point you might need to configure PostgreSQL to allow password-based access to the `fms` database as the user `fms` from using Unix-domain sockets. -Edit the file `/etc/postgresql/8.4/main/pg_hba.conf` and add as the -first line: +Edit the file `/etc/postgresql/9.6/main/pg_hba.conf` (note that the version +number in this path will vary depending on the version of Debian you are +using) and add as the first line: local fms fms md5 You will then need to restart PostgreSQL with: - $ sudo /etc/init.d/postgresql restart + $ sudo service postgresql restart If you want to access the database from the command line, you can add the following line to `~/.pgpass`: diff --git a/docs/install/troubleshooting.md b/docs/install/troubleshooting.md index b006d18a4..fdae90a07 100644 --- a/docs/install/troubleshooting.md +++ b/docs/install/troubleshooting.md @@ -6,12 +6,12 @@ title: Installation troubleshooting # Installation troubleshooting

- If you've installed FixMyStreet using an automated method such as the + If you've installed FixMyStreet using an automated method such as the installation script - or the + or the AMI, you should be good to go. - However, if you've done a - manual install, + However, if you've done a + manual install, sometimes you might bump into a problem if your system is different from what FixMyStreet expects. These hints might help.

@@ -31,7 +31,7 @@ title: Installation troubleshooting ### locale: must be installed -By default, FixMyStreet uses the `en_GB.UTF-8` +By default, FixMyStreet uses the `en_GB.UTF-8` locale. If it is not installed then it may not start. You need this locale on your system even if you're planning on running your site in a different language. @@ -48,7 +48,7 @@ Check to see what locales your system currently supports with: ### Template caching -FixMyStreet caches compiled +FixMyStreet caches compiled templates alongside the source files, so the `templates/web/` directory needs to be writable by the process that is running FixMyStreet. @@ -101,7 +101,7 @@ There are YAML lint tools available for checking the well-formedness of YAML fil Remember that your config settings may include sensitive information (your database password, for example) so be sensible before using online validators. -Simple things to be wary of: always quote strings that themselves contain a colon, +Simple things to be wary of: always quote strings that themselves contain a colon, be sure to close any open quotes, and avoid using tabs. @@ -113,6 +113,4 @@ is running, you may need to restart the process for the change to take effect. For example, restart the Catalyst FastCGI server with: -
sudo /etc/init.d/fixmystreet restart
-
- + $ sudo service fixmystreet restart -- cgit v1.2.3