Установка ХМ2 с настройкой путей к данным

[Sarek]

Большинство пользователей Holdem Manager 2 вполне устраивают те пути, по которым программа по умолчанию и устанавливается сама, и где хранит данные. Однако, некоторые (в силу различных причин) желают более тонко управлять процессом установки и размещения информации в компьютере. Кто-то уже разобрался в этом самостоятельно, а кто-то - желал бы, но не знает, как. Вот для последних и написана эта инструкция.
Замечание 1: нижеизложенное касается ХМ2. Если нужно разобраться с ХМ1 - см. только главу А, часть В - неактуальна совсем, а раздел Б - частично.
Замечание 2: В этой инструкции нигде не упомянута папка архива. В случае ХМ2 путь к ней по умолчанию
C:\HM2archive
а не упомянута она потому, что архив - это склад отработанного материала (оригиналов историй раздач). И к базе данных архив отношения не имеет никакого. Да, ее тоже можно переместить, причем в любое место - но безотносительно к рассматриваемому в этой статье вопросу.
Замечание 3: О том, где ХМ2 хранит данные - рассказано подробно в этом посте.

Установщик ХМ2 записывает исполняемые файлы программы в эту папку:
Для Vista\Win7\Win8
C:\Program Files (x86)\Holdem Manager 2
Для WinXP
C:\Program Files\Holdem Manager 2
И практически не существует причин, по которым этот умолчальный путь стоило изменять. И, наоборот - на некоторых системах и (или) при взаимодействии с некоторыми другими установленными на компе программами возможны случаи, когда при установке в неумолчальный путь его потом не могут найти последующие обновления ХМ. Так что - менять не стоит. Да и занимает папка эта всего-то меньше 150 мб.
Другое дело - данные. Их обычно бывает или много, или очень много - и на системном диске C вполне могут не поместиться. Вот ими и займемся.
"В ручном режиме" последовательность установки такая:
А) Сначала ставим Postgresql и задаем желаемое место расположения кластера базы данных (там будет храниться примерно половина информации, нужной ХМ2 для работы);
Б) Затем устанавливаем сам ХМ2 в умолчальный путь (см. выше);
В) Потом создаем в ХМ2 базу данных и задаем при этом путь к папке для хранения второй половины данных.

А. Установка PostgreSQL
А1. Для нормальной работы ХМ и Postgres пользователь, под которого загружена Windows, должен иметь права администратора. Имя его не может содержать неанглийских букв (цифры допускаются) и быть "в одно слово" (без пробелов). Если это не так - переименование пользователя желаемого эффекта не даст, в таких случаях обязательно создавать нового юзера по указанным правилам, перегрузить систему под него и устанавливать Postgres. Именно перегрузкой, а НЕ имеющейся в Windows опцией "смена пользователя". После успешной установки - можно возвращаться к "старому" юзеру, а этого нового - удалять.
А2. Скачиваем отсюда инсталлятор Postgresql - рекомендованная версия = 8.4.х для любой Windows. Если очень хочется иметь на 64-битной системе 64-битную же Postgres - можно поставить 9, но разницы никто из пользователей практически не заметит. Но версия должна быть не новее, чем 9.3 - на более свежих некоторые функции ХМ работать не смогут.
А самое правильное будет вообще не задумываться о номере версии Postgres и ставить ту (8.4.22), которую устанавливает сам ХМ в автоматическом режиме. Брать здесь
А2.1. После скачивания обязательно сделать правый клик на файле - свойства - нажать кнопку Разблокировать.
А3. Исполнить Пуск - Панель управления - Администрирование - Службы
Найти в списке Вторичный вход в систему - правый клик, задать тип запуска = Автоматически.
Если еще на включена - стартовать.
А4.1. В корне (так удобнее, но не обязательно) нужного диска создаем папку, называем ее, к примеру,
D:\PGdata
А4.2. Правый клик на ней - свойства - безопасность - задаем для пользователя "Все" (без кавычек, первая буква заглавная) на эту папку Полный доступ. В случае Windows с английским интерфейсом этот пользователь имеет имя "everyone" (первая буква - строчная).
Если на компе уже был (предыдущими установками, например, хотя можно и вручную) создан пользователь "postgres" - можно ограничиться заданием Полного доступа именно для него. Картинки с примером:




