1
0
Fork 0
arangodb/Documentation/Books/Users/Foxx/Install/Remote.mdpp

96 lines
4.3 KiB
Plaintext

!CHAPTER Install Applications from remote host
In this chapter we will make use of the Foxx manager as described [before](README.md).
This time we want to install an app hosted on a server.
Currently the Foxx-manager supports downloads of applications via HTTP and HTTPS protocols.
!SECTION Remote file format
The file on the remote server has to be a valid Foxx application packed in a zip archive.
The zip archive has to contain a top-level directory which is containing the sources of the Foxx application.
Especially the file **manifest.json** has to be directly contained in this top-level directory.
On an Unix system you can verify that your zip archive has the correct format if the content looks like this:
```
unix> unzip -l hello-foxx.zip
Archive: hello-foxx.zip
0836dc2e81be8264e480a7695b46c1abe7ef153d
Length Date Time Name
-------- ---- ---- ----
0 09-10-14 15:35 hello-foxx/
1256 09-10-14 15:35 hello-foxx/README.md
11200 09-10-14 15:35 hello-foxx/app.js
0 09-10-14 15:35 hello-foxx/assets/
0 09-10-14 15:35 hello-foxx/assets/css/
82 09-10-14 15:35 hello-foxx/assets/css/base.css
86 09-10-14 15:35 hello-foxx/assets/css/custom.css
0 09-10-14 15:35 hello-foxx/assets/vendor/
0 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/
0 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/css/
22111 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/css/bootstrap-responsive.css
16849 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/css/bootstrap-responsive.min.css
127247 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/css/bootstrap.css
105939 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/css/bootstrap.min.css
0 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/img/
8777 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/img/glyphicons-halflings-white.png
12799 09-10-14 15:35 hello-foxx/assets/vendor/bootstrap/img/glyphicons-halflings.png
0 09-10-14 15:35 hello-foxx/assets/vendor/jquery/
268380 09-10-14 15:35 hello-foxx/assets/vendor/jquery/jquery.js
0 09-10-14 15:35 hello-foxx/assets/vendor/sh/
1981 09-10-14 15:35 hello-foxx/assets/vendor/sh/highlighter.css
5563 09-10-14 15:35 hello-foxx/assets/vendor/sh/sh_javascript.js
5305 09-10-14 15:35 hello-foxx/assets/vendor/sh/sh_main.min.js
0 09-10-14 15:35 hello-foxx/files/
3266 09-10-14 15:35 hello-foxx/files/index.html
398 09-10-14 15:35 hello-foxx/files/static.html
361 09-10-14 15:35 hello-foxx/kaffee.coffee
0 09-10-14 15:35 hello-foxx/lib/
108 09-10-14 15:35 hello-foxx/lib/a.js
43 09-10-14 15:35 hello-foxx/lib/c.js
1129 09-10-14 15:35 hello-foxx/manifest.json
0 09-10-14 15:35 hello-foxx/models/
330 09-10-14 15:35 hello-foxx/models/tiger.js
0 09-10-14 15:35 hello-foxx/scripts/
2065 09-10-14 15:35 hello-foxx/scripts/setup.js
1798 09-10-14 15:35 hello-foxx/scripts/teardown.js
17727 09-10-14 15:35 hello-foxx/thumbnail.png
-------- -------
614800 37 files
```
Next you have to make this file publicly available over HTTP or HTTPS on a webserver.
Assume we can download the app at **http://www.example.com/hello.zip**.
!SECTION Install from remote server
Having the link to your Foxx application at hand you can just hand this link over to the Foxx manager:
```
unix> foxx-manager install http://www.example.com/hello.zip /example
Application hello-foxx version 1.5.0 installed successfully at mount point /example
```
ArangoDB will try to download and extract the file stored at the remote location.
This HTTP or HTTPS link can be used in all functions of the Foxx-manager that allow to install Foxx applications:
**install**
```
unix> foxx-manager install http://www.example.com/hello.zip /example
Application hello-foxx version 1.5.0 installed successfully at mount point /example
```
**replace**
```
unix> foxx-manager replace http://www.example.com/hello.zip /example
Application hello-foxx version 1.5.0 installed successfully at mount point /example
```
**upgrade**
```
unix> foxx-manager upgrade http://www.example.com/hello.zip /example
Application hello-foxx version 1.5.0 installed successfully at mount point /example
```