Merge pull request #60 from dreamfactorysoftware/win-oracle-install

Win oracle install

Author: nicdavidson

docs/Installing DreamFactory/windows-installation.md

@@ -203,7 +203,7 @@ The v17 and v18 drivers should have been installed during the previous steps, if
 
 Open the Windows_5.12.0RTW.zip downloaded earlier, in the x64 folder there should be 4 .dll files. Copy/paste the **two** nts (Non Thread Safe) .dll into your php ext folder (`C:\php\ext\`)
 
-Then, rename both files removing the "_81_nts" at the end of the filename. The files are named:
+Then, rename both files removing the "_83_nts" at the end of the filename. The files are named:
 
 - php_pdo_sqlsrv.dll
 - php_sqlsrv.dll
@@ -363,3 +363,47 @@ After completing the setup, you can navigate to the server's IP address or hostn
 ## Adding SSL
 
 For details on adding SSL, DreamFactory recommends using [certbot](https://certbot.eff.org/instructions?ws=other&os=windows). Follow the instructions from the provided link to help you through the process. 
+
+## Installing Oracle Driver
+The process of installing Oracle drivers is a more manual process than with our Linux installers. To begin you will need to download 3 things:
+- The Oracle "Basic" Instant Client package from [Oracle's Website](https://www.oracle.com/database/technologies/instant-client/winx64-64-downloads.html) (Example file instantclient-basic-windows.x64-23.7.0.25.01.zip)
+- The Oracle “SDK” Instant Client Package from [Oracle's Website](https://www.oracle.com/database/technologies/instant-client/winx64-64-downloads.html) (Example file instantclient-sdk-windows.x64-23.7.0.25.01.zip)
+- The PHP oci8 extension (DLL) available at [Pecl PHP Site](https://pecl.php.net/package/oci8) By default, DreamFactory runs on PHP 8.3 so you will want the x64 package of that (version 3.2.1). If you are running DreamFactory using IIS as your webserver you must be using the non thread safe version of PHP.
+
+![Web Server Role selection](/img/windows-install/PeclDLLPage.png)
+- `Note you will want to click on the DLL button under downloads on the Pecl site for windows .dll files`
+- `Unless you have good reason, choose the appropriate DLLs with the NTS tag`
+
+- Next you will create a folder where the Oracle drivers will be kept, for example `C:\oracledrivers` and extract the Oracle "Basic" Instant Client there. The files will be extracted into a subdirectory called `instantclient_<version>.` Example:
+
+`C:\oracledrivers\instantclient23_7`
+
+- Next we will extract the "SDK" Instant Client to the same folder i.e. `C:\oracledrivers`. We want the SDK package to extract into the same subdirectory as in the previous step, not a new folder. Your driver folder should look like this:
+
+![Instant Client folder](/img/windows-install/instant-client-folder.png)
+
+- and the subdirectory should look like:
+
+![Instant Client subdirectory](/img/windows-install/instant-client-subdirectory.png)
+
+- Note that there is now an `SDK` folder inside.
+
+Next, we need to add the full path of the Instant Client to the environment variables OCI_LIB64 and PATH. The quickest way to get to Environment Variables is to use the windows search bar and search for "environment" click on Environment Variables and then:
+
+1. Under System Variables, create OCI_LIB64 if it does not already exist. Set the value of OCI_LIB64 to the full path of the location of Instant Client.
+
+![Environment variable path](/img/windows-install/env-variable-path.png)
+![OCI_LIB64 path](/img/windows-install/oci-env-path.png)
+
+2.Under System Variables, edit PATH to include the same (C:\oracledrivers\instantclient_23_7)
+
+`When utilizing the IIS web server, it is essential to include a new variable PATH in your FastCGI environment.`
+
+`For example, a new variable could be: %PATH%;C:\oracledrivers\instantclient_23_7.`
+
+The fastCGI path is located in the IIS Manager > Your Server > fastCGI Settings > Full Path > Edit > 3 dots next to collections
+
+![FastCGI path](/img/windows-install/fastcgi-path.png)
+
+Almost there! Now, the last thing to do is to extract our PHP OCI8 extension package (It will be named along the lines of php_oci8-3.2.1-8.3-nts-vc15-x64) and move the php_oci8.dll file to the ext directory where PHP is located on your system (e.g PHP\v8.3\ext). Once that is done add extension=php_oci8.dll to your php.ini file and then restart the IIS server (use php -m to make sure that the oci8 extension is installed). Congratulations!
+

static/img/windows-install/PeclDLLPage.png

@@ -1986,10 +1986,10 @@
   dependencies:
     "@types/mdx" "^2.0.0"
 
-"@node-rs/jieba-win32-x64-msvc@1.10.4":
+"@node-rs/jieba-darwin-arm64@1.10.4":
   version "1.10.4"
-  resolved "https://registry.npmjs.org/@node-rs/jieba-win32-x64-msvc/-/jieba-win32-x64-msvc-1.10.4.tgz"
-  integrity sha512-+sqemSfS1jjb+Tt7InNbNzrRh1Ua3vProVvC4BZRPg010/leCbGFFiQHpzcPRfpxAXZrzG5Y0YBTsPzN/I4yHQ==
+  resolved "https://registry.npmjs.org/@node-rs/jieba-darwin-arm64/-/jieba-darwin-arm64-1.10.4.tgz"
+  integrity sha512-G++RYEJ2jo0rxF9626KUy90wp06TRUjAsvY/BrIzEOX/ingQYV/HjwQzNPRR1P1o32a6/U8RGo7zEBhfdybL6w==
 
 "@node-rs/jieba@^1.6.0":
   version "1.10.4"