Differences

This shows you the differences between two versions of the page.

--- en:install550 [2017/09/02 11:29]
joebordes
+++ en:install550 [2021/03/24 18:13] (current)
joebordes
@@ Line 2: / Line 2: @@
 ===== Requirements =====
   * Apache 2.x or above.
-  * MySQL 5.x
+  * MySQL 5.x and 8.x
-  * PHP from 5.4.x to 7.0.x. PHP 7.x is recommended. PHP 5.3 will have some functionality missing but should work in general.
+  * PHP from 7.1.x to 7.4.x. PHP 7.4 is recommended.
 <WRAP center round info 75%>
 This is a typical **WAMP/LAMP stack**. All linux distributions have this natively so we recommend you install the packages from your distribution (make sure you have the right versions). On windows download the XAMPP stack from apache friends. You can see the [[http://code.stephenmorley.org/articles/xampp-version-history-apache-mysql-php|list of application versions here]].
@@ Line 23: / Line 23: @@
 |OpenSSL|Optional|Imap with OpenSSL should be enabled in case Mail server needs to be connected via SSL|
 |Curl|Optional|This one is optional but really important for any external communications, like SMS, Google Sync or RSS|
+|MBString|Optional|This one is optional but mandatory if you want to use GenDoc|
 ==== PHP Configuration  ====
@@ Line 35: / Line 36: @@
 |file_uploads|on|
 |max_execution_time|600|
-|max_input_vars|8000|
+|max_input_vars|6000|
-|post_max_size|16M|
+|post_max_size|36M|
 |memory_limit|1024M|
 |log_errors|off|
@@ Line 42: / Line 43: @@
 |register_globals|off|
 |request_order|GP|
+<WRAP center round info 85%>
+The maximum size of file uploads is defined by the PHP **upload_max_filesize** directive. Remember to set this variable to accommodate the file size you need to upload. coreBOS has a Global Variable that can limit the upload BELOW this directive, never above, PHP defines the maximum limit.
+I normally set this variable to 32Mb
+</WRAP>
 <WRAP center round info 85%>
@@ Line 51: / Line 58: @@
 suhosin.request.max_vars = 8000</code>
-After this you must restart your apache server.
+After this, you must restart your apache server.
 </WRAP>
@@ Line 99: / Line 106: @@
   * Download the source code from GitHub
-  * copy the code into a folder in accessible from your webserver install
+  * copy the code into a folder inaccessible from your web server install
   * type in the URL of the folder into your browser
   * you should get the **Configuration Wizard** welcome page
@@ Line 106: / Line 113: @@
   * click on the Install button and accept the license
-  * Review all the pre installation checks. You should be able to proceed with some PHP recommendations in red, but ONLY those, any other red check MUST be fixed before proceeding.
+  * Review all the pre-installation checks. You should be able to proceed with some PHP recommendations in red, but ONLY those, any other red check MUST be fixed before proceeding.
   * Fill in all the information required and continue
-    * you will need a mysql user with access to a database that may exist or not, if it doesn't exist you will also need a mysql user with enough permission to create a database
+    * you will need a MySQL user with access to a database that may exist or not, if it doesn't exist you will also need a MySQL user with enough permission to create a database
 <WRAP center round important 60%>
-If the database exists it **MUST** be empty, the install procedure DOES NOT migrate, there is a migrate button on the first page of this process which launches the migration process of an existing database.
+If the database exists it **MUST** be empty, the install procedure DOES NOT migrate, there is a migration procedure available if necessary.
 </WRAP>
-    * you can chose to load a set of example information and the password for the only user that will be created.
+    * you can choose the password for the only user that will be created.
 {{ :en:corebosinstall02.png?800 |}}
   * now wait for all the installation work to be done
+  * if all goes well you should receive a verification page welcoming you to the application
+  * press the **Finish** button to reach the login page
+  * **execute the database changes**, this is done using the **[[en:devel:corebosupdater|coreBOS Updater]]**, which is a module that will take care of managing all the updates from now on. It will read the set of changes that need to be done and will permit you to apply them and undo some of them.
+    * login to the application as the admin user and go to the "**coreBOS Updater**" module.
+    * click on the **Get Updates** button
+    * go back to the list view and click on the **Apply All** button
-== Firefox Timeout Marker ==
+<WRAP center round important 80%>
+For additional security it is recommended that you take two more steps:
+  - Configure a [[https://wiki.apache.org/httpd/PasswordBasicAuth|Basic Authentication]] password protection on the application
+  - Delete all unused files. You can launch the **bettersafe.sh** script and also remember to eliminate the install and migration scripts and directory which have been renamed during the install process
+  - the **bettersafe.sh** will also **set the config.inc.php file to read-only** which is a very good idea even if you don't want to execute bettersafe
+</WRAP>
-<WRAP center round info 80%>
-Latest versions of Firefox have added a configuration option that limits the time a web page can take to execute. If this time is passed the browser will cancel the call. The install process easily passes this 5 minute limit on many machines producing a problem in the installation process and canceling it.
-**We will attend this issue in the next release because it causes us to redefine the install process.**
+<WRAP center round box 60%>
+**Now comes all the fun**
+  * Configure the application
+  * Import your data
+  * Create users
+</WRAP>
-In the mean time you can configure the browser increasing the timeout or use chrome for the installation process.
-To increment the time out type in "about:config" in the browser address, look for "**network.http.response.timeout**" or "**http.response.timeout**" and set it to 600 at least and restart the browser.
+=====FAQ=====
-[[https://support.mozilla.org/es/questions/998088|Stop connection timeouts from happening - want the page to wait]]
+~~QNA~~
-{{ :en:firefoxtimeout.png?500 |}}
+??? I installed in windows but the Popup screen is empty.
-</WRAP>
+!!! XAMMP configures your PHP to load files only from a couple of directories. By default it does not look for files in the current directory which is something that coreBOS depends upon. You must edit your php.ini file, look for the include_path directive and add the current directory. Something like this;
+<code>
+include_path = ".;C:\php\pear;C:\wamp\www"
+</code>
+What I usually do when I have to install on windows is edit config.inc.php and add this line towards the end:
+<code>
+echo get_include_path();
+</code>
+then I edit the php.ini directive putting the same value and adding the current directory (.)
-  * if all goes well you should receive a verification page welcoming you to the application
-  * press the **Finish** button to reach the login page
-  * **execute the database changes**, this is done using the **[[en:devel:corebosupdater|coreBOS Updater]]**, which is a module that will take care of managing all the updates from now on. It will read the set of changes that need to be done and will permit you to apply them and undo some of them.
-    * login to the application as the admin user and go to the "**coreBOS Updater**" module.
-    * click on the **Get Updates** button
-    * go back to the list view and click on the **Apply All** button
-  * **Now comes all the fun**: first configure the application and then create users to start
+??? I have problems installing/recovering the database
+!!! apply this change in my.cnf <code>max_allowed_packet = 16M</code>
+https://discussions.corebos.org/showthread.php?tid=1550

User Tools

Differences

Page Tools

Site Tools