# Installation and upgrade

## Long story short: 

1. CCA has been setup for the customer
2. Naviga ID rights for CCA has been setup
3. If necessary: install/upgrade dependency plugins (found under [Requirements](https://docs.navigaglobal.com/naviga-photos/4.3.0/admin-guide/requirements))
4. Install Naviga Photos
5. Add configuration and mappings
6. Add Key Store items for Naviga Photos
7. Upload Naviga Photos yaml to Open Content
8. Add crop settings to ICP
9. Activate Naviga Photos
10. Create and share workspaces with users

In Dashboard, go to Available plugins and search for Naviga Photos and choose install. 

You can also go to > plugins > add >

Enter the appropriate url, click fetch and then install.

{% hint style="info" %}

#### DEV

<https://dashboard-plugins-dev-\\{{REGION\\}}.s3.\\{{REGION\\}}.amazonaws.com/com-naviga-photos/\\{{VERSION\\}}>

#### STAGE

<https://dashboard-plugins-stage-\\{{REGION\\}}.s3.\\{{REGION\\}}.amazonaws.com/com-naviga-article-photos/\\{{VERSION\\}}>

#### PROD

<https://dashboard-plugins-prod-\\{{REGION\\}}.s3.\\{{REGION\\}}.amazonaws.com/com-naviga-photos/\\{{VERSION\\}}>
{% endhint %}

Once installed, go to Settings > Configurations

Enter your [configuration](https://docs.navigaglobal.com/naviga-photos/4.3.0/admin-guide/configuration) and save.&#x20;

{% hint style="danger" %}
You need to save the configuration, even if you are not changing any value.
{% endhint %}

Go to Settings > Mappings&#x20;

Map the actions and portals. See [requirements](https://docs.navigaglobal.com/naviga-photos/4.3.0/admin-guide/requirements) if any action or portal is missing. Save again.

Activate Naviga Photos and add it to a workspace.

Done.

## Upgrading Photos

Due to the changes of standard fields and removal of EXIF extraction, **the recommendation is to upgrade from 1.0 to 1.1** accordingly (make sure you have the latest OC configuration for Photos, this is done by Naviga):&#x20;

* copy paste your custom config to an XML editor
* upgrade the plugin
* use the “RESET TO DEFAULT” button after upgrading. This will give you all standard settings
* if needed you can add custom metadata again. **Do remove the EXIF-data for extraction since this has been removed.**&#x20;

### If upgrading from 1.1 to 2.0, please read: [Metadata](https://docs.navigaglobal.com/naviga-photos/4.3.0/configuration/metadata#file)

### If upgrading from x.x.x to 3.0.0

The following dependencies are removed. The plugins can be uninstalled **if not used** by any other plugin than Naviga Photos.

* **Notifications Agent**
* **Utility Agent**

**Concept Admin** is now an optional dependency.