Mettre à niveau des géodatabases dans PostgreSQL sur Amazon Web Services—ArcGIS Enterprise sur AWS

Mettez à niveau vos géodatabases pour bénéficier des nouvelles fonctionnalités et améliorations intégrées à la géodatabase. Pour mettre à niveau une géodatabase d’entreprise dans PostgreSQL sur AWS, procédez de l’une des manières suivantes :

Utilisez l’image virtuelle AMI 10.6.1 pour créer une instance ArcGIS Server 10.6.1 sur Amazon Web Services (AWS), créez une géodatabase dans la dernière version de PostgreSQL incluse avec cette image virtuelle AMI, transférez vos données vers la nouvelle géodatabase et republiez les services.
Vous pouvez utiliser cette méthode si vous effectuez une mise à niveau depuis une instance ArcGIS 10.
Mettez à jour le logiciel ArcGIS sur votre instance AWS et mettez à niveau la géodatabase.
Si votre géodatabase se trouve dans un agrégat de bases de données PostgreSQL sur AWS, vérifiez que votre version PostgreSQL existante est compatible avec la dernière version du logiciel ArcGIS. Si tel n’est pas le cas, vous devez également mettre à niveau l’agrégat de bases de données PostgreSQL.
Si votre géodatabase se trouve dans Amazon Relational Database Service (RDS) for PostgreSQL, Amazon met automatiquement à jour la version PostgreSQL de sorte qu’il vous suffit de mettre à niveau la géodatabase une fois la mise à niveau du logiciel ArcGIS terminée.

Astuce:

Si vos données se trouvent actuellement dans un agrégat de bases de données PostgreSQL sur AWS et que vous souhaitez les transférer vers une instance Amazon RDS for PostgreSQL, vous pouvez créer une géodatabase dans une instance Amazon RDS for PostgreSQL, transférer vos données et republier les services.

Les sections suivantes décrivent les méthodes permettant de mettre à jour votre géodatabase vers la version la plus récente.

Créer une instance ArcGIS 10.6.1 sur AWS et transférer vos données à partir d’une instance plus ancienne

Pour être certain d’obtenir la dernière version du logiciel ArcGIS, de PostgreSQL et du système d’exploitation sans avoir à mettre à niveau ou à appliquer de correctif à chacun, créez une instance ArcGIS Server for AWS à partir de la dernière image virtuelle AMI Esri, transférez vos données et republiez les services. Reportez-vous à la rubrique Les ArcGIS Server images virtuelles AMI pour savoir quelles versions du logiciel et du système d'exploitation sont disponibles dans les dernières images virtuelles AMI Esri.

Pour savoir comment transférer des données, reportez-vous à la section Stratégies de transfert de données vers Amazon Web Services.

ArcGIS 10 comprenait une image virtuelle AMI de géodatabase d'entreprise distincte qui contenait une grappe de bases de données PostgreSQL 8.3.8 sur Windows. Les images virtuelles AMI ArcGIS Server qui incluent PostgreSQL s'exécutent désormais sur Ubuntu Linux. Vous ne pouvez pas passer directement d'une base de données PostgreSQL sur Windows à une base de données sur Linux. Vous ne pouvez pas non plus mettre à niveau ArcGIS 10 Server vers ArcGIS 10.1 for Server ou versions ultérieures. Ainsi, si vous migrez vers les images virtuelles AMI AWS d'ArcGIS à partir d'ArcGIS 10 Server for AWS, vous devez transférer ou recharger vos données et les republier.

La version de PostgreSQL incluse avec l’image virtuelle AMI Esri Ubuntu a également évolué au fil du temps, comme l’illustre la table suivante :


Version AMI Esri	Version PostgreSQL fournie
10.1	9.0.5
10.2	9.0.13
10.2.1 et 10.2.2	9.2.4
10.3	9.3.4
10.3.1	9.3.6
10.4.x	9.3.10
10.5.x	9.3.12
10.6.x	9.5.3

Mettre à jour le logiciel ArcGIS sur votre instance AWS et mettre à niveau la géodatabase

Vous pouvez mettre à niveau ArcGIS Server sur votre instance existante, mettre à niveau votre géodatabase dans PostgreSQL et continuer à utiliser vos données et services existants. Sachez que le système d'exploitation et tous les autres logiciels de cette instance conservent la version qu'ils présentaient lorsque vous avez créé votre instance. Par exemple, si vous avez créé votre instance à partir d’une image virtuelle AMI ArcGIS Server 10.2.2 pour AWS, vous continuerez à utiliser une base de données PostgreSQL 9.2.4 sur un système d’exploitation Ubuntu 12.04. Selon la version de ArcGIS Server vers laquelle vous effectuez la mise à niveau, cette version de PostgreSQL risque de ne pas être compatible.

