Quad.Wiki

Инструкция по установке Quad.X

 

Сделайте бекап на старом компьютере, если это не новая установка программы, а нужно перенести программу на другой компьютер: Резервная копия файлов программы (бекап)

 

Системные требования

Acnt - количество человек, которые будут заниматься настройкой программы, одновременно, а не просто смотреть результаты работы программы

Pcnt - количество товаров на сайте (включая не активные и нет в наличии)

Scnt - количество товаров в прайсах поставщиков

если Scnt/10 больше чем Pcnt, то за Pcnt нужно принять Scnt/10

1. Оперативная память (ОЗУ), гигабайт = 2 + Pcnt / 100000 + 1.5 * Acnt,

2. Процессор с частотой от 3Ггц на одно ядро, количество ядер = Acnt , но не меньше 3х. В большинстве случаев достаточно будет 4х ядер, даже если пользователей, занимающихся настройками у вас планируется больше. Программа использует для работы 2-3 ядра, поэтому нет смысла специально для программы покупать процессоры с 8+ ядрами, так как они не будут использоваться. Важна только скорость на 1 ядро, чем она выше, тем быстрее работа.

3. Жесткий диск - можно любой современный HDD или SSD NVMe (при Pcnt > 100 000), рекомендуемое свободное место: Pcnt/1000 Гб

4. Windows 10 / Server 2016 или новее, с возможностью подключаться по RDP (удаленный рабочий стол) для Acnt пользователей

5. MS Office 2016 или новее, обязательно 64 бит.

6. Статический IP-адрес, если нужна возможность смотреть результаты работы через Web-интерфейс или получать данные из программы по API

7. Доступный извне порт 8079, если планируется использовать веб-интерфейс. Через веб можно только смотреть информацию о собственных товарах (цены и остатки) и товаров из прайсов поставщиков. Настройки и другие операции через веб делать нельзя.

8. Доступный извне порт 2001, порт для службы API, если вам нужно где-то извне получать данные из вашей базы по API

 

Данные системные требования являются рекомендуемыми, т.е. программа будет работать и с меньшими ресурсами, но медленнее.

Установка

1. Скачать и установить сервер базы данных PostgreSQL

1. Выберите диск на компьютере, где будет храниться база данных программы. Лучше, чтобы это был не системный диск C, а какой-то другой, на котором есть 50-100Гб свободного места. Если у вас до 100 000 товаров с описанием, то будет достаточно 50Гб, но лучше 100.

2. Создайте на этом диске папку QuadXDB

3. Скачайте установочный файл сервера БД по этой ссылке, самую новую версию для Windows 64 бит:

https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

На момент установки у вас уже будет 16 версия или новее - скачивайте самую последнюю.

Если у вас заблокирован доступ по ссылке выше (для пользователей из Беларуси и РФ), то актуальную версию сервера БД можно скачать здесь

https://disk.yandex.com/d/8g_IHELla57JdA

4. Скачанный файл запустите от имени Администратора компьютера, лучше чтобы это устанавливалось под самым главным пользователем-администратором.

5. В пути, по которому устанавливается база по умолчанию, удалите папку Programm Files, чтобы осталось так (13 на конце может быть большим числом, если вы устанавливаете версию новее):

6. В следующем окне уберите 2 птички

7. В следующем окне выберите папку, которую создали в п.2

8. Введите пароль пользователя-администратора базы данных. В пароле используйте большие и маленькие латинские (английские) буквы и цифры. В Windows может быть настроено ограничение, что пароль должен обязательно содержать еще и символы (знаки пунктуации), поэтому лучше сразу вводить пароль содержащий, в том числе, и их. Пример пароля: De345tgb#

9. В следующем окне введите порт, отличающийся от стандартного 5432, например 5445

10. В следующем окне выбрать локализацию Russian, Russia для корректной работы с кириллическими буквами.

 

11. Во всех следующих окнах нажимайте Next, пока не начнется установка. Дождитесь завершения установки.

12. Если все хорошо, то вы получите такое сообщение

 

Если в ходе установки появилось сообщение об ошибке, то нужно:

1. Через Панель управления / Программы и компоненты удалить установленный сервер

 

