First install python software properties to be able to run `add-apt-repository`
@ -431,17 +455,18 @@ node app.js development
sudo apt-get install imagemagick
```
## Optional
## Optional installation
These are not strictly required to run CartoDB, but if you are installing CartoDB to do change something you might need them:
### Frontend assets
Have their own README and tools since they don't run on the Rails, see [lib/build/README.md](lib/build/README.md).
### Raster import support
Raster importer needs `raster2pgsql` to be in your path. You can check whether it's available by running `which raster2pgsql`. If it's not, you should link it: `$ sudo ln -s /usr/local/src/postgis-2.1.2/raster/loader/raster2pgsql /usr/bin/`.
Access to temporary dir is also needed. Depending on your installation you might also need to run `sudo chown 501:staff /usr/local/src/postgis-2.1.2/raster/loader/.libs` (maybe replacing `501:staff` with your installation /usr/local/src/postgis-2.1.2/raster/loader/ group and owner).
## Install problems and common solutions #
Installing the full stack might not always be smooth due to other component updates, so if you run into problems installing CartoDB, please check [this list of problems and solutions](https://github.com/CartoDB/cartodb/wiki/Problems-faced-during-CartoDB-install-&-solutions-if-known) first to see if your problem already happened in the past and somebody else found a workaround, solution or fix to it.
## Install local instance of cold beer ##
Congratulations!
@ -517,14 +542,16 @@ You should now be able to access
**`http://<mysubdomain>.localhost.lan:3000`**
in your browser and login with the password specified above.
# How do I upgrade CartoDB? #
## Note on tiling, SQL API and Redis
See UPGRADE file for instructions about upgrading CartoDB.
Please ensure CartoDB-SQL-API, Windshaft-cartodb, and Redis are all
running for full experience.
For upgrade of Windshaft-CartoDB and CartoDB-SQL-API see the relative
documentation.
Manual configuration is needed for the
`public/javascripts/environments/development.js` file which configures
Windshaft-cartodb tile server URLs.
# Handy tasks #
## Handy tasks
For a full list of CartoDB utility tasks:
@ -532,8 +559,7 @@ For a full list of CartoDB utility tasks:
bundle exec rake -T
```
# Using foreman #
## Using foreman
You can also use foreman to run the full stack (cartodb server, sql api, tiler, redis and resque), using a single command:
IMPORTANT: You need to install foreman by yourself. It's not included in the Gemfile. Run this:
where $PORT is the port you want to attach the rails server to.
# Note on tiling, SQL API and Redis #
# How do I upgrade CartoDB? #
Please ensure CartoDB-SQL-API, Windshaft-cartodb, and Redis are all
running for full experience.
See [UPGRADE](UPGRADE) for instructions about upgrading CartoDB.
Manual configuration is needed for the
`public/javascripts/environments/development.js` file which configures
Windshaft-cartodb tile server URLs.
For upgrade of Windshaft-CartoDB and CartoDB-SQL-API see the relative
documentation.
# Developing CartoDB
# Install problems and common solutions #
## Frontend (JS/CSS)
Installing the full stack might not always be smooth due to other component updates, so if you run into problems installing CartoDB, please check [this list of problems and solutions](https://github.com/CartoDB/cartodb/wiki/Problems-faced-during-CartoDB-install-&-solutions-if-known) first to see if your problem already happened in the past and somebody else found a workaround, solution or fix to it.
See [doc/frontend.md](doc/frontend.md)
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for how you can improve CartoDB. :)
### Testing ###
# Testing
See TESTING.md
See [TESTING.md](TESTING.md)
### Contributors ###
# Contributors
- Fernando Blat ([ferblape](https://twitter.com/ferblape))
- Javier Álvarez Medina ([xavijam](https://twitter.com/xavijam))
this document contains some notes on how to work with backbone models related to organization
This document contains some notes on how to work with backbone models related to organization
## models related to organization
## Models related to organization
- [cdb.admin.User](https://github.com/CartoDB/cartodb/blob/CDB-2891/lib/assets/javascripts/cartodb/models/user.js): it already existed, but it takes more importance
- [cdb.admin.Organization](https://github.com/CartoDB/cartodb/blob/CDB-2891/lib/assets/javascripts/cartodb/models/organization.js): this represents an organization
- [cdb.admin.Permission](https://github.com/CartoDB/cartodb/blob/CDB-2891/lib/assets/javascripts/cartodb/models/permissions.js): permission object, contains the information to know about the ownership and
permission list (called ``acl``) of an object. See https://github.com/Vizzuality/cartodb-management/wiki/multiuser-REST-API#permissions-object
## changes
### Changes
- ``User`` model has an organization attribute. Each user is **always** inside an organization, so
this will be always filled. When the organization contains only a user, the application behavior is the
@ -21,7 +20,7 @@ this document contains some notes on how to work with backbone models related to
- ``Visualization`` object contains a ``permission`` attribute (instance of ``cdb.admin.Permission``)