А5.1 Запускаем установщик Postgres (если Vista\Win7\Win8, то обязательно по правому клику - Запуск от администратора) .
А5.2. На одном из первых экранов задаем папку, куда будут записаны исполняемые файлы. По умолчанию - в Program Files, [но можно и в предварительно созданную C:\PostgreSQL - автоматический установщик ХМ2 делает как раз так.
Когда работает "автоматический" инсталлятор ХМ, он ставит Postgres в папку в корне диска C - но это потому, что по умолчанию там же, в глубине этой папки размещается и папка с данными - а Windows не любит, когда данные пишутся в Program Files. Но это не наш случай, мы ее все равно в другом месте положим.
А5.3. А вот на следующем экране - как раз меняем место для папки Data - задаем созданную в п. А4.1.
А5.4. Затем установщик попросит ввести пароль для доступа к базам данных. По умолчанию он =
postgrespass
и менять его, опять же, нет совершенно никакого смысла и необходимости. Только лишние проблемы можно получить, поменяв.
Поскольку при вводе пароля, буквы, как это принято, спрятаны - чтобы не ошибиться, рекомендуется или скопировать пароль прямо из этого текста и там вставить, или самому заранее написать в Блокноте и копировать оттуда.
А5.5. Далее, ничего не меняя (в том числе оставляем порт 5432), нажимаем Next на всех экранах, ждем конца установки и на последнем шаге - снимаем галку Launch Stack builder, ибо он не нужен.

А6. Теперь проверяем, все ли получилось.
А6.1. Правый клик на линейке задач - запускаем Диспетчер задач, на вкладке Процессы ищем 5 или 6 (от версии зависит) процессов postgres.exe и один pg_ctl.exe.

Когда будет работать ХМ, этих процессов может быть больше двадцати - это нормально.
А6.2. Исполняем Пуск - программы - Postgresql - PGAdmin
Дабл-клик по строке сервера слева - попросит ввести пароль (см п. А5.4), ставим галку его сохранять и на появившемся окне предупреждения тоже ставим галку.
Разворачиваем дерево - видим пока только одну базу данных с именем postgres - это небольшая служебная база, нужная самой системе для работы.
А6.3. Кстати, в свойствах сервера можно увидеть полный номер версии postgres - иногда бывает нужно его знать.

А6.4. Все, установка postgres завершена успешно.

Б. Установка Holdem Manager 2
Б1. Скачиваем здесь полный инсталлятор ХМ2. Обязательно исполнив по отношению к нему пункты А2.1 и А5.1, запускаем его, соглашаемся со всем предложенным (в том числе с путем установки, комментарий см. выше) и на одном из экранов видим, что наличие Postgres на компе обнаружено.

Б2. На следующих экранах ХМ попросит ввести данные доступа к личному кабинету на сайте ХМ, то есть почтовый адрес как логин и пароль (к кабинету, а не к почте!). А затем следует или нажать кнопку Try (если речь идет о пробной версии, причем если не ввести логин\пароль, Trial не заработает, так что наличие регистрации на сайте ХМ - обязательно), или ввести имеющийся ключ.
Б3. После чего выбрать номер компьютера, на который активируется ХМ (допускается установка на два, но активации можно сбрасывать в кабинете).

В. Создание базы данных и настройка пути к DBParent
В1. В желаемом месте создаем папку, называем ее, к примеру,
D:\HM2Parent
и применяем к ней действия из пункта А4.2 для юзера "Все".
Вообще говоря, задавать это для папки Parent необязательно, но лучше сделать - мало ли как себя поведут антивирусы, например
В2. После идентификации (активации) ХМ запускает Setup Wizard, в котором предлагает создать базу данных. Вот в этом окне снимаем галку про умолчальный путь к папке и указываем путь из п. В1.
В2.1. (Это для справки): Как можно заметить до внесения изменений, по умолчанию папка эта располагается здесь
%appdata%\HoldemManager\Database
Как найти:
вот эту строку
%appdata%\holdemmanager\
скопировать полностью (включая знаки процентов)
Открыть окно Moй компьютер и вставить в адресную строку, после чего нажать Enter
теперь в той же адресной строке увидим "настоящий" путь, без использования системной переменной. Таким же образом сработает и сервис "Поиск".
И в этой самой папке %appdata%\holdemmanager программа хранит все свои настройки и вообще рабочие файлы.

В3. Можно также поменять имя базы данных в верхнем поле - но это уж дело вкуса.

В4. Всё, нужные "пользовательские" настройки первичной установки ХМ2 исполнены. Дальше ХМ2 предложит проимпортить данные из базы ХМ1 (если таковые базы имеются и есть желание использовать информацию из них) - но это уже другая тематика, в данной статье описывать это нет необходимости.
В5. И, кстати, все последующие базы данных, которые будут создаваться, будут использовать именно этот, заданный только что путь к папке Parent.

Тему эту я закрою, вопросы задавайте в отдельных.

[Sarek]

English version
As usual, most of HM2 customers are satisfied with paths and locations where software is installed and keeps data by default. But sometmes and in some circumstances customers may want to manage \ tune up installation process. This article gives details.
Note1: Published below belongs to HM2. If you have HM1 you aslo can use this guide, but: chapter A includes all you need for HM1, chapter C does not apply at all, chapter B - only partially.
Note2: This instruction does not mention Archive folder. In case of HM2 default path is C:\HM2archive. This folder is not discussed because it is not a part of database, this is only a depot for old hand history files already imported by HM. And yes, archive folder also can be placed in any location on PC as well.
Note3: To learn where HM2 keeps data - please see appendix at the bottom of this article.

Installing Holdem Manager 2
Setup automatically puts executable files in this folder
For Vista\Win7\Win8 - in
C:\Program Files (x86)\Holdem Manager 2
for WinXP - in
C:\Program Files\Holdem Manager 2
And there are no reasons to change that path during install. Even inverse: оn some computers and (or) when reacting with some other software already installed on PC - sometimes non-default install path can give you not-upgradable HM2. In addition: HM2 install folder is not very big = less than 200 Mb.

Data is another story. Usually database usually takes or much space, or very much. And sometimes can't fit on disk C.
So in this article we discuss customization of data location.

When doing manual installation, order is as follows:
A) First we install PostreSQL and set up location of so called "database cluster" - where HM stores about 1/2 of information.
B) Then we install HM2 itself in default path (explanation see above).
C) After that we create a database in HM2 and set up a path to the Parent folder where remained 1/2 of data is stored.

