# UPGRADE FROM 3.7 TO 3.8

Here are some release notes about upgrading from Phraseanet 3.7 and Phraseanet 3.8.

Phraseanet 3.8 is a new step in moving Phraseanet to a more decoupled design. We did
a lot of cleanup and now delegate some behavior to dedicated components. this brings
some new features, robustness and stability.

These enhancements are described in the CHANGELOG file. The purpose of this document
is to provide a list a BC breaks / Changes.

## Nginx

If you are using Nginx as Phraseanet web-server, you must update you virtual-host
configuration as follow :

    ```
    server {
        listen       80;
        server_name  yourdomain.tld;
        root         /var/www/Phraseanet/www;

        index        index.php;

        location /api {
            rewrite ^(.*)$ /api.php/$1 last;
        }

        location / {
            # try to serve file directly, fallback to rewrite
            try_files $uri $uri/ @rewriteapp;
        }

        location @rewriteapp {
            rewrite ^(.*)$ /index.php/$1 last;
        }

        # PHP scripts -> PHP-FPM server listening on 127.0.0.1:9000
        location ~ ^/(index|index_dev|api)\.php(/|$) {
            fastcgi_pass   127.0.0.1:9000;
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include        fastcgi_params;
        }
    }
    ```

## Console

Phraseanet 3.8 comes with a new command-line utility : `bin/setup`. This utility
brings commands that can be run when Phraseanet is not installed.

It introduces 3 BC breaks :

    - `bin/console system:upgrade` is replaced by `bin/setup system:upgrade`
    - `bin/console check:system` is replaced by `bin/setup check:system`
    - `bin/console check:config` has been dropped

The idea of `bin/setup` is to provide an commandline tool that is not aware of
Phraseanet Installation, whereas `bin/console` requires an up-to-date Phraseanet
install.

## Customization

If you were using custom homepage or LDAP connection, they might not work.
Please disable it before upgrading.