Dokumentacja wdrożeniowa Project Lord 1.0

Transkrypt

1 Dokumentacja wdrożeniowa Project Lord 1.0

2 Spis treści 1. Wymagane oprogramowanie Instalacja aplikacji ProjectLord na serwerze JBoss Instalacja sterownika bazy danych na serwerze JBoss PostgreSQL MySQL Tworzenie źródła danych na serwerze JBoss PostgreSQL MySQL Utworzenie bazy danych Wdrożenie aplikacji na serwerze JBoss Instalacja aplikacji ProjectLord na serwerze GlassFish Instalacja sterownika bazy danych na serwerze GlassFish PostgreSQL MySQL Tworzenie źródła danych na serwerze Glassfish PostgreSQL MySQL Utworzenie bazy danych Wdrożenie aplikacji na serwerze GlassFish

3 1. Wymagane oprogramowanie Dokumentacja wdrożeniowa, Project Lord 1.0 Do działania aplikacja ProjectLord wymagane jest następujące oprogramowanie: 1. Serwer aplikacyjny: JBoss (lub nowszy) lub GlassFish (lub nowszy) 2. Baza danych: PostgreSQL 9.1 (lub nowsza) lub MySQL (lub nowsza). 2. Instalacja aplikacji ProjectLord na serwerze JBoss Instalacja sterownika bazy danych na serwerze JBoss PostgreSQL Do katalogu [jboss_home]\modules\org serwera (jeżeli serwer znajduje się w katalogu C:\jboss, pełna ścieżka to: C:\jboss\modules\org) należy skopiowad katalog postgresql. Zawiera on katalog main, w którym znajduje się sterownik do bazy PostgreSQL tj. plik postgresql jdbc4.jar oraz plik module.xmlo zawartości: <?xml version="1.0" encoding="windows-1250"?> <module xmlns="urn:jboss:module:1.0" name="org.postgresql"> </module> <resources> <resource-root path="postgresql jdbc4.jar"/> </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> MySQL Do katalogu [jboss_home]\modules\com serwera (jeżeli serwer znajduje się w katalogu C:\jboss, pełna ścieżka to: C:\jboss\modules\com) należy skopiowad katalog mysql. Zawiera on katalog main, w którym znajduje się sterownik do bazy MySQL tj. plik mysqlconnector-java bin.jar oraz plik module.xml o zawartości: <?xml version="1.0" encoding="windows-1250"?> <module xmlns="urn:jboss:module:1.0" name="com.mysql"> <resources> <resource-root path="mysql-connector-java bin.jar"/> 3

4 </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> </module> 2.2. Tworzenie źródła danych na serwerze JBoss Po instalacji sterownika do bazy danych można utworzyd połączenie z bazą danych. W tym celu należy dokonad modyfikacji pliku konfiguracyjnego serwera tj. [jboss_home]\standalone\configuration\standalone.xml (jeżeli serwer znajduje się w katalogu C:\jboss, pełna ścieżka to: C:\jboss\standalone\configuration\standalone.xml). Nazwa źródła danych wykorzystywana w aplikacji to: ProjectLordDS PostgreSQL W pliku standalone.xml należy znaleźd sekcję <subsystem xmlns="urn:jboss:domain:datasources:1.0"> i umieścid w niej zawartości plików postgres-datasource.txt oraz postgresqldriver.txt, zgodnie z poniższym wzorem: <subsystem xmlns="urn:jboss:domain:datasources:1.0"> <datasources> //tu wklej zawartość pliku postgresql-datasource.txt </datasource> <drivers> //tu wklej zawartość pliku postgresql-driver.txt </drivers> </subsystem> Zawartośd pliku postgresql-datasource.txt: <datasource jta="true" jndi-name="java:/projectlordds" poolname="projectlordds" enabled="true" use-java-context="true" useccm="true"> <connectionurl>jdbc:postgresql://localhost/projectlord</connection-url> <driver>org.postgresql</driver> 4