A. Installation of PostgreSQL
A1. For normal functioning of HM2 and PostgreSQL - Windows user must have admin rights. His name should not contain non-English symbols (digits allowed) and should not contain spaces (to be "in_one_word").
If this is not so - simple renaming does not help, you should create new Windows user who meets these conditions, reboot PC under it and install Postgres.
Note: you should use "reboot" - but not "switch user". After successfull Postgres installation you can reboot PC again under your old user, this new can then be deleted.

A2. Download from here a Postgresql installer - recommended version is 8.4.х for all Windows versions. If you want to have a 64-bit Postgres on 64-bit Windows - you can install version 9, but there is no significant difference in performance, you even can not notice it.
A2.1. After downloadind do right click on file -> Properties - press Unblock.

A3. Do Start - Control Panel - Administrative tools - Services
Search for Secondary logon service, do right click and set Startup type = Automatic
If this service is not started yet - run it.

A4.1. In the root (this is easier but not obligatory) of desired disk create a folder, name it (example)
D:\PGdata
A4.2. Right click on folder - Properties - Security - for user "everyone" (without quotes, first letter in lowercase) set "Full access" for him. If you have Russian Windows, user name is "Все" (first letter in uppercase).
If earlier you had PostgreSQL installed on this PC - you can set Full Access for user "postgres".
See example on pictures:




A5.1 Start PostgreSQL installer (if you have Vista\Win7\Win8, you should do this by right click - Run as Administrator)
A5.2. When appropriate setup window comes, set a path where PostgreSQL executable files will be written. By default - in Program Files (x86), but you can install in (previously created) folder C:\PostgreSQL as well - HM installer automatically does the same.
When you are using automaticall HM2 installer, it puts Postgres in a folder in the root of C - this is done because Windows does not like when user data gets written in Program Files. But this is not our case - anyway we will put data folder in another location