Si la version PostgreSQL présente sur votre instance n'est pas compatible avec la nouvelle version d'ArcGIS Server, vous devez également mettre à niveau PostgreSQL vers une version prise en charge. Par exemple, si vous avez lancé une instance ArcGIS 10.3 et souhaitez effectuer la mise à niveau vers ArcGIS Server 10.6.1 sur cette instance, vous devez également mettre à niveau PostgreSQL vers une version prise en charge. Consultez la documentation PostgreSQL pour en savoir plus sur la mise à niveau de PostgreSQL.

Notez que la façon dont vous mettez à niveau ArcGIS Server sur AWS dépend de la façon dont vous avez créé le site ArcGIS Server.

Si vous avez utilisé ArcGIS Server Cloud Builder on Amazon Web Services pour créer le site ArcGIS Server et les géodatabases, suivez les instructions des deux prochaines sections pour mettre à niveau le site et vos géodatabases. La première section explique la mise à niveau lorsque vos géodatabases se trouvent sur la même instance EC2 que ArcGIS Server. La deuxième section explique la mise à niveau lorsque vos géodatabases se trouvent sur une instance EC2 distincte.
Si vous avez utilisé un modèle AWS CloudFormation fourni par Esri pour créer un site ArcGIS Server 10.6, vous pouvez utiliser le modèle CloudFormation de mise à niveau pour mettre à niveau ArcGIS Server. Une fois ArcGIS Server mis à niveau, suivez les instructions de la troisième section pour mettre à niveau la géodatabase dans Amazon RDS for PostgreSQL.
Si vous avez créé un site ArcGIS Server 10.5.1 ou de version antérieure à l’aide d’un modèle CloudFormation fourni par Esri, connectez-vous à vos instances sur AWS et mettez à niveau ArcGIS Server comme vous le feriez avec un site ArcGIS Server déployé sur site. Suivez les étapes de la troisième section pour mettre à niveau la géodatabase dans Amazon RDS for PostgreSQL.
Si vous avez créé votre site à partir de l’image virtuelle AMI Esri à l’aide de la console de gestion AWS, connectez-vous à vos instances sur AWS et mettez à niveau ArcGIS Server comme vous le feriez avec un site ArcGIS Server déployé sur site. Si votre géodatabase se trouve dans un agrégat de bases de données PostgreSQL sur AWS, exécutez l’outil Mettre à niveau la géodatabase à partir d’un script Python sur une des machines ArcGIS Server pour mettre à niveau la géodatabase comme vous le feriez avec une géodatabase sur site. Si votre géodatabase se trouve dans Amazon RDS for PostgreSQL, suivez les instructions de la troisième section pour la mettre à niveau.

Mettre à niveau des géodatabases sur SITEHOST

Si vous avez créé votre site ArcGIS Server et les géodatabases avec ArcGIS Server Cloud Builder on Amazon Web Services, suivez les étapes de cette section pour mettre à niveau des géodatabases dans un agrégat de bases de données PostgreSQL résidant sur la même instance que l’instance SITEHOST de ArcGIS Server.

Mettez à jour ArcGIS Server, déplacez le nouveau fichier st_geometry.so vers le répertoire PostgreSQL lib, arrêtez ArcGIS Server, exécutez un script Python pour mettre à niveau chaque géodatabase et redémarrez ArcGIS Server.

Installez la dernière version d'ArcGIS Server sur votre instance AWS.

