search

opendatacube / datacube-conference-2021

A repository of ODC Conference sprint materials.
Apache License 2.0
7 stars 2 forks source link

Completely rewrite the documentation section on installation! Or at least work out a simpler way to install the ODC and important key sub-projects. #12

Open alexgleith opened 3 years ago

alexgleith commented 3 years ago

https://datacube-core.readthedocs.io/en/latest/ops/install.html

RichardScottOZ commented 3 years ago

Sounds good - will read the further down the end bits!

RichardScottOZ commented 3 years ago

Maybe a bit at the start - installation is actually X - packages/software, database server + etc?

RichardScottOZ commented 3 years ago

e.g. somehow make this a succinct holistic overview - which might be somewhere else and can be borrowed?

Installation These installation instructions build a Data Cube environment that can be used to ingest data (with config files from github) and run analytics processes.

The Data Cube is a set of python code with dependencies including

alexgleith commented 3 years ago

Careful with the "ingest" word!

RichardScottOZ commented 3 years ago

Yes, that should mention index but doesn't? I think?

RichardScottOZ commented 3 years ago

Edits

Questions would be - should all the install docs reference making a virtual environment with the same name?

Does Data Cube (the overall product) and datacube - the package - need clarification, especially if you get capitalised versions of the latter when starting a sentence?

Is ubuntu the only linux flavour recommended - or useable?

RichardScottOZ commented 3 years ago

Installation of the additional part/libraries - tools, -stats, etc?

RichardScottOZ commented 3 years ago

https://datacube-core.readthedocs.io/en/latest/ops/db_setup.html

datacube currently installs a postgresql package - what is relevant/necessary/clashing with that in the above?

RichardScottOZ commented 3 years ago

Here

Initialise the Database Schema The datacube system init tool can create and populate the Data Cube database schema

datacube -v system init datacube system Initialise the database

datacube system [OPTIONS]

so the system init does the whole shebang - but you can customise with the latter if you like?

U-Tyagi commented 2 years ago

Recently followed the docs at https://opendatacube.readthedocs.io/en/latest/installation/index.html

Some things are obsolete, where can i suggest the changes.

alexgleith commented 2 years ago

Hey @Wadhva, docs are here: https://github.com/opendatacube/datacube-core/tree/develop/docs

It would be great if you can send us a pull request!