|
|
| Строка 1: |
Строка 1: |
| '''en''' | [[Інсталятор|uk]] | [[Инсталлятор|ru]] | | '''en''' | [[Інсталятор|uk]] | [[Инсталлятор|ru]] |
|
| |
|
| '''ATTENTION: The installer is used for ERP "UserSide" versions 3.21 and later. For version 3.11-3.20, use the separate [[Installation_for_versions_3.11_-_3.20|installation instruction]]. For versions earlier than 3.11, use the [[Installation_for_version_3.10_and_earlier|earlier-version installation instruction]].''' | | '''ATTENTION: The installer is used for ERP "UserSide" versions 3.19 and later. For version 3.11-3.18, use the separate [[Installation_for_versions_3.11_-_3.18|installation instruction]]. For versions earlier than 3.11, use the [[Installation_for_version_3.10_and_earlier|earlier-version installation instruction]].''' |
|
| |
|
| The installer is available in the client's personal cabinet at https://my.userside.eu/soft/installer
| | == Downloading the installer == |
|
| |
|
| It is a console utility that '''runs on the server in the directory where ERP "UserSide" is/will be installed''' and allows [[Installation|install the current version]] ERP "UserSide" or [[Upgrade|upgrade the current version]] to the current version.
| | Create the directory where you plan to install ERP USERSIDE, go to it, and download the installer: |
|
| |
|
| The installer process will require you to enter your licence key, which is also visible in your personal account in the main customer information section in the Licence Information subsection. Additional authorisation is done by the IP address of the server where the installer is running.
| | <pre> |
| | curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash |
| | </pre> |
|
| |
|
| == Commands and options == | | == Installing ERP USERSIDE == |
|
| |
|
| The installer supports several commands, each of which can use different options.
| | Always run the installer as the web user (for example, www-data) to guarantee file access for the installer, nginx, and php-fpm. |
|
| |
|
| Options start with the symbol <code>-</code> (short naming) or <code>--</code> (full naming). Several options can be specified at the same time.
| | To install, run the installer with the '''install''' parameter: |
|
| |
|
| A command is specified without an initial <code>-</code> or <code>--</code> and can be only one. The command is what the installer should execute.
| | <pre> |
| | sudo -u www-data ./installer install |
| | </pre> |
|
| |
|
| === Global options ===
| | Follow the instructions. The installer will check that the environment meets the requirements, try to verify connectivity to all required services and their configuration correctness, then download the selected ERP USERSIDE version and install it. |
|
| |
|
| Global options are available in all commands.
| | == Advanced installer usage == |
|
| |
|
| To see the global options, you can use the help command
| | <pre> |
| | sudo -u www-data ./installer [global flags] <command> [command flags] |
| | </pre> |
|
| |
|
| php userside_install.phar help
| | === Global flags === |
|
| |
|
| List of global options:
| | * <code>--quiet</code> <code>-q</code> — quiet mode: suppress all standard output messages except errors. Installer interactivity is not available in this mode. If user input is required, the installer will exit with an error. |
| | * <code>--verbose</code> <code>-v</code> — verbose mode: the installer prints more information while running. |
| | * <code>--level <stable|rc|beta|alpha></code> — ERP USERSIDE build stability level. This value is not saved in the configuration and must always be specified explicitly when a build stability other than "stable" is required. |
|
| |
|
| <code> --format=FORMAT</code> - Output format (txt, xml, json, md) defaults to txt
| | === Commands === |
|
| |
|
| <code>-q, --quiet</code> - Quiet Mode. Do not display any messages | | * <code>install</code> — ERP USERSIDE installation or upgrade mode. |
| | * <code>repair</code> — mode for restoring the current or unsuccessfully installed ERP USERSIDE version. |
| | * <code>update-check</code> — checks for ERP USERSIDE updates (use the <code>--level</code> flag to specify the build stability level). |
| | * <code>self-update</code> — self-update of the installer. A new version check and self-update are also performed each time the "install" and "repair" commands are started. |
| | * <code>crc-check</code> — ERP USERSIDE file checksum verification. |
| | * <code>config</code> — changes selected system configuration values. The specific parameters to change are set with additional flags: |
|
| |
|
| <code>-V, --version</code> - Installer version output
| | ==== Flags for the config command ==== |
| | | * <code>--url <URL></code> — change the system URL. The web server configuration for the specified URL will be checked and all required changes will be made to the system configuration. |
| <code> --ansi</code> - Forced output in ANSI mode (with support for colour console, etc.)
| | * <code>--maintenance-disable</code> — forcibly disable maintenance mode (use with caution). If the system did not leave maintenance mode automatically after an upgrade, it is better to contact technical support for help. |
| | | * <code>--flush-cache</code> — full cache reset. Do not run this unless support recommends it. Cache warm-up can take a long time, which may degrade system performance. |
| <code> --no-ansi</code> - Disable ANSI mode
| | * <code>--2fa <enable|disable></code> — enable or disable two-factor authentication. |
| | |
| <code>-n, --no-interaction</code> - Do not ask any questions. It is worth noting that the installer is not always able to perform actions in this mode. In cases where mandatory input is required during the operation, the installer will stop with an error.
| |
| | |
| <code> --dir[=DIR]</code> - Target directory. We recommend to run the installer in the same directory where Userside is (or is planned to be) located. But if for some reason this is not possible, you can specify the target directory in the value of this option.
| |
| | |
| <code>-v|vv|vvv, --verbose</code> - Increase the amount of output information: 1 - normal output, 2 - more informative output, 3 - output everything, including debugging information
| |
| | |
| To see the options for a particular command, specify it after the word help
| |
| | |
| php userside_install.phar help install
| |
| | |
| Displays help on the install command.
| |
| | |
| === Available commands === | |
| | |
| To see a list of available commands, you can use the list command
| |
| | |
| php userside_install.phar list
| |
| | |
| The current version of the installer implements the following commands:
| |
| | |
| <code>config</code> - installer configuration command (installer settings are saved in the installer.json file) | |
| | |
| <code>install</code> - userside installation command. It is also used for upgrading, as it is the same procedure. | |
| | |
| <code>repair</code> - command to restore userside files for the current version (version number is taken from the database). The command should be executed after restoring the database backup to update the userside system version itself with respect to the data version.
| |
| | |
| <code>check:integrity</code> - command to check file integrity. File integrity is also checked in the install and repair rooms, so you may never need to run this command specifically. But you can always use it just to check file integrity.
| |
| | |
| <code>check:updates</code> - command to check if there is a new version of Userside. It may be useful to run this command just to see if there is a new version. If there are no new versions, the installer termination code will be 1 (as opposed to the normal termination code of 0), allowing the command to be run in scenarios based on status code checking.
| |
| | |
| <code>maintenance:disable</code> - forcibly switch off the maintenance mode. Perform at your own risk. If the system has not been properly installed or the upgrade has errors that prevent the system from being used (i.e. the atomic integrity of the system has been compromised, for example, only part of the migrations have been performed), userside remains locked until the installer completes correctly. If this happens, you should either fix the error yourself or contact technical support for help and then run the installer again. After the error is fixed and the update is successfully completed, the lock flag will be removed automatically. But if you suddenly have an urgent need to use userside with broken integrity, you can run this command and the flag will be removed. | |
| | |
| ==== Default command ====
| |
| | |
| In the 2.0.x installer branch, the default command is install. This means that if you run the installer without specifying any command, the installer will run in install mode. However, this behaviour will be eliminated in the next minor versions (starting with 2.1), so it is recommended that you explicitly specify the install command whenever you run the installer, especially if you run it automatically from cron.
| |
| | |
| ==== Example of running the command with the options ====
| |
| | |
| Command:
| |
| | |
| php userside_install.phar install -q -n
| |
| | |
| In this example, the install command will be run in silent mode (-q) without displaying any prompts (-n), automatically accepting default values as responses. It should be re-emphasised here that there are situations where user input is required (e.g. you can only upgrade to a new minor version, and this requires confirmation, as this process can make quite serious changes to the system).
| |
| | |
| == Commands ==
| |
| | |
| === Configuration ===
| |
| | |
| To see the options available for configuration, you can run one of the following commands (they are equivalent):
| |
| | |
| php userside_install.phar help config
| |
| | |
| or
| |
| | |
| php userside_install.phar config --help
| |
| | |
| In addition to the standard options, you will see two options for the config command:
| |
| | |
| <code>--stability[=STABILITY]</code> - The minimum Userside stability level that can be set (stable, rc, beta, alpha) defaults to stable. | |
| | |
| <code>--key[=KEY]</code> - Changing the licence key. When you enter a licence key during the installer, it is saved in the installer.json installer config and will not be requested again. If you need to change the licence key, you can edit the installer.json file or run the config command with this option, passing the new key as the value. | |
| | |
| ==== Changing the stability mode in more detail ====
| |
| | |
| Using the configuration mode, you can set the stability level of the updates you receive. To do this, run the installer with the '''config''' command and the --stability=''level'' option:
| |
| | |
| php userside_install.phar config --stability=stable
| |
| | |
| By default, if no stability level is configured, you will always receive only stable updates.
| |
| | |
| You can select one of the following stability levels:
| |
| | |
| * '''stable''' - you will receive only stable versions
| |
| * '''rc''' - you will receive stable versions and release candidates
| |
| * '''beta''' - you will receive stable versions, release candidates and beta versions
| |
| * '''alpha''' - you will receive stable versions, release candidates, beta and alpha versions
| |
| * '''dev''' - you will receive all versions, including those in active development
| |
en | uk | ru
ATTENTION: The installer is used for ERP "UserSide" versions 3.19 and later. For version 3.11-3.18, use the separate installation instruction. For versions earlier than 3.11, use the earlier-version installation instruction.
Downloading the installer
Create the directory where you plan to install ERP USERSIDE, go to it, and download the installer:
curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash
Installing ERP USERSIDE
Always run the installer as the web user (for example, www-data) to guarantee file access for the installer, nginx, and php-fpm.
To install, run the installer with the install parameter:
sudo -u www-data ./installer install
Follow the instructions. The installer will check that the environment meets the requirements, try to verify connectivity to all required services and their configuration correctness, then download the selected ERP USERSIDE version and install it.
Advanced installer usage
sudo -u www-data ./installer [global flags] <command> [command flags]
Global flags
--quiet -q — quiet mode: suppress all standard output messages except errors. Installer interactivity is not available in this mode. If user input is required, the installer will exit with an error.--verbose -v — verbose mode: the installer prints more information while running.--level <stable|rc|beta|alpha> — ERP USERSIDE build stability level. This value is not saved in the configuration and must always be specified explicitly when a build stability other than "stable" is required.
Commands
install — ERP USERSIDE installation or upgrade mode.repair — mode for restoring the current or unsuccessfully installed ERP USERSIDE version.update-check — checks for ERP USERSIDE updates (use the --level flag to specify the build stability level).self-update — self-update of the installer. A new version check and self-update are also performed each time the "install" and "repair" commands are started.crc-check — ERP USERSIDE file checksum verification.config — changes selected system configuration values. The specific parameters to change are set with additional flags:
Flags for the config command
--url <URL> — change the system URL. The web server configuration for the specified URL will be checked and all required changes will be made to the system configuration.--maintenance-disable — forcibly disable maintenance mode (use with caution). If the system did not leave maintenance mode automatically after an upgrade, it is better to contact technical support for help.--flush-cache — full cache reset. Do not run this unless support recommends it. Cache warm-up can take a long time, which may degrade system performance.--2fa <enable|disable> — enable or disable two-factor authentication.