Reportez-vous à la rubrique Appliquer une mise à jour ArcGIS sur un site à une seule machine ou Appliquer une mise à jour ArcGIS sur un site à plusieurs machines Ubuntu pour obtenir des instructions si vous n'avez pas déjà installé le logiciel.
Créez des copies de sauvegarde de vos géodatabases avant de les mettre à niveau. La méthode la plus simple consiste à effectuer une sauvegarde Cloud Builder de votre site (si vous avez créé votre site à l'aide de Cloud Builder) ou à créer un instantané du volume EBS qui contient vos données. Pour créer un instantané de votre volume EBS, consultez la documentation concernant Amazon Web Services.
Avant la mise à niveau, vous devez copier le fichier st_geometry.so du répertoire /arcgis/server/DatabaseSupport/PostgreSQL/Linux64 vers /usr/lib/postgresql/<postgresql version>/lib.
1. Le fichier st_geometry.so appartient à l'utilisateur racine. Ainsi, après avoir connecté l'instance Amazon Web Services SITEHOST en tant que qu'utilisateur ubuntu, connectez-vous en tant qu'utilisateur racine :
  sudo su -
  Remarque :
  
  N'oubliez pas que vous ne pouvez pas vous connecter comme utilisateur arcgis, puis en tant qu'utilisateur racine.
2. Avant de copier le nouveau fichier, renommez l'ancien.
  mv /usr/lib/postgresql/<postgresql version>/lib/st_geometry.so /usr/lib/postgresql/<postgresql version>/lib/st_geometryOLD.so
3. Copiez le nouveau fichier st_geometry.so.
  cp /arcgis/server/DatabaseSupport/PostgreSQL/Linux64/st_geometry.so /usr/lib/postgresql/<postgresql version>/lib
4. Changez les autorisations du fichier st_geometry.so pour autoriser d'autres utilisateurs à le lire et à l'exécuter.
  chmod 755 /usr/lib/postgresql/<postgresql version>/lib/st_geometry.so
Connectez-vous en tant qu'utilisateur arcgis.
```
su - arcgis
```
Ouvrez un éditeur de texte pour créer le script Python de mise à niveau.
```
vi upgrade.py
```
Copiez le script suivant dans un éditeur de texte.
Modifiez le script de façon à utiliser les informations propres à votre site, notamment le nom d'instance, le mot de passe sde, le nom et l'emplacement du fichier de connexion et le nom de la base de données.
```
#Import arcpy module
import arcpy
# Create connection file
arcpy.CreateDatabaseConnection_management("/tmp","egdb_connection.sde","POSTGRESQL","ec2-123-456-789-100.compute-1.amazonaws.com","DATABASE_AUTH", "sde", "E$ri3774", "SAVE_USERNAME", "egdb")
# Upgrade geodatabase
arcpy.UpgradeGDB_management("/tmp/egdb_connection.sde", "PREREQUISITE_CHECK", "UPGRADE")
```
Reportez-vous aux rubriques Créer une connexion à une base de données et Mettre une géodatabase à niveau pour plus d'informations sur la syntaxe de l'outil.
Enregistrez le fichier et fermez l'éditeur de texte.
Arrêtez ArcGIS Server.
```
/arcgis/server/stopserver.sh
```
Exécutez le script dans Python.
```
/arcgis/server/tools/python <path to the file>/upgrade.py
```
Il est possible que plusieurs messages concernant les références de type s'affichent. Vous pouvez les ignorer, ils ne signifient pas que la mise à niveau a échoué.

Des informations sont consignées dans le fichier journal GDBUpgrade.log sous /arcgis/server/framework/runtime/.wine/drive_c/users/arcgis/LocalAppData/ESRI/Server<#> si la mise à niveau échoue.
Pour vous assurer que votre géodatabase est mise à niveau, exécutez ce qui suit dans Python. Remplacez /tmp/egdb_connection.sde par l'emplacement et le nom de votre fichier de connexion.
D'abord, ouvrez une invite arcpy.
```
cd /arcgis/server/tools
./python
```
Utilisez isCurrent pour savoir si la géodatabase est mise à niveau vers la version actuelle.
```
import arcpy
isCurrent = arcpy.Describe('/tmp/egdb_connection.sde').currentRelease
print isCurrent
```
Si print isCurrent renvoie True, votre géodatabase est mise à niveau.
Pour quitter l'invite arcpy, tapez quit().
Modifiez le script et exécutez-le à nouveau pour chaque géodatabase que vous devez mettre à niveau.
Si vous devez effectuer la mise à niveau de PostgreSQL vers une version prise en charge, créez une sauvegarde de la base de données et procédez à la mise à niveau de PostgreSQL. Le mode de mise à niveau de PostgreSQL dépend des versions de PostgreSQL d'origine et de destination. Consultez la documentation de PostgreSQL pour en savoir plus.
Une fois toutes les géodatabases (et les bases de données, si nécessaire) mises à niveau, redémarrez ArcGIS Server.
```
/arcgis/server/startserver.sh
```

Si vous possédez un site à plusieurs machines, passez à l'étape 11 de la rubrique Appliquer une mise à jour ArcGIS sur un site à plusieurs machines Ubuntu.

Mettre à niveau les géodatabases qui se trouvent dans leur propre instance AWS (EGDBHOST)

Si vous avez créé votre site ArcGIS Server et les géodatabases avec ArcGIS Server Cloud Builder on Amazon Web Services, suivez les étapes de cette section pour mettre à niveau les géodatabases dans PostgreSQL qui se trouvent dans leur propre instance AWS dédiée (EGDBHOST).

Mettez à jour ArcGIS Server sur le SITEHOST, déplacez le nouveau fichier st_geometry.so depuis SITEHOST vers le répertoire PostgreSQL lib sur EGDBHOST, arrêtez ArcGIS Server, exécutez un script Python depuis SITEHOST pour mettre à niveau chaque géodatabase et redémarrez ArcGIS Server.

Installez la nouvelle version d'ArcGIS Server sur votre instance AWS.

Reportez-vous à la rubrique Appliquer une mise à jour ArcGIS sur un site à une seule machine ou Appliquer une mise à jour ArcGIS sur un site à plusieurs machines Ubuntu pour en savoir plus.
Créez des copies de sauvegarde de vos géodatabases avant de les mettre à niveau. Le plus simple consiste à créer une capture d'écran du volume EBS contenant vos données. Consultez la documentation concernant Amazon Web Services pour savoir comment créer un instantané d'un volume EBS.
Avant la mise à niveau, vous devez copier le fichier st_geometry.so du répertoire /arcgis/server/DatabaseSupport/PostgreSQL/Linux64 vers /usr/lib/postgresql/<postgresql version>/lib.
1. Avant de copier le nouveau fichier, renommez l'ancien sur EGDBHOST. Comme le fichier st_geometry.so est la propriété de l'utilisateur racine, connectez-vous à EGDBHOST en tant qu'utilisateur ubuntu, puis en tant qu'utilisateur racine.
  sudo su - mv /usr/lib/postgresql/<postgresql version>/lib/st_geometry.so /usr/lib/postgresql/<postgresql version>/lib/st_geometryOLD.so
2. Vous devez déplacer le fichier st_geometry.so depuis /arcgis/server/DatabaseSupport/PostgreSQL/Linux64 sur SITEHOST vers /usr/lib/postgresql/<postgresql version>/lib sur EGDBHOST.
  
  Comme les deux répertoires source et de destination qui se trouvent sur les différentes instances ne sont pas accessibles par le même utilisateur, connectez-vous à SITEHOST en tant qu'utilisateur arcgis et copiez le fichier dans le répertoire gisdata sur EGDBHOST.
  cp /arcgis/server/DatabaseSupport/PostgreSQL/Linux64/st_geometry.so /net/EGDBHOST/gisdata/st_geometry.so
3. Connectez-vous à EGDBHOST en tant qu'utilisateur ubuntu.
4. Connectez-vous en tant qu'utilisateur racine.
  sudo su -
5. Copiez le fichier st_geometry.so depuis gisdata vers /usr/lib/postgresql/<postgresql version>/lib.
  cp /gisdata/st_geometry.so /usr/lib/postgresql/<postgresql version>/lib/st_geometry.so
6. Changez les autorisations du fichier st_geometry.so pour autoriser d'autres utilisateurs à le lire et à l'exécuter.
  chmod 755 /usr/lib/postgresql/<postgresql version>/lib/st_geometry.so
Connectez-vous à SITEHOST en tant qu'utilisateur arcgis.
Ouvrez un éditeur de texte pour créer le script Python de mise à niveau.
Par exemple :
```
vi upgrade.py
```
Copiez le script suivant dans un éditeur de texte.
Modifiez le script de façon à utiliser les informations propres à votre site, notamment le nom d'instance, le mot de passe sde, le nom et l'emplacement du fichier de connexion et le nom de la base de données.
```
#Import arcpy module
import arcpy
# Create connection file
arcpy.CreateDatabaseConnection_management("/tmp","egdb_connection.sde","POSTGRESQL","ec2-123-456-789-100.compute-1.amazonaws.com","DATABASE_AUTH", "sde", "E$ri3774", "SAVE_USERNAME", "egdb")
# Upgrade geodatabase
arcpy.UpgradeGDB_management("/tmp/egdb_connection.sde", "PREREQUISITE_CHECK", "UPGRADE")
```
Reportez-vous aux rubriques Créer une connexion à une base de données et Mettre une géodatabase à niveau pour plus d'informations sur la syntaxe de l'outil.
Enregistrez le fichier et fermez l'éditeur de texte.
Arrêtez ArcGIS Server.
```
/arcgis/server/stopserver.sh
```
Exécutez le script dans Python.
```
/arcgis/server/tools/python <path to the file>/upgrade.py
```
Il est possible que plusieurs messages concernant les références de type s'affichent. Vous pouvez ignorer ces messages.

Si la mise à niveau échoue, des informations sont consignées dans le GDBUpgrade.log dans /arcgis/server/framework/runtime/.wine/drive_c/users/arcgis/LocalAppData/ESRI/Server<#>.
Pour vous assurer que votre géodatabase est mise à niveau, ouvrez Python et exécutez ce qui suit, en remplaçant /tmp/egdb_connection.sde par l'emplacement et le nom de votre fichier de connexion.
D'abord, ouvrez une invite arcpy.
```
cd /arcgis/server/tools
./python
```
Utilisez isCurrent pour savoir si la géodatabase est mise à niveau vers la version actuelle.
```
import arcpy
isCurrent = arcpy.Describe('/tmp/egdb_connection.sde').currentRelease
print isCurrent
```
Si print isCurrent renvoie True, votre géodatabase est mise à niveau.
Pour quitter l'invite arcpy, tapez quit().
Modifiez le script upgrade.py et exécutez-le à nouveau pour chaque géodatabase que vous devez mettre à niveau.
Si vous devez effectuer la mise à niveau de PostgreSQL vers une version prise en charge, créez une sauvegarde de la base de données et procédez à la mise à niveau de PostgreSQL. Le mode de mise à niveau de PostgreSQL dépend des versions de PostgreSQL d'origine et de destination. Consultez la documentation de PostgreSQL pour en savoir plus.
Une fois toutes les géodatabases (et les bases de données, si nécessaire) mises à niveau, redémarrez ArcGIS Server.
```
/arcgis/server/startserver.sh
```

Si vous possédez un site à plusieurs machines, passez à l'étape 11 de la rubrique Appliquer une mise à jour ArcGIS sur un site à plusieurs machines Ubuntu.

Mettre à niveau des géodatabases dans Amazon RDS for PostgreSQL

Après avoir mis à niveau votre ArcGIS Server sur AWS, suivez ces étapes pour mettre à niveau les géodatabases dans Amazon RDS for PostgreSQL.

Vérifiez que vous possédez une sauvegarde actuelle et fiable de votre base de données dans Amazon RDS for PostgreSQL.
Connectez-vous à Amazon RDS for PostgreSQL et vérifiez que l’utilisateur sde dispose du rôle rds_superuser.
Connectez-vous à l’une de vos instances ArcGIS Server sur AWS en tant qu’utilisateur arcgis.
Ouvrez un éditeur de texte pour créer un script Python et mettre à niveau votre géodatabase.
Par exemple :
```
vi upgrade.py
```
Copiez le script suivant dans un éditeur de texte.
Modifiez le script de façon à utiliser les informations propres à votre site, notamment le nom d'instance, le mot de passe sde, le nom et l'emplacement du fichier de connexion et le nom de la base de données.
```
#Import arcpy module
import arcpy
# Create connection file
arcpy.CreateDatabaseConnection_management("/tmp","egdbrds_connection.sde","POSTGRESQL","my_db_instance_identifier.awsregion_id.rds.amazonaws.com","DATABASE_AUTH", "sde", "E$ri3774", "SAVE_USERNAME", "egdb")
# Upgrade geodatabase
arcpy.UpgradeGDB_management("/tmp/egdbrds_connection.sde", "PREREQUISITE_CHECK", "UPGRADE")
```
Reportez-vous aux rubriques Créer une connexion à une base de données et Mettre une géodatabase à niveau pour plus d'informations sur la syntaxe de l'outil.
Enregistrez le fichier et fermez l'éditeur de texte.
Arrêtez ArcGIS Server.
```
/arcgis/server/stopserver.sh
```
Exécutez le script dans Python.
```
/arcgis/server/tools/python <path to the file>/upgrade.py
```
Si la mise à niveau échoue, des informations sont consignées dans le GDBUpgrade.log dans /arcgis/server/framework/runtime/.wine/drive_c/users/arcgis/LocalAppData/ESRI/Server<#>.
Pour vous assurer que votre géodatabase est mise à niveau, ouvrez Python et exécutez ce qui suit, en remplaçant /tmp/egdbrds_connection.sde par l'emplacement et le nom de votre fichier de connexion.
D'abord, ouvrez une invite arcpy.
```
cd /arcgis/server/tools
./python
```
Utilisez isCurrent pour savoir si la géodatabase est mise à niveau vers la version actuelle.
```
import arcpy
isCurrent = arcpy.Describe('/tmp/egdbrds_connection.sde').currentRelease
print isCurrent
```
Si print isCurrent renvoie True, votre géodatabase est mise à niveau.
Pour quitter l'invite arcpy, tapez quit().
Modifiez le script upgrade.py et exécutez-le à nouveau pour chaque géodatabase que vous devez mettre à niveau.

Vous avez un commentaire à formuler concernant cette rubrique ?