This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
niota-docs:niota_install_meta [2025/05/08 14:52] admin [Windows - setup MySQL] |
niota-docs:niota_install_meta [2025/07/17 14:11] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== install MySQL DBMS ===== | + | ===== Introduction ===== |
| - | Download the MySQL version from the official download page and copy the unzipped folder to target location on your server. | + | To run niota, you need a [[niota_glossary|MySQL]] [[niota_glossary|DBMS]] to which you add the metadata database ([[niota_glossary|N-MDDB]]). It depends on the requirements of your IT department which way you have to choose to set up N-MDDB. The possible options are. |
| - | Check [[niota-docs:niota_requirements|System Requirements niota]] for highest supported MySQL version. | + | |
| - | Continue with "Windows - set up MySQL" | + | * "A" install a dedicated niota MySQL server with a pre-installed N-MDDB |
| + | * "B" install a dedicated MySQL server and add the N-MDDB | ||
| + | * "C" add a pre-configured N-MDDB to an existing MySQL server | ||
| + | * "D" create new N-MDDB from MySQL scripts (the hard way) | ||
| + | Please check [[niota_requirements|system requirements]] for valid combinations of niota application and MySQL server. | ||
| - | ===== install MySQL DBMS with predefined niota metadata database (N-MDDB) ===== | + | ---- |
| - | The download contains a portable MySQL server with a pre-installed empty N-MDDB. You can use this to set up niota very quickly. | + | |
| + | ===== ''A'' install MySQL DBMS with predefined N-MDDB ===== | ||
| + | Download the MySQL Server from the [[niota-docs:niota_links|niota download page]]. The download contains a portable MySQL server with a pre-installed empty N-MDDB. You can use this to set up niota very quickly. | ||
| ** Please check the version of the meta database included in this download ** It has to fit the required version of you niota web application. | ** Please check the version of the meta database included in this download ** It has to fit the required version of you niota web application. | ||
| + | Continue with [[niota_install_meta_Windows| Windows - set up MySQL]].\\ | ||
| + | |||
| + | ===== ''B'' install MySQL DBMS ===== | ||
| + | Download the MySQL version from the official download page and copy the unzipped folder to target location on your server. | ||
| + | Check [[niota-docs:niota_requirements|System Requirements niota]] for highest supported MySQL version. | ||
| - | Another option is to download the accessory tools for niota and run all the scripts to set up database step by step. In this accessory folder you can find a /bin folder where all the executables are stored. This is just in case you are not allowed to run a standalone MySQL server for niota or you want to set up database on our own. | + | Continue with [[niota_install_meta_Windows| Windows - set up MySQL]].\\ |
| + | Then continue with option C or D | ||
| - | === use embedded MySQL server and install niota metadata database (N-MDDB) as a service === | ||
| - | If MySQL server 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. | + | ===== ''C'' add/restore N-MDDB to a MySQL DBMS ===== |
| + | If as MySQL server is already up and running you can add a metadata database to this server. | ||
| + | Download the accessory tools or a provided empty metadata database backup from the [[niota_links|niota download page]]. | ||
| + | Follow the steps listed [[niota_accessory_do_manage_metadb|here]] to add a metadata database to you MySQL DBMS. | ||
| - | Execute listed tasks step by step in the given order | + | ===== ''D'' set up N-MDDB on a MySQL DBMS ===== |
| + | Download the accessory tools for niota and run all the scripts to set up database step by step. In this accessory folder you can find a **''/bin''** folder where all the executables are stored. This is just in case you are not allowed to run a standalone MySQL server for niota or you want to set up database on our own. Read carefully the docu of the [niota_install_meta_manually|manual set up procedure]] and run it step by step. | ||
| + | |||
| + | ==== Windows - setup MySQL ==== | ||
| + | |||
| + | In case of upgrade to a new MySQL server version you can use only one MySQL server at the same time on the same port. In case you want the check how niota works with new MySQL server and then again switch back to old MySQL server you have to shut down always the other. | ||
| + | **There must not be two server listening on the same port** | ||
| + | |||
| + | If you want to run both server at the same time you can configure niota **''..\connections.php''** to switch from one server to the other. | ||
| - | * unzip downloaded NMDDB zip-file | ||
| - | * move extracted folder to target location | ||
| - | * rename the folder to your needs | ||
| **Recommendation:** | **Recommendation:** | ||
| - | ---- | + | Remove the detailed version info from you target folder. |
| - | Remove the detailed version info. | + | |
| - | e.g. rename “niota-meta-80_v2.1.21308” to “niota-meta_v2” | + | e.g. rename “niota-meta-80_v2.1.21308” to “niota-meta_v2” |
| - | ---- | + | |
| - | + | ||
| - | ==== Windows - setup MySQL ==== | + | |
| * navigate to the mysql-<version> - folder and check the configured port in configuration file my.ini | * navigate to the mysql-<version> - folder and check the configured port in configuration file my.ini | ||
| - | Default port 3306 is configured. If you have to change this, then set your desired port number here. If you change the port for N-MDDB you must edit also your connections.php file in N-PAPP and set this port number here as well. | + | Default port 3306 is configured. If you have to change this, then set your desired port number here. If you change the port for N-MDDB you must edit also your **''..\connections.php''** file in N-PAPP and set this port number here as well. |
| * set your ''data'' directory. | * set your ''data'' directory. | ||