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_apache [2021/11/21 21:19] admin |
niota-docs:niota_install_apache [2025/07/17 14:11] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== install apache application server ==== | + | ===== install Apache application server ==== |
| + | You can download a pre-configured Apache from [[niota_links | niota download page]] or from an official Apache download page. Please check [[niota_requirements | system requirements]] for valid combinations of niota application and Apache application server. | ||
| - | === Prerequisites === | ||
| ---- | ---- | ||
| + | === Prerequisites === | ||
| + | |||
| * Microsoft Visual C++ 2015-2019 Redistributable (x64). | * Microsoft Visual C++ 2015-2019 Redistributable (x64). | ||
| - | You can find the installer on niota download page. | + | You can find the installer on [[niota_links | niota download page]]. |
| ---- | ---- | ||
| + | ==== Windows - install Apache ==== | ||
| - | === install apache === | + | === install Apache === |
| - | Execute listed tasks step by step in the given order | + | Unpack the downloaded file and copy the folder to drive’s root. |
| - | * Open .zip file and copy Apache 2.4 to the drive’s root. Eg.: “C:\Apache24x64” or “D:\ Apache24x64”. This is the recommended way according to Apache’s install guide. | + | Eg.: “C:\Apache24x64” or “D:\ Apache24x64”. |
| - | * Copy “php-7.3.8_x64” into folder: “C:\Program Files\”. | + | **This is the recommended by the to Apache’s install guide.** |
| - | * Open “Apache24x64\conf\httpd.conf” | + | |
| - | * Verify server root directory path at part: | + | * open **''..\conf\httpd.conf''** |
| - | * Define SRVROOT "C:/ Apache24x64" | + | * verify server root directory path at ''Define SRVROOT "c:/Apache24x64"'' |
| - | * Verify document root directory path. If you want to place Niota somewhere else than “htdocs” folder, change it, otherwise leave it as it is. | + | * verify document root directory path. If you want to place niota somewhere else than “htdocs” folder, change it, otherwise leave it as it is. |
| | | ||
| <code> | <code> | ||
| + | Define SRVROOT "c:/Apache24x64" | ||
| + | # ... | ||
| DocumentRoot "${SRVROOT}/htdocs" | DocumentRoot "${SRVROOT}/htdocs" | ||
| </code> | </code> | ||
| - | * Check if PHP path is correct at those lines: | + | ** You can install PHP now or later. Check [[niota_install_php | PHP install]] for further details.** |
| - | <code> | + | ** If you would like to use LDAP(S) go to page [[niota_system_config_ldap|set LDAPS authentication]].** |
| - | AddHandler application/x-httpd-php .php | + | |
| - | AddType application/x-httpd-php .php .html | + | |
| - | LoadModule php7_module "C:/Program Files/php-7.3.8_x64/php7apache2_4.dll" | + | |
| - | PHPiniDir "C:/Program Files/ php-7.3.8_x64" | + | |
| - | </code> | + | |
| - | * Check php configuration: | + | === install Apache as service === |
| - | * Navigate to file: “C:\Program Files\php-7.3.8_x64\php.ini” | + | |
| - | * Verify if paths are set correctly: | + | |
| - | * session.save_path = "C:\Apache24x64\tmp\" | + | |
| - | * extension_dir = "C:\Program Files\php-7.3.8_x64\ext" | + | |
| - | * If you would like to use LDAP(S) go to chapter “Set LDAPS authentication” on page 3. | + | |
| - | === install apache as service === | + | * stop Apache if running |
| - | + | * run command prompt in admin mode | |
| - | * Stop Apache if running | + | * navigate to folder: “Apache24x64\bin\” |
| - | * Run command prompt in admin mode | + | * run command: |
| - | * Navigate to folder: “Apache24x64\bin\” | + | |
| - | * Run command: | + | |
| <code> | <code> | ||
| Line 49: | Line 42: | ||
| </code> | </code> | ||
| - | * Open 'Local Services' window | + | In case you need to run the server with a specific service user you can do this: |
| - | * Right click on Apache2.4 -> Properties -> Log On tab -> fill 'This account' form | + | * open 'Local Services' window |
| + | * right click on Apache2.4 -> Properties -> Log On tab -> fill 'This account' form | ||
| - | === remove/uninstall apache service === | + | === remove/uninstall Apache service === |
| - | * Stop Apache service | + | * stop Apache service |
| - | * Navigate to “\bin” folder of that Apache installation which service you would like to remove (e.g.: C:\Apache24x64\bin\ ) | + | * navigate to “\bin” folder of that Apache installation which service you would like to remove (e.g.: C:\Apache24x64\bin\ ) |
| - | * Run command: | + | * run command: |
| <code> | <code> | ||
| httpd.exe -k uninstall -n "Apache24x64_niota” | httpd.exe -k uninstall -n "Apache24x64_niota” | ||
| </code> | </code> | ||
| + | |||
| + | === verify dll files for openssl - used by niota password encryption and LDAPS connection === | ||
| + | |||
| + | If the following three dll file are different in Apache24/bin folder than the ones in PHP folder it raises error during LDAPS connection or password encryption/decryption: | ||
| + | * libssl-1_1-x64.dll | ||
| + | * libcrypto-1_1-x64.dll | ||
| + | * libsasl.dll | ||
| + | |||
| + | These files must be copied **from ''PHP''** root folder **into ''Apache24/bin''** folder. It is recommended to back up original files of Apache. | ||
| + | |||
| + | Error message starts with //"Call to undefined function openssl_decrypt()..."// | ||
| + | |||