Просмотр кода страницы Installation for version 3.10 and earlier

[[Installation_for_version_3.10_and_earlier|en]] | [[Установка_для_версии_3.10_и_более_ранних|ru]]

'''ATTENTION: This instruction is valid for ERP "UserSide" versions up to 3.11. For version 3.11 and higher - use the instruction for [[Installation|installing the system with the installer]].



* installation on FreeBSD/Linux systems is recommended. Installation on Windows is also possible, but practice has shown that on *nix-systems the performance of the programme is much better with the same server specifications.

* make sure that your system meets the necessary [[Technical requirements|technical requirements]]

* unzip the '''userside.zip''' archive into a separately allocated directory ''(e.g. /var/www/userside/)'' for the system.

* set up a web server and start the userside project/web-host in it.

* optionally configure the virtual host as follows ''(example for Apache24 Debian/Ubuntu)''.

 The source data is as follows:
 a) the files and directories of the USERSIDE application are located in the /var/www/userside/ directory
 b) the virtual host site address is userside.mydomain.com
 
 <VirtualHost *:80>
    ServerAdmin webmaster@yourdomain.name
    DocumentRoot "/var/www/userside/userside3"
    ServerName userside.mydomain.com
    ErrorLog "/var/log/apache2/userside-main-error.log"
    CustomLog "/var/log/apache2/userside-main-access.log" common
    <Directory "/var/www/userside/userside3">
        Options -Indexes
        AllowOverride All
        Require all granted
    </Directory>
 </VirtualHost>

* in MySQL-server the variable ''max_allowed_packet'' should be increased to "10M" ''(file my.cnf/my.ini)''

* create a database on MySQL server with the name '''userside''' and encoding '''utf8'''

* import the '''create_userside.sql''' file. You can also import the file using the mysql console, in which case the command is as follows:

 mysql --default-character-set=utf8 -u root -p userside < create_userside_new.sql

* perform [[Installation|install and/or configure PostgreSQL]]

* customise the '''/userside/userside3/main/config/config.php''' file by changing the values of the variables

* while in the ''(for example: /var/www/userside)'' application directory, execute "php setup" and answer the questions in the setup script. It will require you to specify parameters to access the created PostgreSQL database

* open the system page '''<nowiki>http://userside.mydomain.com/oper/</nowiki>''' and make sure the system is up and running ''(username: Admin, password: 1234)''

* assign write permissions to the web server for the entire UserSide directory, including subdirectories. This is necessary to perform updates

* at the level of the .htaccess file, disallow viewing of the directory listing

* access to the file [[API_EN|API]] "'''/userside/userside3/api.php'''" is recommended to be restricted at the level of the web server for access only from authorised IP addresses

* prescribe the internal [[Script - Scheduler|scheduler]] UserSide in cron.

 * * * * *   www-data   php /var/www/userside/userside cron > /dev/null 2>&1

* configure interaction with [[Supported billings|billing]] according to [[Setting_up_interactions_with_a_billing|instructions]]

* under "[[Settings - Main|Settings - Main]]" explore the main sections, settings and customise the system to suit your needs.

'''It is highly recommended that after the system installation you set up periodic ''(daily is better)'' backup creation by MySQL and PostgeSQL standard tools and its storage ON ANOTHER COMPUTER. For example:'''
 mysqldump -uroot -pPASS userside > /var/www/userside.sql
 pg_dump -c -Fc userside > /var/www/userside.dump

{| border=1 
|
[[File:alert.png]] '''Warning:''' don't neglect security. Use strong passwords for system operators and remember to change them periodically. Also disallow viewing the contents of directories in the /userside/ directory.
|}

'''It is recommended that you read the instructions on the page: [[Where do I start?]]'''
== Additional information ==

* we are constantly improving the system and release [[Update|updates]]. These are an archive with updated files and instructions on how to upgrade. Keep an eye on the UserSide system news, download the updates in your "personal account" and follow the attached instructions.

* after updates are released, we may sometimes post "[[HotFix|hotfixes]]" with current bug fixes and small improvements in the file archive. They are an archive with files to be transferred to your working system (replacing existing files).