Created Deployment (markdown)
This commit is contained in:
jvelilla
125
Deployment.md
Normal file
125
Deployment.md
Normal file
@@ -0,0 +1,125 @@
|
|||||||
|
EWF Deployment
|
||||||
|
==============
|
||||||
|
|
||||||
|
##Apache on Windows
|
||||||
|
###Apache Install
|
||||||
|
|
||||||
|
- Check the correct version (Win 32 or Win64)
|
||||||
|
- Apache Version: Apache 2.4.4
|
||||||
|
- Windows: http://www.apachelounge.com/download/
|
||||||
|
|
||||||
|
###Deploying EWF CGI
|
||||||
|
|
||||||
|
####CGI overview
|
||||||
|
> A new process is started for each HTTP request. So if there are N request to the same CGI
|
||||||
|
> program, the code of the CGI program is loaded into memory N times.
|
||||||
|
> When a CGI program finished handling a request, the program terminates
|
||||||
|
|
||||||
|
1. Build EWF application.
|
||||||
|
|
||||||
|
ec config app.ecf target app_cgi finalize c_compile project_path .
|
||||||
|
Note: change app.ecf and target app_cgi based on your own configuration.
|
||||||
|
2. Copy the generated exe file and the www content.
|
||||||
|
|
||||||
|
```
|
||||||
|
Copy the app.exe and the folder www into a folder served by apache2, for example under
|
||||||
|
<APACHE_PATH>/htdocs
|
||||||
|
<APACHE_PATH> = path to your apache installation
|
||||||
|
Edit httpd.conf under c:/<APACHE_PATH>/conf
|
||||||
|
DocumentRoot "c:/<APACHE_PATH>/htdocs"
|
||||||
|
<Directory "c:/<APACHE_PATH>/htdocs">
|
||||||
|
AllowOverride All --
|
||||||
|
Require all granted -- this is required in Apache 2.4.4
|
||||||
|
</Directory>
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Check that you have the following modules enabled.
|
||||||
|
|
||||||
|
```
|
||||||
|
LoadModule cgi_module modules/mod_cgi.so
|
||||||
|
LoadModule rewrite_module modules/mod_rewrite.so
|
||||||
|
```
|
||||||
|
|
||||||
|
*Tip:*
|
||||||
|
To check the syntax of your httpd.conf file. From command line run the following.
|
||||||
|
|
||||||
|
$>httpd - t
|
||||||
|
|
||||||
|
####.htaccess CGI
|
||||||
|
http://perishablepress.com/stupidhtaccesstrics/
|
||||||
|
|
||||||
|
Options +ExecCGI +Includes +FollowSymLinks Indexes
|
||||||
|
AddHandler cgiscript exe
|
||||||
|
<IfModule mod_rewrite.c>
|
||||||
|
RewriteEngine on
|
||||||
|
RewriteRule ^$ $service [L]
|
||||||
|
RewriteCond %{REQUEST_FILENAME} !f
|
||||||
|
RewriteCond %{REQUEST_FILENAME} !d
|
||||||
|
RewriteCond %{REQUEST_URI} !$service
|
||||||
|
RewriteRule ^(.*)$ $service/$1
|
||||||
|
RewriteRule .* [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
|
||||||
|
</IfModule
|
||||||
|
|
||||||
|
Replace $service with the name of your executable service, for example app_service.exe
|
||||||
|
|
||||||
|
|
||||||
|
##Deploying EWF FCGI
|
||||||
|
|
||||||
|
- To deploy FCGI you will need to download the mod_fcgi module.
|
||||||
|
- You can get it from here http://www.apachelounge.com/download/
|
||||||
|
|
||||||
|
###FCGI overview
|
||||||
|
> FastCGI allows a single, longrunning process to handle more than one user request while keeping close to
|
||||||
|
> the CGI programming model, retaining the simplicity while eliminating the overhead of creating a new
|
||||||
|
> process for each request. Unlike converting an application to a web server plugin, FastCGI applications
|
||||||
|
> remain independent of the web server.
|
||||||
|
|
||||||
|
1. Build EWF application
|
||||||
|
|
||||||
|
ec config app.ecf target app_fcgi finalize c_compile project_path .
|
||||||
|
Note: change app.ecf and target app_fcgi based on your own configuration.
|
||||||
|
|
||||||
|
2. Copy the generated exe file and the www content
|
||||||
|
|
||||||
|
|
||||||
|
Copy the app.exe and the folder "www" into a folder served by apache2, for example under
|
||||||
|
<APACHE_PATH>/htdocs.
|
||||||
|
<APACHE_PATH> = path to your apache installation
|
||||||
|
Edit httpd.conf under c:/<APACHE_PATH>/conf
|
||||||
|
|
||||||
|
DocumentRoot "c:/<APACHE_PATH>/htdocs"
|
||||||
|
<Directory "c:/<APACHE_PATH>/htdocs">
|
||||||
|
AllowOverride All --
|
||||||
|
Require all granted -- this is required in Apache 2.4.4
|
||||||
|
</Directory>
|
||||||
|
|
||||||
|
Check that you have the following modules enabled.
|
||||||
|
|
||||||
|
LoadModule rewrite_module modules/mod_rewrite.so
|
||||||
|
LoadModule fcgid_module modules/mod_fcgid.so
|
||||||
|
|
||||||
|
By default Apache does not comes with fcgid module, so you will need to
|
||||||
|
download it, and put the module under Apache2/modules
|
||||||
|
|
||||||
|
####.htaccess FCGI
|
||||||
|
http://perishablepress.com/stupidhtaccesstricks/
|
||||||
|
|
||||||
|
Options +ExecCGI +Includes +FollowSymLinks Indexes
|
||||||
|
<IfModule mod_fcgid.c>
|
||||||
|
AddHandler fcgidscript .ews
|
||||||
|
FcgidWrapper $FULL_PATH/$service .ews
|
||||||
|
</IfModule>
|
||||||
|
<IfModule mod_rewrite.c>
|
||||||
|
RewriteEngine on
|
||||||
|
RewriteBase /
|
||||||
|
RewriteRule ^$ service.ews [L]
|
||||||
|
RewriteCond %{REQUEST_FILENAME} !f
|
||||||
|
RewriteCond %{REQUEST_FILENAME} !d
|
||||||
|
RewriteCond %{REQUEST_URI} !=/favicon.ico
|
||||||
|
RewriteCond %{REQUEST_URI} !service.ews
|
||||||
|
RewriteRule ^(.*)$ service.ews/$1 RewriteRule .* [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
|
||||||
|
</IfModule>
|
||||||
|
|
||||||
|
Replace $service with the name of your executable $service, for example app_service.exe
|
||||||
|
You will need to create an service.ews file, this file will be located at the same place where you
|
||||||
|
copy your app service executable.
|
||||||
Reference in New Issue
Block a user