2. Удалить все из папки QuadXDB и C:\PostgreSQL, если такие папки остались на диске

3. Для папок QuadXDB и C:\PostgreSQL добавить права на полный доступ для “Пользователи”

и LOCAL SERVICE и NETWORK SERVICE

 

2. Внести изменения в конфигурационный файл базы данных

1. Скачайте и установите более удобный редактор текста, например Notepad++ , вместо стандартного Блокнота

 

2. Откройте в блокноте файл [ваш диск]:\QuadXDB\postgresql.conf

Сохраните копию этого файла до того, как начнете вносить изменения

 

3. Зайдите на сайт https://pgtune.leopard.in.ua/ и введите слева данные компьютера, на котором устанавливается программа

Выделенные ячейки должны быть как на скриншете. Версию базы данных в первом поле выбирайте такую, как устанавливаете (скачали в п.1.3 этой инструкции). Память и количество ядер процессора - как на компьютере.

Number of Connections - количество одновременных подключений, устанавливайте 30 * кол-во одновременно работающих человек с программой, но не меньше 100.

Последний пункт - выбрать какой у вас диск SSD или HDD.

После ввода настроек нажмите Generate - справа появятся рекомендованные настройки сервера базы данных.

Копируйте название настройки, ищите ее в файле postgresql.conf и заменяйте значение на то, которое предлагается на этом сайте.

 

 

4. Дополнительно к тем настройкам, которые предлагается заменить в п.3, установите еще значение настройки synchronous_commit = off

 

5. Перезапустите службу postgresql-64, она может называться по-разному, в зависимости от версии, которую вы установили. Версия в конце названия.

Если служба остановилась, но не запускается, значит вы допустили какую-то ошибку при изменении настроек в конфигурационном файле.

Попробуйте сначала поменять значение настройки maintenance_work_mem на 1GB, если сайт вам предложил установить там значение больше 2GB и опять запустить службу.

Если и после этого не запустится, то нужно восстановить файл конфигурации из копии, проверить, что служба стала запускать, и после этого вносить изменения по одной настройке, после каждого изменения перезапускать службу и найти настройку, после изменения которой служба не запускается.

 

 

3. Установить программу

Скачайте полный архив с программой. Все файлы из него разархивируйте в корень на какой-нибудь диск, желательно чтобы это был не системный диск С:\ , а какой-то другой.

Например, папка G:\Quad Solutions и в нее разархивировать все папки из установочного архива, чтобы получилось как на скриншете ниже.

Запустите программу Quad Solutions\QuadSetup.exe от имени Администратора

 

3.1. Название базы

Укажите название базы данных (обычно это название магазина). Название должно быть маленькими английскими буквами, без пробелов и каких-то других символов.

 

3.2. Пароль, порт и версия базы данных

Эти параметры вы задавали при установке сервера БД.

После указания настроек нужно нажать “Проверить подключение”. Если все верно, то будет сообщение “Подключено”.

 

3.3. Путь к файлу бекапа

Если нужно сразу и создать базу из бекапа, то укажите путь к файлу. Путь копируется вручную в поле.

 

3.4. Ключ Quad.Net

Укажите ключ Quad.Net магазина, полученный при покупке программы.

 

3.5. Установка Sync.X

Если нужно установить службу Sync.X, то укажите путь к папке с сервисом.

 

Если вы устанавливаете программу на своем компьютере, то обычно это папка Quad Solutions\sync

 

3.6. Запуск установки

Отметьте птичками те компоненты, которые нужно установить и нажмите кнопку “Выполнить отмеченные”

 

При отсутствии ошибок будет такое сообщение:

Проверьте так же, что появилась папка вашего магазина в SyncX

 

 

Если нет файла QuadSetup.exe или установку нужно сделать вручную по другим причинам:

1. Добавить базу данных

Скачайте и установите программу pgAdmin, все настройки при ее установке оставляйте по умолчанию. Скачать можно по этой ссылке https://www.pgadmin.org/download/pgadmin-4-windows/ - качайте последнюю версию 64 бит

 

Запустите программу, она откроется в браузере. При запуске она попросит установить “мастер-пароль”, для доступа в саму программу - можете установить тот же пароль, который устанавливали администратору базы данных в п. 1.8. этой инструкции

 

