{{Stability-experimental}}

<div class="title">Apache Configuration</div>

__TOC__

To setup your development environment please follow these steps.

==Setup build system==
# Check out the UI from git
# Figure out Apache's document root. Common places are:<br>MacOS: /Library/WebServer/Documents<br>Linux: /var/www
# Create a new folder appsuite in Apache's document root
# You need node.js to build the UI. For MacOS (use /var/www instead of /Library/WebServer/Documents for debian).

===Installing node.js===
# Visit https://sites.google.com/site/nodejsmacosx/ and install stable version.
# Open terminal
# Set environment variable:<br>''export buildir="/Library/WebServer/Documents/appsuite"''
# Build UI: '''./build.sh'''
# Note: Instead of exporting the builddir every time your want to build the ui or run the appserver, you can also create a file '''local.conf''' and set the directory in there. This way, every time the buildsystem or appserver runs, it automatically picks up the correct directory.<br>local.conf: ''export buildir="/Library/WebServer/Documents/appsuite"''

===AppServer===
Run the app loading server: '''./appserver.sh''' Don't worry: If it doesn't tell you anything it's happily running.

==Apache config==
Make sure Apache loads the following modules:<br>''mod_proxy, mod_proxy_ajp, mod_expires, mod_deflate, mod_rewrite, mod_headers, mod_mime, and mod_setenvif''

Tell your Apache to process .htaccess files and how to connect to backend:

<pre class="language-conf">
ProxyPass /appsuite/api/apps/load/ http://localhost:8337/apps/load/
ProxyPass /appsuite/api ajp://127.0.0.1:8009/ajax
# optional parameters: retry=0 connectiontimeout=5 timeout=10

<Directory /Library/WebServer/Documents/appsuite>
Options None +FollowSymLinks
AllowOverride Indexes FileInfo
</Directory>

</pre>

Use the proper document root depending on your OS or custom configuration! If backend does not run on localhost (127.0.0.1), you have to adjust the ProxyPass directive.

'''Restart Apache''', e.g. sudo apachectl restart. And please double check everything you're doing!

==Setup SSL support on MacOS==

Based on: http://webdevstudios.com/2013/05/24/how-to-set-up-ssl-with-osx-mountain-lions-built-in-apache/

