From Ape Wiki

Jump to: navigation, search

Contents

[edit] Simple configuration

If you are running APE on your local computer, and you don't want to work with your APE server when you are offline, go to Simple APE configuration.

[edit] Advanced configuration

There is two different ways to use the APE Server on a dedicated server :

[edit] Configure your server/computer

To use APE feature (such as multi tabing/windowing, your domain name must be configured in a certain way.

[edit] If you use APE on a server

You need to do :

  • Create a subdomain pointing to the server where APE is installed. For exemple, the subdomain of yourdomain.com is ape.yourdomain.com
  • Create a Catch-All CNAME redirecting all the request *.ape.yourdomain.com

Edit your dns configuration.

If you use bind9 add those line to your zone file :

ape     IN    A        x.x.x.x  ; The IP address of your APE server
*.ape   IN    CNAME    ape

[edit] If you use APE on your local computer

Edit your /etc/host file and add the folowing line :

/etc/hosts :

127.0.0.1 ape-test.local
127.0.0.1 ape.ape-test.local
127.0.0.1 0.ape.ape-test.local
127.0.0.1 1.ape.ape-test.local
127.0.0.1 2.ape.ape-test.local
127.0.0.1 3.ape.ape-test.local
127.0.0.1 4.ape.ape-test.local
127.0.0.1 5.ape.ape-test.local
127.0.0.1 6.ape.ape-test.local
127.0.0.1 7.ape.ape-test.local
127.0.0.1 8.ape.ape-test.local
127.0.0.1 9.ape.ape-test.local

If you are running APE on windows in a virtual machine edit the file C:\WINDOWS\system32\drivers\etc\hosts)

Do not use localhost for your domain or any domain without TLD (for example ape.mycomputer) or your APE installation will not work!

[edit] Install APE JSF

Your APE server is now configured. It's time to setup APE JavaScript Framwork and check your APE server is working.

[edit] Configure APE JSF

Put all APE JSF file in the virtualhost you just created. And open the file Demos/config.js. Configure it like that :

APE.Config.baseUrl = 'http://yourdomain.com/APE_JSF'; //APE JSF 
APE.Config.domain = 'yourdomain.com'; //Your domain, must be the same than the domain in aped.conf of your server
APE.Config.server = 'ape.yourdomain.com:443'; //APE server URL

If you use APE on your local machine, replace yourdomain.com with ape-test.local

REMEMBER replace in /etc/ape/ape.conf the property domain = ape.yourdomain.local [1] and restart the ape server (sudo /etc/init.d/ape-server restart)

[edit] Test your installation

Now you can open your browser to yourdomain.com:443/APE_JSF/Tools/Check/ this tool will perform some check and verify your APE server is correctly setup and help you to find what is going wrong. If your installation is not working; check this page : APE_Server_does_not_start or come on our IRC channel #ape-project@irc.freenode.net our use our groups

[edit] What next?

Now you can try the APE demo, hack it and read some APE Tutorials. Let your imagination do cool things :)