# Deploying a development environment 

In this section we will learn how to run GeoNode in _development mode_; this particular way to run GeoNode will allow us to view and debug any change to the code at runtime, without the need to restart the services.

Notice that we will still need the following services to run on the system:

 - **PostgreSQL service w/ PostGIS extensions**; we will learn how to link Dev GeoNode to an existing database and how to initialize a new one.
 - **Apache Tomcat9 with GeoServer**; we will still need a running GeoServer instance to be able to manage the geospatial layers.

## Stop GeoNode Services
You may have some services still running from a previous tutorial, so make sure such services are down. 

- Stop `NGINX` and `UWSGI` services

```shell
sudo systemctl stop nginx

sudo systemctl stop uwsgi
```

You may also want to check the status of the services:
```bash
sudo systemctl status nginx
   [...long output here...]
   
sudo systemctl status uwsgi
   [...long output here...]
```

You may also want to check that the service was properly closed
```bash
sudo ps aux | grep uwsgi
```
If you find any uwsgi process left, you can `kill` them right away:
```bash
sudo pkill -9 -f uwsgi
```


## Other services and processes

In order to have a complete GeoNode ecosystem, you need some other services along with the GeoNode-django process itself.

As documented in a previous training, you will have to setup at least PostgreSQL and GeoServer. If you didn't do it before, run 
- [these steps to configure PostgreSQL](900_postgres.md) and 
- [these steps to configure GeoServer](900_geoserver.md). 
 
## Prepare the GeoNode environment

You may have your GeoNode code already checked out, anyway let's repeat here the steps of the 
"GeoNode Basic Install" training lesson.

- Create the `geonode` virtualenv (if you don't have it already):
  ```bash
  mkvirtualenv --python=$(which python3.8) geonode
  ```
- Switch to `geonode` virtual env
  ```shell
  workon geonode
  ```
- Prepare the geonode working dir (if you don't have it already):
  ```bash
  # Let's create the GeoNode core base folder and clone it
  sudo mkdir -p /opt/geonode/; sudo usermod -a -G www-data $USER; sudo chown -Rf $USER:www-data /opt/geonode/; sudo chmod -Rf 775 /opt/geonode/

  # Clone the GeoNode source code on /opt/geonode
  cd /opt; git clone https://github.com/GeoNode/geonode.git -b 3.3.x geonode
  ```
- Install the Python packages needed by GeoNode: 
  ```bash
  cd /opt/geonode
  pip install -r requirements.txt --upgrade --no-cache --no-cache-dir
  pip install -e . --upgrade
  pip install pygdal=="`gdal-config --version`.*"
  ```


### Prepare the `.env_dev` variables

Adjust the `.env_dev` file in order to match our current configuration.

```shell
vim .env_dev
```

Make sure `SITEURL`, DB connection settings and `GEOSERVER_*` URLs and connection params are correct.

```ini
...
# #################
# backend
# #################
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
GEONODE_DATABASE=geonode
GEONODE_DATABASE_PASSWORD=geonode
GEONODE_GEODATABASE=geonode_data
GEONODE_GEODATABASE_PASSWORD=geonode
GEONODE_DATABASE_SCHEMA=public
GEONODE_GEODATABASE_SCHEMA=public
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_URL=postgis://geonode:geonode@localhost:5432/geonode
GEODATABASE_URL=postgis://geonode:geonode@localhost:5432/geonode_data
GEONODE_DB_CONN_MAX_AGE=0
GEONODE_DB_CONN_TOUT=5
DEFAULT_BACKEND_DATASTORE=datastore
...
SITEURL=http://localhost:8000/
...
# #################
# geoserver
# #################
GEOSERVER_WEB_UI_LOCATION=http://localhost:8080/geoserver/
GEOSERVER_PUBLIC_LOCATION=http://localhost:8080/geoserver/
GEOSERVER_LOCATION=http://localhost:8080/geoserver/
GEOSERVER_ADMIN_USER=admin
GEOSERVER_ADMIN_PASSWORD=geoserver
```

### Aligning the DB

Make sure the DB and GeoNode are aligned.

- Align the migrations and static/media folders

```shell
./paver_dev.sh sync
```

- Align the internal URLs and Metadata links

```shell
# The order is important! Those are regex expressions and will be executed one after the other...

# Fix GeoServer URLs first
./manage_dev.sh migrate_baseurl --source-address=http://localhost/geoserver --target-address=http://localhost:8080/geoserver

# Fix GeoNode URLs
./manage_dev.sh migrate_baseurl --source-address=http://localhost/ --target-address=http://localhost:8000/

# Align the Metadata links
./manage_dev.sh set_all_layers_metadata -d
```

### Configuring GeoServer OAuth plugin

Make sure the GeoServer OAuth plugin is correctly configured

- Adjust the GeoServer `PROXY_BASE_URL`
  1. Login as `admin/geoserver` by using the `form login`
  2. Update the `Global` settings of GeoServer


![image](https://user-images.githubusercontent.com/1278021/132375154-5b5f9eae-d07b-4147-83e3-f74f1386a240.png)

- Adjust the `REST Role Service`

![image](https://user-images.githubusercontent.com/1278021/132375708-a5ecfedf-eca7-4cdc-934c-592e7726504c.png)

- Adjust the `OAuth2 Security Filter`

![image](https://user-images.githubusercontent.com/1278021/132375932-9ec8b03d-ef30-4613-89ee-d72f245d4c90.png)

![image](https://user-images.githubusercontent.com/1278021/132376323-d9d63007-8775-4777-b04d-f0cba837c2b6.png)

- Test the GeoServer `logout/login` with GeoNode

### Let's Start GeoNode
- Let's refresh the layers thumbnails and verify the settings are correct

```shell
./manage_dev.sh sync_geonode_layers --updatethumbnails

Syncing layer 1/11: a__13tde815295_200803_0x6000m_cl
Regenerating thumbnails...
Syncing layer 2/11: Air_Runways
Regenerating thumbnails...
Syncing layer 3/11: BoulderCityLimits
Regenerating thumbnails...
Syncing layer 4/11: Buildings050714
Regenerating thumbnails...
Syncing layer 5/11: Mainrd
Regenerating thumbnails...
Syncing layer 6/11: Parcels
Regenerating thumbnails...
Syncing layer 7/11: pointlm
Regenerating thumbnails...
Syncing layer 8/11: srtm_boulder
Regenerating thumbnails...
Syncing layer 9/11: Streets
Regenerating thumbnails...
Syncing layer 10/11: Trails
Regenerating thumbnails...
Syncing layer 11/11: Wetlands_regulatory_area
Regenerating thumbnails...
There are 0 layers which could not be updated because of errors
```

- Start GeoNode in `development mode`

```shell
./paver_dev.sh start_django

---> pavement.start_django
 python -W ignore manage.py runserver 0.0.0.0:8000 &
Performing system checks...

System check identified some issues:

WARNINGS:
?: (urls.W005) URL namespace 'rest_framework' isn't unique. You may not be able to reverse all URLs in this namespace

System check identified 1 issue (5 silenced).
September 07, 2021 - 16:07:13
Django version 2.2.20, using settings 'geonode.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.
```

- Connect to `http://localhost:8000` and verify GeoNode has started correctly

#### [Next Section: Programmatically Customize the Look-and-Feel](030_LF_SIMPLE.md)