* Open terminal and go to '''/private/etc/apache2'''
* Become root: '''sudo su'''
* '''mkdir ssl'''
* Open the '''httpd.conf''' file in your text editor
** Make sure the SSL module is enabled if it’s not. Do this by uncommenting (aka, remove the ‘#’ symbol in front) the line that looks like: ''LoadModule ssl_module libexec/apache2/mod_ssl.so''
** In the same file search for and uncomment (remove the #) this line: ''Include
/private/etc/apache2/extra/httpd-ssl.conf''
** Save and close.
* Now open the '''httpd-ssl.conf''' file in your text editor
** Make sure '''ServerName''' line looks like: ''ServerName localhost''
** Modify '''ServerAdmin''' line to use one of your email addresses
** '''SSLCertificateFile "/private/etc/apache2/ssl/ssl.crt"'''
** '''SSLCertificateKeyFile "/private/etc/apache2/ssl/ssl.key"'''
** In the same file comment out (add a # to the beginning of the line) the '''SSLCACertificatePath''' and '''SSLCARevocationPath''' lines if they’re not already.
** Save and close.
* Now go to folder '''/private/etc/apache2/ssl'''
* '''openssl genrsa -des3 -out server.key 1024'''
* Pass-phrase can be anything stupid, we'll remove it
* '''openssl req -new -key server.key -out server.csr'''
* '''cp server.key server.key.org<br>openssl rsa -in server.key.org -out server.key'''
* '''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt'''
* Restart apache: '''apachectl restart'''

[[Category:AppSuite]]
[[Category:UI]]

AppSuite:Apache Configuration

2013-08-30T15:25:38Z

Mattes: /* Setup SSL support on MacOS */

{{Stability-experimental}}

<div class="title">Apache Configuration</div>

__TOC__

To setup your development environment please follow these steps.

==Setup build system==
# Check out the UI from git
# Figure out Apache's document root. Common places are:<br>MacOS: /Library/WebServer/Documents<br>Linux: /var/www
# Create a new folder appsuite in Apache's document root
# You need node.js to build the UI. For MacOS (use /var/www instead of /Library/WebServer/Documents for debian).

===Installing node.js===
# Visit https://sites.google.com/site/nodejsmacosx/ and install stable version.
# Open terminal
# Set environment variable:<br>''export buildir="/Library/WebServer/Documents/appsuite"''
# Build UI: '''./build.sh'''
# Note: Instead of exporting the builddir every time your want to build the ui or run the appserver, you can also create a file '''local.conf''' and set the directory in there. This way, every time the buildsystem or appserver runs, it automatically picks up the correct directory.<br>local.conf: ''export buildir="/Library/WebServer/Documents/appsuite"''

===AppServer===
Run the app loading server: '''./appserver.sh''' Don't worry: If it doesn't tell you anything it's happily running.

==Apache config==
Make sure Apache loads the following modules:<br>''mod_proxy, mod_proxy_ajp, mod_expires, mod_deflate, mod_rewrite, mod_headers, mod_mime, and mod_setenvif''

Tell your Apache to process .htaccess files and how to connect to backend:

<pre class="language-conf">
ProxyPass /appsuite/api/apps/load/ http://localhost:8337/apps/load/
ProxyPass /appsuite/api ajp://127.0.0.1:8009/ajax
# optional parameters: retry=0 connectiontimeout=5 timeout=10

<Directory /Library/WebServer/Documents/appsuite>
Options None +FollowSymLinks
AllowOverride Indexes FileInfo
</Directory>

</pre>

Use the proper document root depending on your OS or custom configuration! If backend does not run on localhost (127.0.0.1), you have to adjust the ProxyPass directive.

'''Restart Apache''', e.g. sudo apachectl restart. And please double check everything you're doing!

==Setup SSL support on MacOS==

Based on: http://webdevstudios.com/2013/05/24/how-to-set-up-ssl-with-osx-mountain-lions-built-in-apache/

* Open terminal and go to '''/private/etc/apache2'''
* Become root: '''sudo su'''
* '''mkdir ssl'''
* Make sure the SSL module is enabled if it’s not. httpd.conf: ''LoadModule ssl_module libexec/apache2/mod_ssl.so''
* In the same file search for and uncomment (remove the #) this line: ''Include /private/etc/apache2/extra/httpd-ssl.conf''
* Now open the '''httpd-ssl.conf''' file in your text editor
* Make sure '''ServerName''' line looks like: ''ServerName localhost''
* Modify '''ServerAdmin''' line to use one of your email addresses
* '''SSLCertificateFile "/private/etc/apache2/ssl/ssl.crt"'''
* '''SSLCertificateKeyFile "/private/etc/apache2/ssl/ssl.key"'''
* In the same file comment out (add a # to the beginning of the line) the '''SSLCACertificatePath''' and '''SSLCARevocationPath''' lines if they’re not already.
* Now go to folder '''/private/etc/apache2/ssl'''
* '''openssl genrsa -des3 -out server.key 1024'''
* Pass-phrase can be anything stupid, we'll remove it
* '''openssl req -new -key server.key -out server.csr'''
* '''cp server.key server.key.org<br>openssl rsa -in server.key.org -out server.key'''
* '''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt'''
* Restart apache: '''apachectl restart'''

[[Category:AppSuite]]
[[Category:UI]]

AppSuite:Apache Configuration

2013-08-30T15:10:10Z

Mattes:

AppSuite:Debugging the UI

2013-08-29T13:38:27Z

2013-07-11T07:40:30Z

Mattes: /* Setting default sender address */

<div class="title">MSISDN Support</div>

'''Abstract.''' In this article, the support for MSISDN is described in detail. It allows sending emails to and receiving email from phone numbers.
__TOC__
== Enabling MSISDN Support ==
MSISDN support is disabled by default. In order to enable this feature, you must define the capability '''msisdn'''. This is done by simply adding the word "msisdn" to the property "permissions" in '''/opt/openexchange/etc/permission.properties''':

<pre>
permissions=...,msisdn
</pre>

== Server Settings ==

=== Default configuration ===
By default, cellular_telephone1 (551) and cellular_telephone2 (552) are used for the phone number lookup. This setting applies for both the sender and the recipient dialogs. It can by configured as follows:

<pre class="language-javascript">
io.ox/contacts/msisdn/columns=['551', '552']
</pre>

=== Exemplary custom configuration ===
Adding another phone number is straight-forward. Just add it as follows, for example, telephone_other (553):

<pre class="language-javascript">
io.ox/contacts/msisdn/columns=['551', '552', '553']
</pre>

See [[HTTP_API#DetailedContactData|HTTP API]] for all relevant columns.

=== Setting default sender address ===
A phone number can also be configured as default sender address. This can be customized via the [[AppSuite:User_management#changeuser|changeuser]] interface. Relevant setting is ''defaultsenderaddress'':

<pre class="language-javascript">
./changeuser ... --defaultsenderaddress <stringvalue>
</pre>

AppSuite:MSISDN

2013-07-11T07:39:29Z

Mattes: /* Setting default sender address */