Зайдите в раздел “Servers” - здесь нужно будет ввести пароль администратора базы данных из п.1.8.

 

Нажмите правой кнопкой на Databases и в меню выберите Create->Database

 

После этого введите название базы, например, такое же как название вашего интернет-магазина и нажмите Save.

 

2. Установить программу Quad.X

Если вы уже работали с программой на другом компьютере, то нужно оттуда скопировать папку Quad Solutions и поменять пути в конфигурационных (ini) и исполняемых (bat) файлах, если поменялась буква диска на новом компьютере. Чтобы ничего не менять, нужно перенести программу на диск с такой же буквой.

Если программы еще не было, то:

Распакуйте все из архива Quad Solutions X Full.zip в корень диска, на котором будет работать программа.

Все дальнейшие ссылки на файлы и папки находятся внутри папки Quad Solutions

В папке crmpack\lang измените название файла shop.lng на [название базы].lng, в моем примере это будет nami.lng. Откройте файл в блокноте и в первой его строке вместо shop так же введите название базы

В файле crmpack\QuadSyncX.ini поменяйте название базы и путь к файлу, чтобы он соответствовал вашему диску, на котором устанавливаете программу.

 

В файле \crmpack\quadx.ini введите название вашей базы в двух местах. Укажите так же порт, который вы ввели в п.1.9. этой инструкции (5445 или другой)

 

 

Запустите программу \crmpack\QuadX.exe - откроется окно в котором нужно ввести ключ программы и нажать Зарегистрировать

откроется окно с вводом пароля, в этом окне нажмите кнопку с тремя точками

в открывшейся вкладке введите пароль администратора БД, который вы устанавливали в п.1.8. и нажмите Войти

Программа выдаст такую ошибку - нажмите Ок, а в окне логина Отмена

 

3. Восстановить базу данных из бекапа

В папке Quad Solutions\backup найдите такой файл и откройте его на редактирование в блокноте

В файле нужно:

Указать пароль администратора БД

Указать путь к файлу программы восстановления (поменять вот эту часть, чтобы она соответствовала вашей: c:\PostgreSQL\13\bin\ )

Поменять порт и название базы данных на ваше название и порт, введенный при установке сервера базы данных

Указать путь к файлу бекапа

Если файла бекапа нет, т.е. это первая установка, то можно выбрать один из файлов бекапа, которые идут вместе с архивом программы

Quad Solutions\backup\bitrix.bin - если ваш сайт на CMS Bitrix

Quad Solutions\backup\other.bin - если ваш сайт на другой CMS

Quad Solutions\backup\onliner.bin - если вы планируете работать только с http://onliner.by

 

Сохраните изменения в файле и запустите его двойным кликом - должно появиться черное окно и висеть продолжительное время, пока выполняется восстановление. Если окно быстро закрывается, значит вы что-то неправильно указали в файле.

 

3. Ключ Quad.Net и проверка работы программы

Запустите программу QuadX.exe, после это сразу откройте вкладку Конфигурация, не открывая никаких других вкладок.

Перейдите во вкладку Сервисы и введите ключ Quad.Net.

Этот ключ необходим для получения техподдержки, а так же для доступа к описаниям и ценам с сайта catalog.onliner.by.

Если все установлено и зарегистрировано правильно, то при открытии вкладки Продукция и вкладки Прайсы не должно быть никаких ошибок. Если вы видите какие-то ошибки - обратитесь в техподдержку.

4. Установить сервис Sync.X

Установка и обновление Sync.X

 

4. Запустить программу Quad.X

Запустите программу \crmpack\QuadX.exe - откроется окно в котором нужно ввести ключ программы и нажать Зарегистрировать. Ключ программы вы получили при покупке.

Если у вас появляются такие окна с ошибками, то во всех нажимайте “Нет”

 

В открывшемся окне логина нажмите “Войти”. После установки, если вы не восстанавливали какой-то ваш рабочий бекап, в программу можно входить без ввода пароля.

 

Если все ок, то откроется окно программы, в котором при переходе на вкладки Продукция и Прайсы не будет ошибок.

 

 

5. Запустить сервис Sync.X