Upgradation Procedure

Note:
Before upgrading Apache make sure to upgrade to the latest nltk_data. For upgrading nltk_data, refer to section 2.5.2
  1. Download the latest file Apache24.zip from above Path mentioned in source field table above.
  2. Press “Win+R”, type “services.msc” and press Enter.
    Figure 1. Apache Server Upgradation
  3. Click on “Apache2.4” service and then click “Stop” the service on the left panel to stop the service.
    Figure 2. Apache Server Upgradation (Cont.)
    A screenshot of a computer Description automatically generated
  4. Stop all the services created using older version of Apache. You can find them by looking at the description pane of the service.
  5. The description would start with “Apache/2.4.x….”.
    (e.g., “HCL.iAutomate.EntityModel”, “HCL.iAutomate.iCrawler”, “HCL.iAutomate.iKnowledge”, “HCL.iAutomate.iKnowledgeIndexer”, “HCL.iAutomate.iKnowledgeScreen”, “HCL.iAutomate.iKnowledgeSearch”, “HCL.iAutomate.iParse”, “HCL.iAutomate.iRecommend”, “HCL.iAutomate.iScript” , “HCL.iAutomate.iUnique”, “HCL.iAutomate.RatingMongo”).
    Figure 3. Apache Server Upgradation (Cont.)
    A screenshot of a computer Description automatically generated
  6. Go to “C:\” in the file explorer. Take backup of the previous version by renaming the folder from “Apache24” to “Apache24_Old”.
  7. Extract the downloaded Zip file named “Apache24.zip” mentioned in the step 1.
  8. Open the extracted folder and COPY the folder name “Apache24” to the desired location.

    e.g.: C:\Apache24

  9. Go to Control Panel🡪 System and Security 🡪 System 🡪 Advanced System Settings. Click Environment Variables. A new dialog box appears. Check the Variable name ANT_HOME and variable path is set to current Apache24 path.
  10. If you are upgrading the whole iAutomate application, then skip the next two steps (Steps 11 &12). If only the Apache version is upgraded, then continue with step 11.
  11. Navigate to the path “Apache24_Old\bin” and COPY the dlls named “HCL.iAutomate.EncryptDecrypt.dll”, “BouncyCastle.Crypto.dll”,” Newtonsoft.Json.dll”
  12. Navigate to the folder path “Apache24\bin” and PASTE all the dll files copied from older Apache folder.

    e.g., C:\Apache24\bin

  13. After pasting the dll files in bin folder, follow the steps below,
    1. Right-click on each dll file.
    2. Choose Properties from the context menu.
    3. Under the General tab, scroll to the bottom where it says "Security" or "Attributes."
    4. If the file is blocked, you'll see an option labeled "Unblock."
    5. Tick the "Unblock" checkbox.
    6. Click Apply, then press OK to confirm.

    This will unblock the file and remove any security restrictions. Refer below screenshot.

    Figure 4. Apache Server Upgradation - Unblock DLL file
    A screenshot of a computer error Description automatically generated
  14. Navigate to the folder path “Apache24_Old \conf” and COPY all the “.conf” files except httpd.conf (e.g., Entity.conf, iKnowledge.conf, iknowledgeCrawler.conf, iKnowledgeIndexer.conf, iKnowledgeScreen.conf, iKnowledgeSearch.conf, iParse.conf, iRecommend.conf, iScript.conf, iUnique.conf, ratingMongo.conf).
    Note:
    Don’t COPY any folder.
    Figure 5. Apache Server Upgradation (Cont.)
  15. Navigate to the folder path “Apache24\conf” and PASTE all the files copied from older Apache folder.

    e.g., C:\Apache24\conf

  16. Open all the .conf files mentioned in point 5 in notepad++ and add the below lines if they are not already present. These lines can be found between line no 553 to 558.
    <IfModule mpm_winnt_module>
     ThreadStackSize 393216
     </IfModule>
    Figure 6. Apache Server Upgradation (Cont.)
    A screen shot of a computer Description automatically generated
  17. Open the .conf files in notepad++ and check for the below lines to see if they are present or not. These lines can be found between line no 564 to 568.
    Note:
    Check for the below 3 Lines, if these have a path other than ‘PythonCertificate’, then only follow the next 2 steps (Steps 16 and 17) else skip these steps.
    SSLCertificateFile "${PythonCertificate}/server.crt"
    SSLCertificateKeyFile "${PythonCertificate}/server.key"
     SSLCACertificateFile "${PythonCertificate}/ca.pem"

    Old lines:

    Figure 7. Apache Server Upgradation (Cont.)
    A black text on a white background Description automatically generated

    Replace with updated lines and add the variable name by performing the following two steps (Steps 17 & 18):

    Figure 8. Apache Server Upgradation (Cont.)
    Black text on a white background Description automatically generated
  18. Find the current location where the certificates are located. e.g.: (C:/Program Files/Certificate or E:/certificate)
  19. Create system environment variable name PythonCertificate with path value as the above path where certificates are located. In below figure we pasted the documents in E:/certificate which can be any path
    Figure 9. Apache Server Upgradation (Cont.)
    C:\Users\spavith\Downloads\image (3).png
  20. Open the .conf files in notepad++ and check for the below lines present or not. If not, add these lines between line no 35 to 40.
    Define SRVROOT "/Apache24"
    ServerRoot "${SRVROOT}"
    PidFile "${SRVROOT}/httpd.pid"
  21. By default, TLS1.3 will be enabled on Apache, if needed go with any specific version by following these steps else continue with the step 21:
    1. Check for the version which needs to be enabled, from the lines.
      # To enable SSL protocol TLS1.1 uncomment the below line
      #SSLProtocol -all +TLSv1.1
      # To enable SSL protocol TLS1.2 uncomment the below line
      #SSLProtocol -all +TLSv1.2
      # To enable SSL protocol TLS1.3 uncomment the below line
      #SSLProtocol -all +TLSv1.3
      # To enable and integrate SSL protocol TLS1.2 and TLS1.3 uncomment the below line
      #SSLProtocol -all +TLSv1.2 +TLSv1.3
      # To enable SSL protocol till TLS1.2 uncomment the below line
      #SSLProtocol +SSLv2 +SSLv3 +TLSv1 +TLSv1.1 +TLSv1.2
      
    2. If needed to go with TLS1.2 then uncomment, and copy paste the line in the specified conf file just below the line “SSLEngine on” and save the file. E.g.: TLS 1.2 enabled in the below screenshot.
      Figure 10. Apache Server Upgradation (Cont.)
  22. Follow these steps for all the components that are specified in Step 5.
  23. Press “Win+R”, type “services.msc” and press Enter.
    Figure 11. Apache Server Upgradation (Cont.)
  24. Click on “Apache2.4” service and then click START the service on the left panel to start the service.
    Figure 12. Apache Server Upgradation (Cont.)
    A screen shot of a computer Description automatically generated
  25. You can validate the Apache version from the description of the service.
  26. Similarly, start all the Apache services that you stopped in step 4. If the services are not getting started, then follow the below section.