Wiki source code of GlassFish Installation
Version 24.2 by Vincent Massol on 2010/09/23
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | * Download the latest GlassFish (currently v3.0.1) from [[here>>https://glassfish.dev.java.net/public/downloadsindex.html]] | ||
| 2 | * Donwload the exe for Windows or the shell script for Unix. | ||
| 3 | * Start GlassFish instance using ##{{{$GLASSFISH_HOME/bin/asadmin start-domain}}}## | ||
| 4 | * Do you want to deploy from the web interface, or the commandline? | ||
| 5 | * Deploying from the web interface: | ||
| 6 | ** point browser to##{{{http://localhost:4848}}}## | ||
| 7 | ** log in as default administrator user ##admin## with default password ##adminadmin## | ||
| 8 | ** select ##Applications -> Web Applications -> Deploy## in the left tree | ||
| 9 | ** select the XWiki WAR archive to deploy and set the context root to ##xwiki## (anything else will make XWiki navigation break) | ||
| 10 | * Deploy from the commandline: | ||
| 11 | ** ##{{{$GLASSFISH_HOME/bin/asadmin deploy --contextroot xwiki file.war}}}## | ||
| 12 | * enjoy XWiki from ##{{{http://localhost:8080/xwiki}}}## | ||
| 13 | |||
| 14 | The complete GlassFish Documentation is here: [[https://glassfish.dev.java.net/docs/project.html]] | ||
| 15 | |||
| 16 | = Configuring a MySQL datasource in Glassfish = | ||
| 17 | |||
| 18 | * Download the MySQL jdbc driver from [[here>>http://www.mysql.com/downloads/connector/j/]] | ||
| 19 | * Extract the contents of the file. | ||
| 20 | * Copy the jar file to ##{{{GLASSFISH_HOME/glassfish/lib}}}## if you want it to be available to all Glassfish applications, or to the ##{{{WEB-INF/lib}}}## dir of the xwiki deployment dir if you only want it to be locally available (example: ##{{{GLASSFISH_HOME/glassfish/domains/domain1/applications/xwiki-enterprise-web-2.5-milestone-1/WEB-INF/lib}}}##). | ||
| 21 | * Start or restart the Glassfish server: ##{{{bin/asadmin start-domain}}}## or ##{{{bin/asadmin restart-domain}}}## | ||
| 22 | |||
| 23 | Now if you want to use the web interface to define a datasource, you can find useful info [[here>>http://www.albeesonline.com/blog/2008/08/06/creating-and-configuring-a-mysql-datasource-in-glassfish-application-server/]]. | ||
| 24 | |||
| 25 | If you want to use the command line interface to define a datasource, you can find useful info [[here>>http://weblogs.java.net/blog/felipegaucho/archive/2010/03/04/glassfish-v3-resources-administration-cli-tool-asadmin]]. | ||
| 26 | |||
| 27 | Quick and dirty is easy: | ||
| 28 | * Create the connection pool: Assuming you did the MySQL stuff as explained [[here>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/InstallationMySQL]] you have a MySQL database called 'xwiki' accessable by a user 'xwiki' with password 'xwiki'. | ||
| 29 | * ##{{{asadmin create-jdbc-connection-pool --datasourceclassname com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource}}}## | ||
| 30 | ##{{{ --restype javax.sql.ConnectionPoolDataSource --property "User=xwiki:Password=xwiki:URL=jdbc\\:mysql\\://localhost\\:3306/xwiki" }}}## | ||
| 31 | ##{{{jdbc/xwikipool}}}## | ||
| 32 | * This should give you ##{{{Command create-jdbc-connection-pool executed successfully.}}}## | ||
| 33 | * Test the connection pool: ##{{{asadmin ping-connection-pool jdbc/xwikipool}}}## | ||
| 34 | * This should give you ##{{{Command ping-connection-pool executed successfully.}}}## | ||
| 35 | * If not, just execute ##{{{bin/asadmin delete-jdbc-connection-pool jdbc/xwikipool}}}## and start again :-) | ||
| 36 | * Create the JDBC resource: ##{{{asadmin --user=admin create-jdbc-resource --connectionpoolid jdbc/xwikipool jdbc/xwiki}}}## | ||
| 37 | * This should give you ##{{{Command create-jdbc-resource executed successfully.}}}## | ||
| 38 | * Test the JDBC resource: ##{{{asadmin --user admin list-jdbc-resources}}}## | ||
| 39 | * This should result in: | ||
| 40 | ##{{{jdbc/__TimerPool}}}## | ||
| 41 | ##{{{jdbc/__default}}}## | ||
| 42 | ##{{{jdbc/xwiki}}}## | ||
| 43 | ##{{{ }}}## | ||
| 44 | ##{{{Command list-jdbc-resources executed successfully.}}}## | ||
| 45 | |||
| 46 | Now the last thing you need to do is go into the directory ##{{{glassfish/domains/domain1/applications/xwiki-enterprise-web-2.5-milestone-1/WEB-INF}}}## and edit hibernate.cfg.xml. | ||
| 47 | |||
| 48 | Uncomment the default database section (simpy by moving the "-->" part a couple of lines down), and uncomment the MySQL part. | ||
| 49 | |||
| 50 | Done! | ||
| 51 | =Installing the default XAR file= | ||
| 52 | First thing you would normally do is import the default xar file to initialize the wiki and populate it with some nice pages. | ||
| 53 | However, it is very likely that you will see an error message like: | ||
| 54 | ##{{{ | ||
| 55 | com.xpn.xwiki.XWikiException: Error number 0 in 11: Uncaught exception | ||
| 56 | Wrapped Exception: org.apache.commons.codec.binary.Base64.<init>(I[B)V | ||
| 57 | }}}## | ||
| 58 | As explained [[here>>http://xwiki.markmail.org/search/?q=glassfish%20commons%20codec#query:glassfish%20commons%20codec+page:1+mid:dpg5gbkal6ysf3i5+state:results]] you have to do the following: | ||
| 59 | |||
| 60 | You should copy commons-codec-1.4.jar from the \xwiki\WEB-INF\lib to the \glassfishv3\glassfish\modules and also delete commons-codec-repackaged.jar in a \glassfishv3\glassfish\modules folder. | ||
| 61 | |||
| 62 | And that solves the problem. |
