Skip to content

Latest commit

 

History

History
83 lines (54 loc) · 5.36 KB

installation.md

File metadata and controls

83 lines (54 loc) · 5.36 KB

#Installation FAQ

##Where can I download Countly?

##How much time does it take to install Countly? If your server has all the requirements, then it takes approximately 5-15 minutes to install Countly and start collecting data from devices. Follow the instructions in the Server Installation Manual. Note that installation and configuration does not need any developer skills but only a dedicated server for this purpose.

In the future we'll provide Amazon Machine Images with Countly preinstalled, so you'll be up and running in a few minutes of time. You can also deploy these images on your own cloud/premises and run on a hypervisor to have a better control.

##There are two methods for installation in documentation, which one should I choose?##

We strongly suggest you use the automated installation scripts given in Countly package.

##What are the system requirements? We develop, test and use Countly on Ubuntu (for Community Edition) and Red Hat Enterprise Linux (for Enterprise Edition). A decent Linux machine can handle several hundreds (if not thousands) requests per second coming from mobile devices.

For very large traffic (several billion calls per month), we provide Countly Enteprise Edition, which scales horizontally as your business grow.

##What's the minimum Ubuntu server requirement? We develop and test County on Ubuntu 10.04, 11.04, 11.10 and 12.04 (x32 or x86). Countly depends on modest software and a recent version of MongoDB, Node.js and nginx. Therefore it shouldn't be a problem if you have these packages in your Linux distribution (e.g Fedora, OpenSUSE, etc), however, you need to install them by hand.

##Which hosting provider do you suggest?

Any will do. We do our tests on both Linode and Amazon.

##Which browsers does Countly run on? We tested Countly on Chrome, Firefox and IE9+. A recent(ish) version of these modern browsers works well. We do not support IE8.

##What's the programming language and underlying infrastructure? Countly relies on MongoDB, Node.js and Nginx. Main programming language is Javascript. Countly doesn't use any other web server, application server or database.

##How can I keep the system up-to-date? You can download new version and install it on your server. In the future, we'll provide automatic updates for our subscribers.

##How much bandwidth does Countly SDK consume? Every 30 seconds, Countly SDK connects to server and updates connection information. Each connection includes 60-70 bytes of data to be written to the database, excluding package overhead. Therefore the network overhead is very negligible.

##What's the minimum mobile operating system requirement? Countly needs a minimum of Android 2.1 and iOS 3.1 to work.

##What's the recommended installation directory? Any directory (your user home dir, /var directory, /usr/local etc) is just tine. If you happen to have a setup that reveals some folder to public access (for ex. public_html folder) you may want to avoid extracting Countly there.

##I'm getting errors while installing node's time module Username that you are using while installing Countly is very important especially while installing time module using Node Package Manager (npm). Since Linux treats "sudo su" and "sudo" differently, you should choose one method. We prefer running "sudo ./countly.install.sh".

##Do I need a mail server? Starting from version 12.06, Countly needs an MTA to send emails to the user created by admin. MTA can be any SMTP server (e.g Postfix, Exim or Sendmail) that's installed on your server, or you can use remote SMTP and let another server handle the mail sending process. By default, Countly automated installer will use Sendmail, however you can change the installation script so it installs Postfix or Exim.

##I installed Countly on an Amazon AWS but I cannot reach dashboard By default, Amazon doesn't allow you reach port 80. You should allow incoming conections to port 80 from the security group while creating your Amazon instance.

##Is it possible to run dashboard and database on different servers to increase security? Yes. Starting from v13.06, we added a server parameter to both app.js and api.js configuration files (/frontend/express/config.js and /api/config.js) to make it possible to run dashboard and application on different servers (defaults to localhost).

##Is it possible to use Apache mod_proxy instead of Nignx?

Yes. See this thread

How can I restart Countly?

In order to restart Countly, type the following as root:

# stop countly-supervisor
# start countly-supervisor

##How do I reinstall Countly?

Deleting the countly directory, extracting the new package to the same directory and executing countly.upgrade.sh should do the trick. This is explained in Upgrading Countly documentation.