This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
niota-docs:niota_install [2021/11/11 09:49] admin created |
niota-docs:niota_install [2025/07/17 14:11] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | niota table management suite consists of the components listed below. Please mind to install all the components in the correct order. | + | === Installation guide === |
| - | N-TAMS is the abbreviation for the suite. | + | There are several components that must be available on your server for valid installation. |
| - | niota metadata database on a proper MySQL server. | + | niota is a PHP application which needs an application server to process the PHP pages. Therefore both must be available on your server. |
| - | N-MDDB is the abbreviation for this component. | + | |
| - | niota php-application on a proper application server. | + | |
| - | N-PAPP is the abbreviation for this component. | + | |
| - | niota dokuwiki-online documentation on a proper application server. | + | |
| - | N-ODOC is the abbreviation for this component. | + | |
| + | Please follow the steps this page to ... | ||
| + | [[niota_install_apache | install apache application server]] | ||
| - | It’s recommend to install niota metadata db (NMDDB) outside of the niota php-application (NPAPP). NPAPP and NMDDB are fixed and released independently. When you install the NMDDB MySQL server inside the application then you connect components where releases and changes are not connected necessarily. | + | Most of your configuration settings are stored in the so called "meta database". This meta database is a MySQL database and can be installed on your server on several different ways. Below you can find some descriptions for the different approaches, starting from the easiest approach to the most difficult approach. |
| - | + | ||
| - | Visit niota downloadpage and download the all desired zip-file for of niota table management suite (NTAMS). | + | |
| - | + | ||
| - | The download contains a portable MySQL server with a pre-installed empty NMDDB. You can use this to setup niota very quickly. | + | |
| - | In the NPAPP there is also a folder where all the object that are part of the NMDDB are scripted. With this scripts you can create a NMDDB also on your own MySQL server. This is just in case you are not allowed to run a standalone MySQL server for niota. | + | |
| - | use embedded MySQL server and install niota metadata database (N-MDDB) it as a service | + | [[niota_install_meta | install niota metadata database ]] |
| - | If MySQL is already running and listening on the same port as you want to run niota then you have to change your niota port or stop the other MySQL server. | + | |
| - | Execute listed tasks step by step in the given order | + | [[niota_install_meta_manually | install niota metadata database manually ]] |
| - | • unzip downloaded NMDDB zip-file | + | [[niota_install_meta_restore | install niota metadata database from a backup ]] |
| - | • move extracted folder to target location | + | |
| - | • rename the folder to your needs | + | |
| - | Recommendation: Remove the detailed version info. | + | |
| - | e.g. rename “niota-meta-80_v2.1.21308” to “niota-meta_v2” | + | |
| - | • navigate to the mysql-<version> - folder and check the configured port in configuration file my.ini | + | |
| - | Default port 3366 is configured. If you have to change this, then set your desired port number here. If you change the port for NMDDB you must edit also your connections.php file in NPAPP and set this port number here as well. | + | |
| - | • open windows command prompt in admin mode | + | |
| - | • navigate to your mysql-folder into the \bin\ - subfolder | + | |
| - | • run command: mysqld --install <servicename> | + | |
| - | Recommendation: Add the primary NPAPP version number or/and the primary NMDDB version to the service name. So possible servicenames would be | + | |
| - | MySQL_niota_40_21 --- niota php-application 4.0.x / metadata version 2.1 | + | |
| - | MySQL_niota_41_21 --- niota php-application 4.1.x / metadata version 2.1 | + | |
| - | This naming conventions can be useful if you want to upgrade NPAPP to a higher release and run the active release and the next release in parallel. | + | |
| - | Recommendation: Start NMDDB in a console mode before you install it as a service. To achieve this run command: mysqld –console | + | |
| - | press CTRL+C to quit MySQL console mode | + | |
| - | • Set description of service with sc (service control manager) command | + | |
| - | run command: sc description <servicename> "description" | + | |
| - | e.g. sc description MySQL_niota_40_21 “niota 40 metadata” | + | |
| - | • go to windows services and start the service. | + | |
| - | install niota PHP-applicaction (N-PAPP) on Apache | + | The application itself is set of PHP files and configuration settings. See here how to |
| - | • visit download page and download proper release for N-PAPP | + | [[niota_install_app | install niota application ]] |
| - | • copy unzipped folder into folder: ‘Apache\document-root’. | + | |
| - | The document-root directory of Apache by default is “Apache\htdocs” folder. It is defined in file “Apache\conf\httpd.conf”. E.g.: DocumentRoot "${SRVROOT}/htdocs" | + | |
| - | • rename the folder to your needs | + | |
| - | Recommendation: remove detailed version information from the folder name. | + | |
| - | • navigate to “app\conf” -folder and rename file “connections_demo.php” to “connections.php”. | ||
| - | |||
| - | By this you set the preconfigured demo connections as the active niota connections. | ||
| - | Check in connctions.php if the MySQL server port for N-MDDB is set correctly and matches with the port configured in my.ini | ||
| - | If you have already a valid and well configured connections.php-file from a previous release copy this file to this folder. | ||
| - | • check if Apache and PHP is up and running | ||
| - | • open a browser window and enter the login – URL | ||
| - | “http://<my_host>/<my_niota_path>/app/login.php”. | ||
| - | If your N-MDDB is not up and running you cannot log in yet. Without N-MDDB you can check only the load of the login screen. | ||
| - | • on the login screen you can login with the default user “superuser” | ||