Tel: 06 68 39 83 22|afid.benayad@gmail.com
///Tutoriel N° 11 – Genesys Administrator Extension

Installation Genesys Administrator Extension

Apprenez facilement à installer GAX

Description

Dans ce tutoriel faisant partie de la série intitulée « Genesys Tut’s », nous allons aborder l'installation de Genesys Administrator Extension « GAX ». Genesys Administrator Extension (GAX) introduit l'interface utilisateur nouvelle génération de Genesys qui réduit les coûts de fonctionnement généraux et les délais de déploiement en fournissant des interfaces conviviales qui effectuent des opérations complexes tout en prévenant les erreurs d'utilisateur. Ce produit met l'accent sur l'expérience utilisateur des entreprises et des clients hébergés tout en ciblant également les administrateurs système et les utilisateurs de services dédiés. Le serveur actuel est une VM sous ESX avec 4Go de mémoire, une carte réseau 1gb, un disque dur de 80Go, Processeur 12 Cœurs 1.9GHz Xeon, pour l’os j’ais déployé un Windows 2012 Server Standard Edition.
win2012Genesys-opt

Installation GAX

Base de données

Pour les besoins de GAX nous allons créer une nouvelle base de données que nous appellerons « gax ».

Sous Microsoft SQL server management studio créez une nouvelle base de données avec le compte sa ou autre compte dédier.

Image 1

Le Template

Comme d’habitude nous commençons par importer le Template de l’application, pour cela:

Allez sous Genesys Administrator ou CME et importez le Template « Remarque : le fichier Metadata fournit avec GAX n’est pas compatible avec Genesys Administrator, donc inutile de l’importer).

Image 2

Les DAP

Gax a besoin de se connecter à sa base de données, et si vous souhaitez superviser les alarmes il doit aussi accéder a la table de log, cependant gax n’utilise pas des DAP standard mais des JDAP.

Nous aurons besoins donc de créer le JDAP_Log, le JDAP_Gax sera créé par gax au moment de l’installation.

Utilisez le Template DAP afin de créer la nouvelle application et renseignez les champs comme ceci en adaptant à vos besoins

Image 6

Image 7

Allez dans Options et ajoutez la section GAX, option role valeur auditing

Image 29

L’application

Créez la nouvelle application gax en utilisant le Template précédemment créé.

Image 3

Sélectionnez le host, puis au niveau du port sélectionnez le port 8080.

Ajoutez la connexion au JDAP_Log créé précédemment

Ajoutez la connexion au SCS

Prérequis

