<commit_before># Php-Server-Mon-Sys
#### Why _Php-Server-Mon-Sys_?
Let's say you manage some websites or other network servers, and you wish to monitor them.  You decide it's time to install and operate a _Server Monitor_ to help with that task.  There are quite a number of _server monitors_ available from which to choose.  At this time you choose a basic, easy-to-use server monitor named _PHP Server Monitor_:

- http://phpservermonitor.org/

- http://www.phpservermonitor.org/support/

- https://github.com/phpservermon/phpservermon

However, you _may_ now have an unanticipated problem, a problem common to many _server monitors_.  The problem is, because _PHP Server Monitor_ depends upon several services which may not already be installed on your host computer, installation may be very complicated and time consuming.

_Php-Server-Mon-Sys_ solves this problem.  In many cases, _Php-Server-Mon-Sys_ makes installation of _PHP Server Monitor_ much faster and simpler.

#### What is complicated about _PHP Server Monitor_ installation?
_PHP Server Monitor_ installation itself is not very complicated.  But, _PHP Server Monitor_ depends upon the services of an HTTP server, a MySQL server, and a PHP-FPM server.  What if those services are not already installed?  Unless installation of _PHP Server Monitor_ is performed by a qualified system administrator, installing those services is often time consuming and error-prone.

#### _Php-Server-Mon-Sys_ Is A _Turnkey_ System
_Php-Server-Mon-Sys_ significantly reduces the complexity of _PHP Server Monitor_ installation, on host computers which do not already have the required support services installed.

In addition to installing _PHP Server Monitor_, _Php-Server-Mon-Sys_ installs NGINX, MySQL, and PHP-FPM.  These are "private" services which are available only to _PHP Server Monitor_.  These services are not installed directly into the host operating system per usual.  The services are deployed using _Docker_ containers, which means these services may be very easily and cleanly installed and un-installed along with the _PHP Server Monitor_ application software.  Backing up and restoring are also quick and uncomplicated.

When you no longer need the _PHP Server Monitor_ software in your system, you may very easily remove it.  When it is removed, _PHP Server Monitor's_ supporting services are removed as well.  There is no need to individually remove each of the other services no longer needed.

Keep in mind that the NGINX, MySQL, and PHP-FPM services which are installed by _Php-Server-Mon-Sys_ are available only to _PHP Server Monitor_; they are not intended to be available to other application software on the host system.  The services are _ephemeral_; they come and go along with the installation, operation, and un-installation of _Php-Server-Mon-Sys_.

The version of _PHP Server Monitor_ incorporated into this release of _Php-Server-Mon-Sys_ is _PHP Server Monitor v3.1.1_.

This version of _Php-Server-Mon-Sys_, _v0.0.7_, has been tested only on a host using _Ubuntu 14.04_.  _Php-Server-Mon-Sys_ has not yet been tested on _OS X_ nor _Windows_.  Theoretically, _Php-Server-Mon-Sys_ should work on any host which fully supports _Docker_ tools, but that has not yet been tested.

### System Requirements
Installation and operation of _Php-Server-Mon-Sys_ requires:

  - 200MB available memory
  - 1.1GB available storage, (plus server history data accumulated in database)
  - Internet connection/service
  - Docker Engine 1.7, pre-installed
  - Docker Compose 1.3.1, pre-installed

### _Php-Server-Mon-Sys_ Installation Instructions
- Download the _v0.0.7_ release tar.gz or .zip file into a convenient newly created directory, which will be used as the _Php-Server-Mon-Sys_ "Home" directory. Untar/unzip the release file, (keep the directory structure).

  - https://github.com/addiscent/php-server-mon-sys/releases/tag/v0.0.7

- Execute the following commands:

  - $ ./build-psms.sh  # execute this BASH script from the "Home" directory

  - $ docker-compose up -d  # wait two minutes for mysql to finish initializing database

  IMPORTANT: You must wait, (approximately two minutes), for MySQL to finish initializing its database before continuing with _PHP Server Monitor_ Initialization instructions below.  Otherwise, you will be shown errors during the _PHP Server Monitor_ Initialization process.  If an error is shown stating, "Unable to connect to MySQL. Please check your information", then wait a few minutes, and retry _PHP Server Monitor_ Initialization.

The default _PHP Server Monitor_ _Time Zone_ is _UTC_.  Leave it as is for now, because you will probably discard the first database created during _PHP Server Monitor_ Initialization.  However, before later creating the database you plan to use "in production", read the section below titled, "The _PHP Server Monitor_ Time Zone".

### _PHP Server Monitor_ Initialization
- After completing the Intallation instructions above, use a web browser to visit:

    * http://localhost:28684

- Read and follow the directions on the first page, then choose _LET'S GO_.

- For each field, enter these values:

    * _Database host_ : _mysqlpsm_

    * _Database name_ : _phpservermon_
