Dokumentacja wdrożeniowa Project Lord 1.0
Spis treści 1. Wymagane oprogramowanie... 3 2. Instalacja aplikacji ProjectLord na serwerze JBoss 7.1.1... 3 2.1. Instalacja sterownika bazy danych na serwerze JBoss 7.1.1... 3 2.1.1. PostgreSQL... 3 2.1.2. MySQL... 3 2.2. Tworzenie źródła danych na serwerze JBoss 7.1.1... 4 2.2.1. PostgreSQL... 4 2.2.2. MySQL... 6 2.3. Utworzenie bazy danych... 7 2.4. Wdrożenie aplikacji na serwerze JBoss 7.1.1... 7 3. Instalacja aplikacji ProjectLord na serwerze GlassFish... 8 3.1. Instalacja sterownika bazy danych na serwerze GlassFish... 8 3.1.1. PostgreSQL... 8 3.1.2. MySQL... 8 3.2. Tworzenie źródła danych na serwerze Glassfish... 8 3.2.1. PostgreSQL... 8 3.2.2. MySQL... 10 3.3. Utworzenie bazy danych... 12 3.4. Wdrożenie aplikacji na serwerze GlassFish... 12 2
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 7.1.1 (lub nowszy) lub GlassFish 3.1.2 (lub nowszy) 2. Baza danych: PostgreSQL 9.1 (lub nowsza) lub MySQL 5.6.10 (lub nowsza). 2. Instalacja aplikacji ProjectLord na serwerze JBoss 7.1.1 2.1. Instalacja sterownika bazy danych na serwerze JBoss 7.1.1 2.1.1. 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-9.1-902.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-9.1-902.jdbc4.jar"/> </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> 2.1.2. 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-5.1.24-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-5.1.24-bin.jar"/> 3
</resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> </module> 2.2. Tworzenie źródła danych na serwerze JBoss 7.1.1 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. 2.2.1. 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
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
2.2.2. 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
<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. 2.3. Utworzenie bazy danych Kolejnym krokiem jaki należy wykonad jest utworzenie bazy danych o nazwie projectlord. 2.4. Wdrożenie aplikacji na serwerze JBoss 7.1.1 Aby wdrożyd aplikację na serwerze JBoss 7.1.1 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: http://localhost:9990. 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: http://localhost:8080/projectlord/. 7
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. 3.1.1. PostgreSQL Skopiuj sterownik do bazy danych PostgreSQL tj. plik postgresql-9.1-902.jdbc4.jar do katalogu [glassfish_home]\glassfish\domains\domain1\lib\ serwera (domyślna nazwa domeny w GlassFish to domain1). Zrestartuj serwer. 3.1.2. MySQL Skopiuj sterownik do bazy danych MySQL tj. plik mysql-connector-java-5.1.24- bin.jar do katalogu [glassfish_home]\glassfish\domains\domain1\lib\ serwera (domyślna nazwa domeny w GlassFish to domain1). Zrestartuj serwer. 3.2. Tworzenie źródła danych na serwerze Glassfish 3.2.1. 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
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
3.2.2. 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
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
3.3. Utworzenie bazy danych Kolejnym krokiem jaki należy wykonad jest utworzenie bazy danych o nazwie projectlord. 3.4. 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: http://localhost:4848. 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: http://localhost:8080/projectlord/. 12