Installing & Configuring Apache: Difference between revisions

From NEOSYS Technical Support Wiki
Jump to navigationJump to search
(Minor format changes & rephasing of first step)
m (Minor improvements)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
The majority of Apache installation and configuration is performed by ~/Nextcloud/Support/IT/initapache_v47.sh script.
The majority of Apache installation and configuration is performed by ~/Nextcloud/Support/IT/initapache_v<LATESTVERSIONNO>.sh script.


(In the following commands, replace <XXX> with corresponding value)
In the following commands, replace <XXX> with corresponding value.




1. If installing NEOSYS on client hosted server continue to step 2, otherwise if installing on NEOSYS hosted server i.e win3 then skip to step 9.  
If installing NEOSYS on client hosted server continue to step 1, otherwise if installing on NEOSYS hosted server i.e win3 then skip to step 9.  


2. Copy the installation script to the server's D drive.  
#Copy the Apache installation script to the server's D drive. <br> <pre>scp -P <SSHPORTNO> ~/Nextcloud/support/IT/initapache/initapache_v<LATESTVERSIONNO>.sh administrator@<HOSTNAME>.hosts.neosys.com:/cygdrive/d/</pre>
<pre>scp -P <SSHPORTNO> ~/Nextcloud/support/IT/initapache_v<LATESTVERSIONNO>.sh administrator@<HOSTNAME>.hosts.neosys.com:/cygdrive/d/</pre>
#Open Cygwin as administrator on server. (Shift + Right click) and convert the installation script into dos format. (Otherwise script execution will contain syntax errors "\r", due to the different characters use by Linux and windows for new lines)<pre>d2u D:/initapache_v47.sh</pre>
3. Open Cygwin as administrator on server. (Shift + Right click) and convert the installation script into W indows format. (Otherwise script execution will contain syntax errors "\r", due to the different characters use by Linux and windows for new lines)<pre>d2u D:/initapache_v47.sh</pre>
#Execute script. <br> <pre>./initapache_v47.sh <CLIENTHOSTNAME>" </pre>
5. Execute script.
#Script will do some verifications on system and if all test are okay, and when prompted enter 'Y' to start installation.
<pre>./initapache_v47.sh <CLIENTHOSTNAME>" </pre>
#Microsoft Visual C++ 2015-2019 installation window will popup, follow the steps to install. (If already installed like on win3, hit cancel)
6. The script will proceed to do a number of verifications on system. If all test are okay, enter 'Y' to start installation as prompted to do so.
#Script will prompted to install the certificates from nl19/bkup. Follow the instructions to edit distributecerts.sh in nl19 ~/. (script simply copies latest LetsEncrypt certificate files into Apache24/conf/*.pem)
<pre>
#If the client is on win3, add the new client site to D:\Apache24\conf\neosys2.conf using existing clients as an example. (Make sure to arrange in alphabetical order)
Verify OK to proceed
#Ensure a NEOSYS process running and test if you can access NEOSYS Login:
--------------------
#*NEOSYS hosted and Client hosted test https://<CLIENTHOSTNAME>.hosts.neosys.com
Port: 443
#*Client hosted use http://localhost
Dir:  D:/neosys/neosys.net
#In the new client's NEOSYS/DATA folder, create a text file, enter '720' and save as 'DATA.CFG'.
Root: /d
-------------------------------------
OK to start? (Y=Yes)
</pre>
7. A Microsoft Visual C++ 2015-2019 installation window will popup, follow the steps to install. (If already installed like on win3, hit cancel)


8. Then you will be prompted to install the certificates from nl19/bkup. Follow the instructions to edit /distributecerts.sh. (This script simply copies latest LetsEncrypt certificate into D:/Apache24)
For any issues check the initapache.sh script and neosys.conf files for solutions.
 
9. After the script has finished, create a Windows scheduled task to restart Apache hourly to load any newly renewed HTTPS certificates.
<pre>Action: D:\Apache24\bin\httpd.exe -k restart</pre>
10. If the client is on win3, add the new client site to D:\Apache24\conf\neosys2.conf using existing clients as an example. (Make sure to arrange in alphabetical order)
 
11. Test if you can access NEOSYS login.
 
*If on client hosted server use: http://localhost
*If on win3 use https://<CLIENTHOSTNAME>.hosts.neosys.com
 
12. In the new client's NEOSYS/DATA folder, create a text file, enter '720' and save as 'DATA.CFG'.
 
For any issues check the initapache.sh script and neosys.conf file for solutions.

Latest revision as of 07:15, 1 February 2021

The majority of Apache installation and configuration is performed by ~/Nextcloud/Support/IT/initapache_v<LATESTVERSIONNO>.sh script.

In the following commands, replace <XXX> with corresponding value.


If installing NEOSYS on client hosted server continue to step 1, otherwise if installing on NEOSYS hosted server i.e win3 then skip to step 9.

  1. Copy the Apache installation script to the server's D drive.
    scp -P <SSHPORTNO> ~/Nextcloud/support/IT/initapache/initapache_v<LATESTVERSIONNO>.sh administrator@<HOSTNAME>.hosts.neosys.com:/cygdrive/d/
  2. Open Cygwin as administrator on server. (Shift + Right click) and convert the installation script into dos format. (Otherwise script execution will contain syntax errors "\r", due to the different characters use by Linux and windows for new lines)
    d2u D:/initapache_v47.sh
  3. Execute script.
    ./initapache_v47.sh <CLIENTHOSTNAME>" 
  4. Script will do some verifications on system and if all test are okay, and when prompted enter 'Y' to start installation.
  5. Microsoft Visual C++ 2015-2019 installation window will popup, follow the steps to install. (If already installed like on win3, hit cancel)
  6. Script will prompted to install the certificates from nl19/bkup. Follow the instructions to edit distributecerts.sh in nl19 ~/. (script simply copies latest LetsEncrypt certificate files into Apache24/conf/*.pem)
  7. If the client is on win3, add the new client site to D:\Apache24\conf\neosys2.conf using existing clients as an example. (Make sure to arrange in alphabetical order)
  8. Ensure a NEOSYS process running and test if you can access NEOSYS Login:
    • NEOSYS hosted and Client hosted test https://<CLIENTHOSTNAME>.hosts.neosys.com
    • Client hosted use http://localhost
  9. In the new client's NEOSYS/DATA folder, create a text file, enter '720' and save as 'DATA.CFG'.

For any issues check the initapache.sh script and neosys.conf files for solutions.