<commit_msg>Remove references to specific PSMS releases<commit_after># Php-Server-Mon-Sys
#### Why _Php-Server-Mon-Sys_?
Let's say you manage some websites or other network servers, and you wish to monitor them.  You decide it's time to install and operate a _Server Monitor_ to help with that task.  There are quite a number of _server monitors_ available from which to choose.  At this time you choose a basic, easy-to-use server monitor named _PHP Server Monitor_:

- http://phpservermonitor.org/

- http://www.phpservermonitor.org/support/

- https://github.com/phpservermon/phpservermon

However, you _may_ now have an unanticipated problem, a problem common to many _server monitors_.  The problem is, because _PHP Server Monitor_ depends upon several services which may not already be installed on your host computer, installation may be very complicated and time consuming.

_Php-Server-Mon-Sys_ solves this problem.  In many cases, _Php-Server-Mon-Sys_ makes installation of _PHP Server Monitor_ much faster and simpler.

#### What is complicated about _PHP Server Monitor_ installation?
_PHP Server Monitor_ installation itself is not very complicated.  But, _PHP Server Monitor_ depends upon the services of an HTTP server, a MySQL server, and a PHP-FPM server.  What if those services are not already installed?  Unless installation of _PHP Server Monitor_ is performed by a qualified system administrator, installing those services is often time consuming and error-prone.

#### _Php-Server-Mon-Sys_ Is A _Turnkey_ System
_Php-Server-Mon-Sys_ significantly reduces the complexity of _PHP Server Monitor_ installation, on host computers which do not already have the required support services installed.

In addition to installing _PHP Server Monitor_, _Php-Server-Mon-Sys_ installs NGINX, MySQL, and PHP-FPM.  These are "private" services which are available only to _PHP Server Monitor_.  These services are not installed directly into the host operating system per usual.  The services are deployed using _Docker_ containers, which means these services may be very easily and cleanly installed and un-installed along with the _PHP Server Monitor_ application software.  Backing up and restoring are also quick and uncomplicated.

When you no longer need the _PHP Server Monitor_ software in your system, you may very easily remove it.  When it is removed, _PHP Server Monitor's_ supporting services are removed as well.  There is no need to individually remove each of the other services no longer needed.

Keep in mind that the NGINX, MySQL, and PHP-FPM services which are installed by _Php-Server-Mon-Sys_ are available only to _PHP Server Monitor_; they are not intended to be available to other application software on the host system.  The services are _ephemeral_; they come and go along with the installation, operation, and un-installation of _Php-Server-Mon-Sys_.

The version of _PHP Server Monitor_ incorporated into this release of _Php-Server-Mon-Sys_ is _PHP Server Monitor v3.1.1_.

This version of _Php-Server-Mon-Sys_ has been tested only on a host using _Ubuntu 14.04_.  _Php-Server-Mon-Sys_ has not yet been tested on _OS X_ nor _Windows_.  Theoretically, _Php-Server-Mon-Sys_ should work on any host which fully supports _Docker_ tools, but that has not yet been tested.

### System Requirements
Installation and operation of _Php-Server-Mon-Sys_ requires:

  - 200MB available memory
  - 1.1GB available storage, (plus server history data accumulated in database)
  - Internet connection/service
  - Docker Engine 1.7, pre-installed
  - Docker Compose 1.3.1, pre-installed

### _Php-Server-Mon-Sys_ Installation Instructions
- Download the release tar.gz or .zip file into a convenient newly created directory, which will be used as the _Php-Server-Mon-Sys_ "Home" directory. Untar/unzip the release file, (keep the directory structure).

  - https://github.com/addiscent/php-server-mon-sys/archive/master.zip

- Execute the following commands:

  - $ ./build-psms.sh  # execute this BASH script from the "Home" directory

  - $ docker-compose up -d  # wait two minutes for mysql to finish initializing database

  IMPORTANT: You must wait, (approximately two minutes), for MySQL to finish initializing its database before continuing with _PHP Server Monitor_ Initialization instructions below.  Otherwise, you will be shown errors during the _PHP Server Monitor_ Initialization process.  If an error is shown stating, "Unable to connect to MySQL. Please check your information", then wait a few minutes, and retry _PHP Server Monitor_ Initialization.

The default _PHP Server Monitor_ _Time Zone_ is _UTC_.  Leave it as is for now, because you will probably discard the first database created during _PHP Server Monitor_ Initialization.  However, before later creating the database you plan to use "in production", read the section below titled, "The _PHP Server Monitor_ Time Zone".

### _PHP Server Monitor_ Initialization
- After completing the Intallation instructions above, use a web browser to visit:

    * http://localhost:28684

- Read and follow the directions on the first page, then choose _LET'S GO_.

- For each field, enter these values:

    * _Database host_ : _mysqlpsm_

    * _Database name_ : _phpservermon_

{'fraction_non_alphanumeric': 0.05199504809065803, 'fraction_numerical': 0.005047138367774498, 'mean_word_length': 4.3746161719549645, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 4, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2573899', 'n_tokens_mistral': 2766, 'n_tokens_neox': 2665, 'n_words': 1417}