Installation Payara

Téléchargement du zip

Ouvrez la page https://www.payara.fish. Cliquez sur "Sofware > Payara Server". Clliquez sur "Payara Server Download". Cliquez sur "Payara Server 192 Download" ("192 dépend du numéro de la dernière version que vous téléchargez ; au moment de l'écriture de ces lignes il s'agit de la version 5.192).

Télécharger Payara sur http://www.payara.fish/downloads. Choisir la dernière version 5, par exemple Payara Server 5.192 en cliquant sur "Payara Server Full 192". Téléchargez une version "Full", pas une version "Micro".

Vous récupérez un fichier zip d'environ 140 Mo (payara-5.192.zip par exemple). L'installation de Payara est très simple : Il suffit de dézipper le fichier zip dans un répertoire quelconque. Sur la page http://blog.payara.fish/getting-started-with-payara-server vous avez une vidéo qui explique ce qu'il faut faire mais vous pouvez vous arrêter à la 1ère minute car ce qui est expliqué ensuite pourra être fait via NetBeans (écoutez les 2 minutes suivantes si vous êtes curieux).

La racine du zip s'appelle payara5 ; donc elle ne tient pas compte des numéros de version après le 5. Si vous voulez distinguer 2 versions 5 il vous faudra donc dézipper dans un répertoire qui distingue le numéro de version complet.

Choix du répertoire où dézipper pour Windows

Le plus simple et le plus sûr est de dézipper dans un autre répertoire que "C:\Program Files", par exemple un répertoire "C:\autresprogrammes\payara5.192". Évitez les caractères particuliers dans le nom absolu du répertoire (espaces,...), on ne sait jamais...

Intégration de Payara dans NetBeans

Après avoir installé Payara, il faut le déclarer comme serveur d'application dans NetBeans.

  1. Lancez NetBeans
  2. Onglet Services > Servers, clic droit et « Add Server… »
  3. Dans la fenêtre "Choose Server", donnez un nom au nouveau serveur (champ "Name"), par exemple « Payara 5.183 », et choisissez "GlassFish Server" pour le champ "Server". Cliquer ensuite sur le bouton Next.
  4. Dans la fenêtre "Server Location indiquer le répertoire où vous avez installé Payara (le répertoire qui contient les sous-répertoires bin, glassfish, javadb,... ; le répertoire payara5 pour l'exemple ci-dessus). Le message " Detected a GlassFish Server 5 install. Click Next to register remote or custom local domains" doit s'afficher en bas de la fenêtre si le répertoire est correct. Laissez coché "Local Domain" et ne cochez pas la case "I have read...". Cliquer sur Next.
  5. Dans la fenêtre "Domain Location" laisser les informations déjà entrées, en particulier "domain1" comme nom de domaine. Le nom d'utilisateur et le mot de passe ne sont requis que si on veut accéder à distance à ce serveur ; les laisser vides. Cliquer sur Finish.
  6. Payara ne fonctionne pas avec les dernières versions de Java SE. Il faut une version 8 de Java SE. Installez-la si vous ne l'avez pas déjà fait. Ensuite il faut dire que Payara utilise cette version : clic droit sur le serveur installé, choisir Properties. Onglet "Java" (à côté de Common) et désignez un JDK 1.8 installé sur votre ordinateur.
  7. Pour tester, lancez le serveur avec l'onglet Services de NetBeans : dans "Servers", clic droit sur le nom du serveur que vous venez d'installer et "Start". Il faut cliquer sur "Autoriser l'accès" si une fenêtre "Alerte de sécurité Windows" s'affiche et dit que le pare-feu a bloqué des fonctionnalités pour java.exe. Dans l'onglet Output en bas à droite de la fenêtre NetBeans doit s'ouvrir un sous-onglet du nom que vous avez donné au serveur. Ce sont les logs du serveur qui s'affichent. Vérifiez qu'il ne s'y affichent pas de messages d'erreur graves. Il se peut que vous ayez des erreurs dues à des certificats de sécurité expirés mais ce type d'erreur ne devraient pas empêcher vos projets de fonctionner.
  8. Pour confirmer que tout s'est bien passé vous pouvez ouvrir la console d'administration du serveur par clic droit sur le nom du serveur (dans l'onglet Services) et choisissez "View Domain Admin Console". La console d'administration doit s'ouvrir dans votre navigateur avec l'URL http://localhost:4848/common/index.jsf (vous remarquez que l'interface utilisateur utilise JSF). Elle met un certain temps à s'afficher. Si elle s'affiche c'est l'installation s'est bien passée et vous pouvez fermer l'onglet du navigateur.
  9. A la date d'écriture de ce document un bug empêche l'API de validation des beans d'être intégrée dans les applications. Ne faites ce qui suit que si vous ne trouvez pas le paquetage javax.validation dans la liste des paquetages de la librairie "Payara" (pour le savoir ouvrez l'entrée "Payaraxxx" de "Libraries" de votre projet NetBeans) :

Lorsque le serveur d'application est installé, allez dans NetBeans, onglet Services. Clic droit sur le serveur installé et choisissez Properties. Dans l'onglet Common sont affichés l'emplacement d'installation, le nom et le répertoire du domaine utilisé par le serveur, ainsi que d'autres informations diverses.

Vous pourrez trouver des informations complémentaires basiques sur Payara dans la page http://info.payara.fish/beginners-guide-to-payara-server (pas indispensable pour le moment).

Problèmes éventuels

Il se peut que les ports HTTP utilisés par Payara soient déjà utilisés par d'autres logiciels et vous aurez alors un message du type "Could not start Payara xxx: HTTP or HTTPS listener port is occupied while server is not running". Voici une aide si vous êtes dans ce cas.