Wiki source code of GlassFish Installation
Version 29.1 by Thomas Mortagne on 2017/03/28
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}}{{toc/}}{{/box}} | ||
| 2 | |||
| 3 | {{error}}XWiki doesn't work on GlassFish versions 3.1.2 and 3.1.2.1 due to [[a bug>>https://java.net/jira/browse/GLASSFISH-18444]] which affects file uploads.{{/error}} | ||
| 4 | |||
| 5 | * Download the [[latest GlassFish>>http://glassfish.java.net/public/downloadsindex.html#top]] | ||
| 6 | * Download the exe for Windows or the shell script for Unix | ||
| 7 | * Start GlassFish instance using ##{{{$GLASSFISH_HOME/bin/asadmin start-domain}}}## | ||
| 8 | * Do you want to deploy from the web interface, or the commandline? | ||
| 9 | * Deploying from the web interface: | ||
| 10 | ** point your browser to ##{{{http://localhost:4848}}}## | ||
| 11 | ** log in as the default administrator user ##admin## with the default password ##adminadmin## | ||
| 12 | ** select ##Applications -> Web Applications -> Deploy## in the left tree | ||
| 13 | ** select the XWiki WAR archive to deploy and set the context root to ##xwiki## (anything else will make XWiki navigation break) | ||
| 14 | * Deploy from the commandline: | ||
| 15 | ** ##{{{$GLASSFISH_HOME/bin/asadmin deploy --contextroot xwiki file.war}}}## | ||
| 16 | * enjoy XWiki from ##{{{http://localhost:8080/xwiki}}}## | ||
| 17 | |||
| 18 | If you need more help you can use the [[GlassFish documentation>>http://glassfish.java.net/docs/project.html]]. | ||
| 19 | |||
| 20 | = Configuring a MySQL datasource in Glassfish = | ||
| 21 | |||
| 22 | * Download the [[MySQL jdbc driver>>http://www.mysql.com/downloads/connector/j/]] | ||
| 23 | * Extract the contents of the file | ||
| 24 | * 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 available locally (example: ##{{{GLASSFISH_HOME/glassfish/domains/domain1/applications/xwiki-enterprise-web-2.5-milestone-1/WEB-INF/lib}}}##) | ||
| 25 | * Start or restart the Glassfish server: ##{{{bin/asadmin start-domain}}}## or ##{{{bin/asadmin restart-domain}}}## | ||
| 26 | |||
| 27 | If you want to use the web interface to define a datasource, you can read this tutorial on [[Creating and configuring a MySQL DataSource in GlassFish Application Server>>http://www.albeesonline.com/blog/2008/08/06/creating-and-configuring-a-mysql-datasource-in-glassfish-application-server/]]. | ||
| 28 | |||
| 29 | If you want to use the command line interface to define a datasource, you can read [[this tutorial>>http://weblogs.java.net/blog/felipegaucho/archive/2010/03/04/glassfish-v3-resources-administration-cli-tool-asadmin]]. | ||
| 30 | |||
| 31 | Quick and dirty is easy: | ||
| 32 | * Create the connection pool: Assuming you followed the [[MySQL Installation steps>>AdminGuide.InstallationMySQL]] you have a MySQL database called 'xwiki' accessible with a user named 'xwiki' having 'xwiki' as the password. | ||
| 33 | * ##{{{asadmin create-jdbc-connection-pool --datasourceclassname com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource}}}## | ||
| 34 | ##{{{ --restype javax.sql.ConnectionPoolDataSource --property "User=xwiki:Password=xwiki:URL=jdbc\\:mysql\\://localhost\\:3306/xwiki" }}}## | ||
| 35 | ##{{{jdbc/xwikipool}}}## | ||
| 36 | * This should give you ##{{{Command create-jdbc-connection-pool executed successfully.}}}## | ||
| 37 | * Test the connection pool: ##{{{asadmin ping-connection-pool jdbc/xwikipool}}}## | ||
| 38 | * This should give you ##{{{Command ping-connection-pool executed successfully.}}}## | ||
| 39 | * If not, just execute ##{{{bin/asadmin delete-jdbc-connection-pool jdbc/xwikipool}}}## and start again :-) | ||
| 40 | * Create the JDBC resource: ##{{{asadmin --user=admin create-jdbc-resource --connectionpoolid jdbc/xwikipool jdbc/xwiki}}}## | ||
| 41 | * This should give you ##{{{Command create-jdbc-resource executed successfully.}}}## | ||
| 42 | * Test the JDBC resource: ##{{{asadmin --user admin list-jdbc-resources}}}## | ||
| 43 | * This should result in: | ||
| 44 | ##{{{jdbc/__TimerPool}}}## | ||
| 45 | ##{{{jdbc/__default}}}## | ||
| 46 | ##{{{jdbc/xwiki}}}## | ||
| 47 | ##{{{ }}}## | ||
| 48 | ##{{{Command list-jdbc-resources executed successfully.}}}## | ||
| 49 | |||
| 50 | 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##. | ||
| 51 | |||
| 52 | Uncomment the default database section (simpy by moving the {{{"-->"}}} part a couple of lines down), and uncomment the MySQL part. | ||
| 53 | |||
| 54 | Done! | ||
| 55 | |||
| 56 | = Troubleshooting = | ||
| 57 | |||
| 58 | First thing you would normally do is import the default xar file to initialize the wiki and populate it with some nice pages. | ||
| 59 | However, it is very likely that you will see an error message like: | ||
| 60 | |||
| 61 | {{code language="none"}} | ||
| 62 | com.xpn.xwiki.XWikiException: Error number 0 in 11: Uncaught exception | ||
| 63 | Wrapped Exception: org.apache.commons.codec.binary.Base64.<init>(I[B)V | ||
| 64 | {{/code}} | ||
| 65 | |||
| 66 | As explained in [[this email>>http://xwiki.markmail.org/search/?q=glassfish%20commons%20codec#query:glassfish%20commons%20codec+page:1+mid:dpg5gbkal6ysf3i5+state:results]] you should copy ##commons-codec-1.4.jar## from the ##xwiki/WEB-INF/lib## directory to the ##glassfishv3/glassfishmodules## and also delete ##commons-codec-repackaged.jar## from the ##glassfishv3/glassfish/modules## folder. | ||
| 67 | |||
| 68 | These steps should solve the problem. |
