Make Mentat executable from within the cloned Git repository

assigned to @Jan_Mach

By Jan Mach on 2024-12-26T14:06:05

added C-Docu Done 0% P4 S-New T-Task labels

changed milestone to %Backlog

changed milestone to %2.2

changed milestone to %2.3

changed milestone to %2.4

added Done 10% S-In Progress labels and removed Done 0% S-New labels

added Done 100% S-Closed labels and removed Done 10% S-In Progress labels

Radko, could you please walk through these installation instructions and attempt to install working Mentat instance from Debian package and local Git repository to verify the installation instructions. I am striving to make the installation process as simple as possible and if you are not able to have working instance in half an hour this task should be improved further.

I would like another set of eyes to look through it, because after working on it I am biased.

Please install development version, necessary code changes are not yet merged to the master/production branch.

By Jan Mach on 2019-05-14T09:20:00

assigned to @radko_krkos and unassigned @Jan_Mach

By Jan Mach on 2024-12-26T14:14:28

added Done 90% S-Feedback labels and removed Done 100% S-Closed labels

added P3 label and removed P4 label

I have tested the instructions for manual installation.

Here are some other remarks:

What I am missing is a mention that the steps have to be run as root. Using sudo (in various places where required) will not result in a working installation as the environment is very different from what seems to be expected. (I have not tested this thoroughly, I might have been trying to install the stable version [2.3.2] at the time).
I advise to include the installation commands for postgresql and ip4r and the mention that the server must listen on port 5432. For a clean installation, it would be highly beneficial. We should not expect the Mentat admin to be a PostgreSQL admin also (or to read the documentation to a third-party extension).
The development documentation should probably reference the development repositories for mentat, not the stable ones (steps 2 and 3).
In step 9, the /etc/mentat/scripts/sqldb-migrate.sh stamp head command has to be run inside the venv, otherwise it fails with alembic: command not found

Unfortunately it took me quite a bit longer than the agreed limit of half and hour to get the mentat working.
I have not yet tried the git repository instructions.

By Radko Krkoš on 2019-05-15T16:46:47

@radko_krkos wrote:

I have tested the instructions for manual installation.

Here are some other remarks:

What I am missing is a mention that the steps have to be run as root. Using sudo (in various places where required) will not result in a working installation as the environment is very different from what seems to be expected. (I have not tested this thoroughly, I might have been trying to install the stable version [2.3.2] at the time).

Done.

I advise to include the installation commands for postgresql and ip4r and the mention that the server must listen on port 5432. For a clean installation, it would be highly beneficial. We should not expect the Mentat admin to be a PostgreSQL admin also (or to read the documentation to a third-party extension).

Done, added section about installation of prerequisites.

The development documentation should probably reference the development repositories for mentat, not the stable ones (steps 2 and 3).

Sadly, this is not possible. To my knowledge and according to my research RST does not allow variable substitutions in code blocks.

In step 9, the /etc/mentat/scripts/sqldb-migrate.sh stamp head command has to be run inside the venv, otherwise it fails with alembic: command not found

Done.

Unfortunately it took me quite a bit longer than the agreed limit of half and hour to get the mentat working.
I have not yet tried the git repository instructions.

By Jan Mach on 2019-05-22T16:53:41

Pavel, during our conference you have volunteered to perform another test installation. Do you still have time to do it? If not, we can close the issue a polish the instructions later. I think, that all changes at this point should be purely cosmetic, as I have already tested the installation many times.

By Jan Mach on 2019-05-22T16:57:22

assigned to @ph and unassigned @radko_krkos

By Jan Mach on 2024-12-26T14:14:29

added Done 100% label and removed Done 90% label

Ok, let`s close this issue, so we can close the whole version.

By Jan Mach on 2019-07-11T14:32:07

added S-Closed label and removed S-Feedback label

closed

Make Mentat executable from within the cloned Git repository

Designs

Child items ...

Activity