5 Zawartośd pliku postgresql-driver.txt: <driver name="org.postgresql" module="org.postgresql"> <pool> <min-pool-size>1</min-pool-size> <max-pool-size>20</max-pool-size> <prefill>false</prefill> <use-strict-min>false</use-strict-min> <flush-strategy>failingconnectiononly</flush-strategy> </pool> <security> <user-name>postgres</user-name> <password>admin</password> </security> <validation> <check-valid-connection-sql>select 1</check-validconnection-sql> <validate-on-match>false</validate-on-match> <background-validation>false</background-validation> </validation> </datasource> <xa-datasource-class>org.postgresql.xa.pgxadatasource</xadatasource-class> </driver> Domyślne ustawienia do bazy danych to: Login: postgres. Hasło: admin. Jeżeli wykorzystywana przez aplikację baza danych PostgreSQL ma ustawione inne wartości, należy w sekcji <security> (plik postgresql-datasource.txt) wprowadzid poprawne dane: <security> </security> <user-name>login</user-name> <password>hasło</password> Po wykonaniu tych czynności należy zrestartowad serwer. 5

6 MySQL W pliku standalone.xml należy znaleźd sekcję <subsystem xmlns="urn:jboss:domain:datasources:1.0"> i umieścid w niej zawartości plików mysql-datasource.txt oraz mysql-driver.txt, zgodnie z poniższym wzorem: <subsystem xmlns="urn:jboss:domain:datasources:1.0"> <datasources> //tu wklej zawartość pliku mysql-datasource.txt </datasource> <drivers> //tu wklej zawartość pliku mysql-driver.txt </drivers> </subsystem> Zawartośd pliku mysql-datasource.txt: <datasource jta="true" jndi-name="java:/projectlordds" poolname="projectlordds" enabled="true" use-java-context="true" useccm="true"> <connectionurl>jdbc:mysql://localhost:3306/projectlord</connection-url> <driver>com.mysql</driver> <security> <user-name>root</user-name> <password>admin</password> </security> <statement> <prepared-statement-cache-size>100</prepared-statementcache-size> <share-prepared-statements>true</share-prepared-statements> </statement> </datasource> Zawartośd pliku mysql-driver.txt: 6

7 <driver name="com.mysql" module="com.mysql"> <xa-datasourceclass>com.mysql.jdbc.jdbc2.optional.mysqlxadatasource</xadatasource-class> </driver> Domyślne ustawienia do bazy danych to: Login: root. Hasło: admin. Jeżeli wykorzystywana przez aplikację baza danych MySQL ma ustawione inne wartości, należy w sekcji <security> (plik mysql-datasource.txt) wprowadzid poprawne dane: <security> </security> <user-name>login</user-name> <password>hasło</password> Po wykonaniu tych czynności należy zrestartowad serwer Utworzenie bazy danych Kolejnym krokiem jaki należy wykonad jest utworzenie bazy danych o nazwie projectlord Wdrożenie aplikacji na serwerze JBoss Aby wdrożyd aplikację na serwerze JBoss należy uruchomid serwer, klikając dwukrotnie w plik standalone.bat znajdujący się w katalogu [jboss_home]\bin serwera (C:\jboss\bin\standalone.bat), a następnie zalogowad się do panelu administratora, wpisując w przeglądarce adres: Pojawi się okno, w którym należy podad nazwę i hasło użytkownika. Z menu panelu administratora w menu górnym trzeba kliknąd Runtime, po czym z menu bocznego należy wybrad zakładkę Deployments/Manage Deployments, a następnie kliknąd przycisk Add Content znajdujący się nad tabelą, zawierającą wdrożone aplikacje. Pojawi się okno, w którym trzeba wskazad lokalizację pliku wdrożeniowego (ProjectLord-ear-1.0- SNAPSHOT.ear). Po wybraniu pliku należy kliknąd Next, a następnie Save. Jeśli aplikacja wdroży się na serwerze pomyślnie, pojawi się w tabeli. Aby była dostępna trzeba kliknąd przycisk Enable i potwierdzid to w oknie dialogowym, klikając Confirm. Od tej pory aplikacja będzie dostępna pod adresem: 7