A5.3. On the next screen we change path to Data folder - set it to a folder created in A4.1.


A5.4. Next thing installer does - asks for password to access databases. By default it is
postgrespass
and there are no reasoons to change password.
Since when you enter password - it is hidden, to not make mistake, is recomended to open Notepad and type it there - you will see it, then copy-paste password in installer (2 times).

A5.5. Finish installation: do not change any (left port = 5432), press Next on all screens and wait till PostgreSQL will be installed. On the last screen disable Launch Stack builder, we do not need it.


A6. Now we test PostgreSQL installation
A6.1. Right click on Taskbar - start Task Manager, go to Processes and search for 5 or 6 entries (depends on Postgres version) of process postgres.exe and one pg_ctl.exe.

When HM will start - number of processes can exceed 20 - this is normal

A6.2. Do Start - Programs - Postgresql - PGAdmin
When program opens, do right click on server at the left - you will be asked for password (see A5.4), check "Save", on warning appeared also put a check - to make eventual future use of Pgadmin easier.
Expand a tree - you will see only one database so far, named "postgres" - this is internal DB for system needs.

A6.3. Additionally: you can see PostgreSQL version in server properties (sometimes this can be asked by support).


A6.4. That's all with PostgreSQL, setup completed.

B. Installation of Holdem Manager 2
B1. Download from here full HM2 installer. For this file make all described in A2.1 and A5.1, start it and agree with all Setup offers (including path, see comments above). During installation you will see a detection of the fact PostgreSQL already is installed on PC.


B2. Next you will be asked for credentials to access your personal page on HM site (i.e. email address and password). Please note: HM asks password to HM site, NOT to your email inbox.
Next you should or enter HM license key (if you have it), or press TRY button to start using trial. But trial will not work without HM site credentials - registration on HM site is obligatory.

B3. After this - select PC# on which you are going to activate HM2. You are allowed to use two activations, but they can be reseted on your page on HM site).


C. Creating a database and setting up path to the DBParent folder
C1. Create a folder in desired location, name it (example)
D:\HM2Parent
And apply to it all described in A4.2 for user "everyone".
To be exact, this is not obligatory, but recomended - to prevent eventual wrong reaction of antiviruses etc

C2. After activation HM2 runs Setup Wizard and offers to create a database. Disable checkmark on "default path" and set there a folder you created in C1.
C2.1. (FYI): As you have noticed before changing path, default folder location is here
%appdata%\HoldemManager\Database
How to find it:
Copy the following text
%appdata%\holdemmanager\
(including percent symbols)
Then open My Computer and paste in address line, press Enter
Now you see "real" path to the default folder, without using Windows system variable.
HM2 keeps all work files and settings in this folder, so you can be asked by support to send some files from there in case of issues with HM2.

C3. You can also change database name in the upper field - but this is up to you.


C4. Task finished. All custom settings for HM installation are done.
On next steps HM will ask if you want to import HM1 or Elephant database - this is a matter of another article.

C5. Please note: from now on all databases you create in HM2 will use that path to Parent folder.

Appendix:
Where HM2 keeps data
Unlike HM1, Holdem Manager 2 keeps data not only in PostgreSQL database.
But also in a special folder AKA "HMParent" - there is about 1/2 of information HM2 uses in it. HMParent contains subfolders for every player in database, with files where hands are saved in a special format.
Default path is
%appdata%\HoldemManager\database\DB_name
(how to change it for existing DB - see here http://hm2faq.holdemmanager.com/ques...e+or+Partition )

Exactly this data HM2 preloads in RAM on every start - you can see "Preloading hands" message. Not all, but Active player hands. And this is a source HM2 loads data in reports from.

Another half of data is stored in PostgreSQL database. HM2 uses it to show HUD stats.
But Postgres itself is not aware of Parent existance. Because of this is highly NOT recomended to delete HM2 databases using Pgadmin. You should use HM2 interface itself for this (Database - red minus), otherwise files in Parent folder will remain orphaned and futile on disk - but they usually take much space.