Modifier le serveur ou le port de base de donnée relationnelle

Dans le cadre du processus de sauvegarde/restauration, vous pouvez reconfigurer Essbase à l'aide d'une nouvelle instance de base de données Oracle. Cette rubrique explique comment modifier le port ou le serveur de base de données relationnelle.

Modifier le serveur de base de données relationnelle

Arrêtez l'instance Essbase en cours d'exécution.

cd <Oracle_HOME>/user_projects/domains/essbase_domain/esstools/bin
./stop.sh

Créez un utilisateur de base de données <export_user_name> et exécutez la commande 'expdp' pour effectuer une sauvegarde de schéma. Exportez uniquement le schéma RCUPrefix_essbase.

Exemple :

alter session set container="containername";
create user <export_user_name> identified by <password>;
grant create session, create table to <export_user_name>;
create or replace directory dmpdir to <export_user_name>;
grant DATAPUMP_EXP_FULL_DATABASE to <export_user_name>;
grant DATAPUMP_IMP_FULL_DATABASE to <export_user_name>;
grant user <export_user_name> default tablespace users;
alter user <export_user_name> quota unlimited on users;
exit;

expdp <export_user_name>/<password>@<pdbname> dumpfile=<RCUPrefix>.dmp logfile=<RCUPrefix>.log schema=<RCUPrefix>_ESSBASE directory=dmpdir

Il est hautement recommandé d'effectuer une sauvegarde du répertoire de vos applications. Si vous disposez déjà d'une sauvegarde ou que votre répertoire d'applications contient de nombreuses applications volumineuses, vous pouvez ignorer cette étape.
Exemple :
```
cd user_projects/applications/essbase/
tar -cvfz ~/Backup/Apps.tar.gz app/*
```
Configurez une nouvelle instance Essbase sur une nouvelle base de données Oracle. Vous aurez la possibilité de saisir le chemin de répertoire racine et d'application du domaine, avec les options suivantes :
- Si vous voulez réutiliser 'user_projects' en tant qu'instance principale et qu'elle est déjà utilisée par l'ancienne instance, renommez l'ancien user_projects en quelque chose d'autre avant de lancer l'Outil de configuration.
- Vous pouvez également saisir un nouveau 'user_projects_XXX' pour le chemin root de domaine et de répertoire d'application d'une nouvelle configuration.
Remarques :
N'essayez pas de supprimer des éléments tant qu'une nouvelle instance n'est pas en cours d'exécution.
Par exemple, (sur la page de configuration Détails du domaine, où vous sélectionnez les emplacements de domaine et d'application) :
- Nom de domaine essbase_domain
- Racine de domaine Oracle/21.4.2/Middleware/Oracle_Home/user_projects/domains
- Répertoire d'applications /Middleware/Oracle_Home/user_projects/applications/essbase
- Compte administrateur WebLogic
  ...
Terminez la configuration d'une nouvelle instance Essbase sur une nouvelle base de données Oracle. Veillez à utiliser un nouveau nom de schéma.
Arrêtez à nouveau Essbase (reportez-vous à l'étape 1) une fois l'outil de configuration terminé.

Créez un utilisateur "expuser" similaire pour la nouvelle base de données Oracle et exécutez la commande "impdp" pour restaurer les données à partir du fichier dump obtenu à partir de la sauvegarde à l'étape 3. Importez le schéma RCUPrefix_essbase uniquement avec l'option de remappage, si le nouveau schéma a un nouveau nom.

Exemple :

alter session set container="containername";
create user <export_user_name> identified by <password>;
grant create session , create table to <export_user_name>;
create or replace directory dmpdir to <export_user_name>;
grant DATAPUMP_EXP_FULL_DATABASE to <export_user_name>;
grant DATAPUMP_IMP_FULL_DATABASE to <export_user_name>;
grant user <export_user_name> default tablespace users;
alter user <export_user_name> quota unlimited on users;
exit;

impdp expuser/<password>@<pdbname>  dumpfile=<schema_name>.dmp logfile=<schema_name>.log REMAP_SCHEMA=[OLD_SCHEMA]_ESSBASE:[NEW_SCHEMA]_ESSBASE directory=dmpdir partition_options=merge table_exists_action=replace

Restaurez le répertoire des applications à partir de la sauvegarde ou déplacez-le de l'instance précédente.
```
cd user_projects/applications/essbase/
tar xvf ~/Backup/Apps.tar
```
Démarrez Essbase pour la nouvelle instance et assurez-vous que tout s'exécute correctement. Comme vous n'avez rien supprimé, vous pouvez toujours revenir à la bonne instance précédente si nécessaire. Une fois que tout fonctionne, vous pouvez aller de l'avant et nettoyer ce dont vous n'avez pas besoin.
```
cd <Oracle_HOME>/user_projects/domains/essbase_domain/esstools/bin
./start.sh
```
Notez que tous les paramètres des anciens serveurs gérés dans WebLogic, une fois la nouvelle configuration effectuée, doivent être ajoutés manuellement aux nouveaux serveurs gérés.

Modifier le port du serveur de base de données uniquement

Arrêter le serveur Essbase.

cd <Oracle_HOME>/user_projects/domains/essbase_domain/esstools/bin./stop.sh

Remplacez le port de base de données dans les fichiers tnsnames.ora et listener.ora, sur le serveur de base de données, par le port requis, par exemple, 1524.
Redémarrez le processus d'écoute et redémarrez la base de données. Vérifiez la connexion dans le développeur SQL.

A l'emplacement suivant sur le serveur Essbase, procédez comme suit :

cd <ORACLE_HOME>/user_projects/domains/essbase_domain/config/fmwconfig

Dans le fichier jps-config.xml, remplacez le port par le nouveau port de cette propriété.

<property name="jdbc.url" value="jdbc:oracle:thin:@(description=(address=(host=DBhost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBname)(server=dedicated)))"/>

Dans jps-config-jse.xml, apportez une modification similaire aux propriétés qui font référence au port de base de données.

<property name="jdbc.url" value="jdbc:oracle:thin:@(description=(address=(host=DBhost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBname)(server=dedicated)))"/>

A l'emplacement suivant, procédez comme suit :

cd <ORACLE_HOME>/user_projects/domains/essbase_domain/config/jdbc

Remplacez le port de base de données par le nouveau numéro de port dans les fichiers suivants.

essbase_datasource-jdbc.xml

<url>jdbc:oracle:thin:@(description=(address=(host=DBHost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBName)(server=dedicated)))</url>

LocalSvcTblDataSource-jdbc.xml

<url>jdbc:oracle:thin:@(description=(address=(host=DBHost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBName)(server=dedicated)))</url>

opss-audit-jdbc.xml

<url>jdbc:oracle:thin:@(description=(address=(host=DBHost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBName)(server=dedicated)))</url>

opss-auditview-jdbc.xml

 <url>jdbc:oracle:thin:@(description=(address=(host=DBHost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBName)(server=dedicated)))</url>

opss-datasource-jdbc.xml

<url>jdbc:oracle:thin:@(description=(address=(host=DBHost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBName)(server=dedicated)))</url>

WLSSchemaDataSource-jdbc.xml

 <url>jdbc:oracle:thin:@(description=(address=(host=DBHost)(protocol=tcp)(port=1524))(connect_data=(service_name=DBPDBName)(server=dedicated)))</url>

A l'emplacement suivant, procédez comme suit :
```
cd <ORACLE_HOME>/user_projects/domains/essbase_domain/init-info
```
Dans les fichiers suivants, remplacez le port de base de données par le nouveau numéro de port.
startup-plan-unsub.xml :
```
 <jvm:value>'OCI;SERVICE=DBHost:1524/DBPDBName'</jvm:value>
```
startup-plan.xml :
```
<jvm:value>'OCI;SERVICE=DBHost:1524/DBPDBName'</jvm:value>
```

Redémarrez Essbase.

cd <Oracle_HOME>/user_projects/domains/essbase_domain/esstools/bin
./start.sh