Gax utilise java, vous devez donc installer JRE, (pour ma part je l’installe dans le dossier : « d:\appwin\Java\Jre8« , une fois l’installation de java effectuée, modifiez les variables d’environnements VARIABLE SYSTÈME en ajoutant 2 nouvelles variable
JRE_HOME : d:\appwin\Java\Jre8,
JAVA_HOME : d:\appwin\Java\Jre8
puis modifiez le Path en ajoutant ;%JRE_HOME%; %JRE_HOME%bin

Relancez votre serveur afin de prendre en compte les modifications systèmes

Le setup d’installation

Depuis le dossier source exécutez le setup.exe en mode administrateur, puis cliquez sur Next

Image 12

Adaptez le dossier d’installation selon votre besoin, puis cliquez sur Next

Image 13

Cliquez sur Install

Image 14

Cliquez sur Finish

Image 15

Premier lancement

La première exécution de gax permet de finaliser le paramétrage.

Ouvrez une fenêtre command (terminal), allez dans le dossier d’installation de gax, pour ma part ce sera

D:
CD GCTI\GENESYS_ADMINISTRATOR_EXTENSION

Puis exécutez

GAX_STARTUP.BAT

Plusieurs lignes de commandes vont dérouler à l’écran, arrivé à la ligne ce finissant par

[102] ASD initialized

Laissez la fenêtre du terminal ouverte et ouvrez votre navigateur (Chrome) puis saisissez dans la barre d’adresse http://win2012genesys:8080/gax

Une fenêtre de saisie apparait, dans la partie login saisissez root sans mot de passe, puis validez

Image 16

Une nouvelle fenêtre s’ouvre, sélectionnez Existing Deployement

Image 18

Renseignez les champs afin de se connecter au config Server, puis cliquez sur Next

Image 19

Sélectionnez Use Existing puis Sélectionnez gax (Recommended) dans le menu déroulant

Image 21

Sélectionnez MS SQL Server, puis renseignez les champs de connexion à la base de données gax, puis cliquez sur Next (création du JDAP_Gax)

Image 22

Cliquez sur Finish

Image 23

Patientez quelques instants, le temps que gax redémarre, en attendant contrôlez que la base de données gax soit bien alimentée via Microsoft Sql Server Management Studio.

Image 24

Vous pouvez à présent fermer la fenêtre terminale

Après le redémarrage de gax votre navigateur vous invite à vous connecter à nouveau, cette fois connectez-vous avec votre compte default

Image 26

Gax a créé un DAP afin de se connecter à sa base de données, vous pouvez le renommer (JDAP_Gax) et le déplacer dans le dossier de votre choix.

A présent vous devriez avoir ceci

Image 30

Image 31

Image 32

Afficher le menu Agents

Par défaut le menu permettant la gestion des agents est masqué.

Image 35

Image 34

Allez dans le menu en à droite et cliquez sur votre compte, un menu s’affiche, cliquez sur System Preferences

Image 36

Cliquez sur Agent Management

Image 37

Sélectionnez Premise, puis validez

Image 38

Rafraichissez la page web (F5), le menu Agent est à présent disponible.

Francisez Gax

Personnellement je préfère garder les interfaces d’administration en Anglais, mais si vous souhaitez avoir l’interface en français, il vous suffit de télécharger Gax Language Pack FR, le décompresser puis d’exécuter le setup.

Relancez gax.

Vous pouvez personnaliser

Allez dans le menu en à droite et cliquez sur votre compte, un menu s’affiche, cliquez sur User preferences

Image 39

Sélectionnez locale et validez

Image 40

Modifiez vos préférences, cela n’impacte que votre profile.

Image 41

Astuces:

Les logs

Par défaut gax enregistre des fichiers de log (gaxservice_yyyy_mm_dd.log) dans le dossier d’installation, ces fichiers sont différent des fichiers de logs habituels. afin de modifier le dossier de stockage éditez le fichier

GCTI\GENESYS_ADMINISTRATOR_EXTENSION\conf\gax.properties

ajoutez la ligne suivante en l’adaptant a votre dossier de log:

 

 

accesslog_filename=Z:/Logs/gax/gaxservice_yyyy_mm_dd.log

 

Voici un exemple de fichier de config:

# Enables HTTP access logging (true, false)
accesslog_enabled=true

# File name for the HTTP access log (./logs/http-yyyy_mm_dd.log)
accesslog_filename=D:/Logs/Framework/Gax/http-yyyy_mm_dd.log

# Time zone for the HTTP access log (Any valid timezone code - see Time Zones for a list)
accesslog_timezone=GMT

# After GAX is restarted, specifies whether to append to existing HTTP access log (true, false)
accesslog_append=true

# Specifies whether to include extended information in the HTTP access log (true, false)
accesslog_extended=false

#  	Specifies whether to include cookies in the HTTP access log (true, false)
accesslog_cookies=false

# Specifices number of days to retain the HTTP access log (<integer>)
accesslog_retaindays=90

# Specifies the GAX Application object (<Existing Application object name>)
app=Genesys Administrator Server

# Specifies the backup Configuration Server Host & Port, written as a Fully Qualified Domain Name (FQDN) or IP 	Valid FQDN or IP (IF THERE IS ONE ONLY)
backup_port=2020
backup_host=

# Enables real-time notification if the configuration object currently being modified has been updated by another user while the current user was modifying it; that is, since the object's properties window was opened. See Coordinating Simultaneous Changes to Data.
# Note: This feature is currently supported only in the Configuration Manager view (true, false).
enable_web_notification=true

# Specifies the primary Configuration Server Host & Port, written as a Fully Qualified Domain Name (FQDN) or IP (Valid FQDN or IP)
host=roswell
port=2020

# Defines the HTTP (or HTTPS) port (integer)
http_port=8080
https_port=8443

# Specifies the keystore path (Valid path)
# keystore_path=

# Specifies the keystore password
# Note: The password is encrypted and must not be modified directly. Instead, refer to Step 4 of Setting up HTTPS for use with Genesys Administrator Extension.
# keystore_password

# Specifies the maximum number of connections to allow from GAX to Configuration Server. To allow unlimited connections, set the value to -1 (-1 or any positive integer)
max_cfg_connection=200

# Specifies the maximum idle time, in milliseconds, before automatic logout (integer)
max_idle_time=1000*60*60

# Specifies the root URL (host:port/rootURL)
root_url=/gax

# Defines the protocol to use when communicating with the server (http/https/both)
supported_protocol=http

 

Interface

vous avez plusieurs environnement et chacun possède un GAX, or vous souhaitez pouvoir identifier rapidement sur quel environnement vous êtes connecté car hormis l’url rien ne vous permet de faire le distinguo.

1- Ajouter le nom de l’env dans le menu top a droite de GAX :

A la base le menu ressemble a ceci:

Le but est donc d’avoir ceci:Pour cela éditez le fichier main.js ce trouvant dans le dossier Gax puis sous webapp\scripts

Reperez le bloc suivant

t.view = r.widgets.Widget.create({
type: "MainView",
NavigationBar: {
product: "GAX",
identity: l,
onLogout: function() {
t._logout("LOG_OUT_SUCCESS");
},

Après GAX ajoutez le nom de votre env. ex: GAX Recette

t.view = r.widgets.Widget.create({
type: "MainView",
NavigationBar: {
product: "GAX Recette",
identity: l,
onLogout: function() {
t._logout("LOG_OUT_SUCCESS");
},

Sauvegardez puis recharger la page Gax, vous devriez avoir avoir a présent ceci

 

 

 

Pour allez plus loin nous pouvons modifier la couleur gris/noir du menu top

Pour cela éditez le fichier gax\webapp\scripts\extensions\navigation\navigation.css

Recherchez le code suivant:

.gx-navigation{background:#222529 url(i/navigation-bg.png) 0 100% repeat-x;color:#FDFDFD;min-width:768px;height:40px;font-size:12px;box-shadow:0px 1px 0px 0px rgba(34,37,41,0.4);}

Remplacez la valeur du background #222529 par votre couleur pour ma part je choisi #1646A7

Enregistrez puis rechargez la page gax

Résultat:

Avant

Après

Attention: En cas de mise a jour de GAX, ces modifications seront perdus et devrons êtres renouvelés

Fin

Note des lecteurs5 Notes4.65
By |2018-08-10T12:20:23+00:0007 mai 2016|Genesys, Tutoriels|0 Comments

About the Author:

Après avoir appris sur le tas, quoi de plus normal que de partager à son tour ? Passionné par le monde des centres d’appel depuis un peu plus de 12 ans maintenant j'aime partager mes compétences et mes découvertes avec les personnes qui ont cette même passion.

Leave A Comment