8 3. Instalacja aplikacji ProjectLord na serwerze GlassFish 3.1. Instalacja sterownika bazy danych na serwerze GlassFish Do katalogu [glassfish_home]\glassfish\domains\domain1\lib\ serwera należy skopiowad plik commons-logging.jar PostgreSQL Skopiuj sterownik do bazy danych PostgreSQL tj. plik postgresql jdbc4.jar do katalogu [glassfish_home]\glassfish\domains\domain1\lib\ serwera (domyślna nazwa domeny w GlassFish to domain1). Zrestartuj serwer MySQL Skopiuj sterownik do bazy danych MySQL tj. plik mysql-connector-java bin.jar do katalogu [glassfish_home]\glassfish\domains\domain1\lib\ serwera (domyślna nazwa domeny w GlassFish to domain1). Zrestartuj serwer Tworzenie źródła danych na serwerze Glassfish PostgreSQL Zaloguj się do panelu administratora i wybierz Resources/JDBC/JDBC Connection Pools. Utwórz nową pulę połączeo o nazwie ProjectLordDS, wybierz typ zasobu javax.sql.connectionpooldatasource oraz dostawcę bazy danych Postgresql i kliknij Next. 8

9 Wybierz nazwę klasy źródła danych org.postgresql.ds.pgconnectionpooldatasource. Następnie wprowadź następujące wartości w tabeli Additional Properties: DatabaseName: projectlord ServerName: localhost (nazwa serwera / IP) PortNumber: 5432 (port serwera bazy danych) User: postgres (użytkownik bazy danych) Password: admin (hasło do bazy danych) Kliknij Finish, żeby zapisad pulę połączeo. Aby sprawdzid czy połączenie zostało poprawnie skonfigurowane, z tabeli zawierającej zdefiniowane pule połączeo należy wybrad ProjectLordDS i kliknąd Ping. Powinien wyświetlid się komunikat "Ping Succeeded". Aby połączenie mogło byd używane przez aplikację należy zdefiniowad nazwę JNDI. W tym celu przejdź do Resources/JDBC/JDBC Resources. Kliknij New i wprowadź następujące dane: JNDI Name: ProjectLordDS Pool Name: ProjectLordDS Kliknij OK. 9

10 MySQL Zaloguj się do panelu administratora i wybierz Resources/JDBC/JDBC Connection Pools. Utwórz nową pulę połączeo o nazwie ProjectLordDS, wybierz typ zasobu javax.sql.connectionpooldatasource oraz dostawcę bazy danych MySql i kliknij Next. Wybierz nazwę klasy źródła danych com.mysql.jdbc2.optional.mysqlconnectionpooldatasource. 10

11 Następnie wprowadź następujące wartości w tabeli Additional Properties: DatabaseName: projectlord ServerName: localhost (nazwa serwera / IP) PortNumber: 3306 (port serwera bazy danych) User: admin (użytkownik bazy danych) Password: admin (hasło do bazy danych) Kliknij Finish, żeby zapisad pulę połączeo. Aby sprawdzid czy połączenie zostało poprawnie skonfigurowane, z tabeli zawierającej zdefiniowane pule połączeo należy wybrad ProjectLordDS i kliknąd Ping. Powinien wyświetlid się komunikat "Ping Succeeded". Aby połączenie mogło byd używane przez aplikację należy zdefiniowad nazwę JNDI. W tym celu przejdź do Resources/JDBC/JDBC Resources. Kliknij New i wprowadź następujące dane: JNDI Name: ProjectLordDS Pool Name: ProjectLordDS Kliknij OK. 11

12 3.3. Utworzenie bazy danych Kolejnym krokiem jaki należy wykonad jest utworzenie bazy danych o nazwie projectlord Wdrożenie aplikacji na serwerze GlassFish Aby wdrożyd aplikację na serwerze GlassFish należy uruchomid serwer, klikając dwukrotnie w plik asadmin.bat znajdujący się w katalogu [glassfish-home]\bin serwera (C:\glassfish3\bin\asadmin.bat), a następnie wpisad start-domain domain1 (domyślna nazwa domeny w GlassFish to domain1). Następnie trzeba zalogowad się do panelu administratora, wpisując w przeglądarce adres: Pojawi się okno, w którym należy podad nazwę i hasło użytkownika. Z menu panelu administratora należy wybrad zakładkę Applications, a następnie kliknąd przycisk Deploy znajdujący się w tabeli, zawierającej wdrożone aplikacje. W otwartym formularzu należy wskazad lokalizację pliku wdrożeniowego (ProjectLord-ear-1.0- SNAPSHOT.ear). Po wybraniu pliku należy kliknąd OK. Jeśli aplikacja wdroży się na serwerze pomyślnie, pojawi się w tabeli. Od tej pory aplikacja będzie dostępna pod adresem: 12