Page History

...

An installation wizard / script is available to install ProVision locally on Ubuntu 20 or Centos 7supported OSes.

Contact support for assistance and instructions.

...

	Minimum	Recommended
Processor	Dual-core Xeon class processor or equivalent	Quad-core Xeonprocessor
RAM2GB	4GB RAM4GB	8GB RAM
Storage	20 GB	100GB

*Virtual instances are also acceptable. We have confirmed functionality with Citrix Xen Essentials, VMware, KVM, etc.

TODO: REVIEW THIS WITH HILCO LEGAL

Expand

title	VMware Statement of Support

IPv4 Global will support customers who run 6connect ProVision products on supported Operating Systems, irrespective of whether they are running in VMware environments or not. IPv4 Global supports Operating Systems, not specific hardware configurations. Accordingly, VMware operates as a hardware abstraction layer.

VMware supports a set of certified Operating Systems and Hardware, and the customer and VMware will be responsible for any interactions or issues that arise at the Hardware or Operating System layer as a result of their use of VMware.

IPv4 Global will not require clients to recreate and troubleshoot every issue in a non-VMware environment; however, IPv4 Global does reserve the right to request our customers to diagnose certain issues in a native certified Operating System environment, operating without the virtual environment. IPv4 Global Global will only make this request when there is reason to believe that the virtual environment is a contributing factor to the issue.

Any time spent on investigation of problems that may, in the sole opinion of IPv4 Global be related to VMware, will be handled in the following fashion:

1) IPv4 Global will provide standard support to all 6connect ProVision products.

2) If a problem is encountered while 6connect ProVision is/are running in a VMware environment, the client may be required to recreate the problem on a non-VMware server unit, at which time IPv4 Global will provide regular support.

3) The client can authorize IPv4 Global to investigate the VMware related items at normal time and materials rates. If such investigation shows that the problem is VMware related, the client may contract IPv4 Global to provide a software change to resolve the issue if such a resolution is possible.

4) Regardless of the problem type or source, if the problem is determined to be a non VMware related issue - time spent on investigation and resolution will be covered as part of regular maintenance, and support will be provided as usual.

...

	Required	Link
Operating SystemUbuntu 20.04 or Centos 7	See List of Supported OSes
Apache	Apache 2.4	http://httpd.apache.org/
PHP	PHP 8.0 / 8.1	http://php.net/downloads.php
MySQL	MySQL 8.x0	http://www.mysql.com/downloads/

...

Some installations may require SSL support for using database connections like MySQL, MariaDB, Azure, etc.

To create server keys and and allow SSL database connections, expand the instructions below.

...

Expand

title	Enable SSL...

Follow the steps below to enable SSL for database connections:

1) Install MySQL (MariaDB)

2) Generate, process, and sign server keys:

Code Block

language	bash

openssl genrsa 2048 > ca-key.pem
openssl req -new -x509 -nodes -days 365000 -key ca-key.pem -out ca-cert.pem
openssl req -newkey rsa:2048 -days 365000 -nodes -keyout server-key.pem -out server-req.pem
openssl rsa -in server-key.pem -out server-key.pem
openssl x509 -req -in server-req.pem -days 365000 -CA ca-cert.pem -CAkey ca-key.pem -set_serial 01 -out server-cert.pem

3) Make sure MySQL can read the keys:

Code Block

language	bash

chown mysql

4) Restart MySQL and check that SSL is enabled"

Code Block

language	bash

SHOW VARIABLES LIKE 'have_ssl';

5) Set the following constant in "[installation path]/globals.php":

Code Block

language	bash

define('DB_SSL_CA', '/etc/mysql/ssl/server-cert.pem');

6) If using self-signed certs, also set this constant

Code Block

language	bash

define('DB_SSL_VERIFY_CERT', FALSE);

7) To make sure Provision is using SSL, edit the permissions of the MySQL user account to require SSL.

Troubleshooting:

Some potential errors and responses are listed below:

Error	Response
"Uncaught PDOException: SQLSTATE[HY000] [1045] Access denied for user"	This means the server-cert is missing or incorrect. Check the cert and defined installation path in globals.php.
"Uncaught PDOException: failed loading cafile stream"	This means cert verification failed. Check permissions, or if using self-signed certs set 'DB_SSL_VERIFY_CERT' to FALSE in globals.php.
"Uncaught PDOException: PDO::__construct(): This stream does not support SSL/crypto"	This means the connection doesn't support SSL. Most likely because you are connecting over the local socket (i.e. the $db_host is set to localhost). Change it from localhost to 127.0.0.1 to connect over TCP/IP

...

Page tree

Versions Compared

Old Version 5

New Version Current

Key

Troubleshooting: