{"id":15669574,"url":"https://github.com/adamretter/xmlss-hands-on-apps","last_synced_at":"2026-01-07T17:45:02.114Z","repository":{"id":4735878,"uuid":"5884912","full_name":"adamretter/xmlss-hands-on-apps","owner":"adamretter","description":"XML Summer School - Hands On - XML Applications","archived":false,"fork":false,"pushed_at":"2012-09-20T11:06:50.000Z","size":499,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-05T07:13:50.299Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"XQuery","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adamretter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-09-20T10:22:50.000Z","updated_at":"2019-07-06T18:39:17.000Z","dependencies_parsed_at":"2022-09-22T21:41:36.931Z","dependency_job_id":null,"html_url":"https://github.com/adamretter/xmlss-hands-on-apps","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamretter%2Fxmlss-hands-on-apps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamretter%2Fxmlss-hands-on-apps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamretter%2Fxmlss-hands-on-apps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamretter%2Fxmlss-hands-on-apps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamretter","download_url":"https://codeload.github.com/adamretter/xmlss-hands-on-apps/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246277351,"owners_count":20751548,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T14:40:22.056Z","updated_at":"2026-01-07T17:45:02.078Z","avatar_url":"https://github.com/adamretter.png","language":"XQuery","funding_links":[],"categories":[],"sub_categories":[],"readme":"XML Summer School - Hands On - Applications\n-------------------------------------------\nThese are the applications used for teaching the \"Hands On\" course\nat the XML Summer School 2012. http://xmlsummerschool.com/curriculum-2012/hands-on-introduction-2012/\n\nThe source repository now lives here on GitHub.\n\nThe seewhatithink.com application runs on eXist-db 2.0 and is provided as a database backup. To install\neXist-db visit http://www.exist-db.org.\n\nThe Printer application is written in Scala and requires you to have Maven installed to compile\nand run the application. Maven can be installed by visiting http://maven.apache.org/\n\nAbout\n-----\nThese are the instructions for installing the seewhatithink.com\ntraining Web Application, Printer Application and class room tools\ninto an Oracle VirtialBox Virtual Machine with Ubuntu Linux\nfor the XML Summer School www.xmlsummerschool.com\n\nIf you have a Ubuntu Linux machine then you may ignore the\nVirtual Box pre-requisite install steps.\n\nAuthor: Adam Retter \u003cadam.retter@googlemail.com\u003e\nLicence: Apache License Version 2.0\n\n\n\nRequirements\n------------\nOracle/Sun Virtual Box \u003e= 4.1.0\navailable from - http://www.virtualbox.org/wiki/Downloads\n\nUbuntu Linux 10.04 LTS Desktop Install CD (32 bit or 64 bit)\navailable from - http://www.ubuntu.com/download/ubuntu/download\n\n\n\nVirtual Box Pre-requisites\n--------------------------\n1) Install the VirtualBox software for your Operating System.\n\n2) Install a Ubuntu Virtual Machine into Virtual Box\n\n3) Install the VBox Guest Additions into Virtual Box\nWhen prompted choose the username 'xmlss' for the default user\nand the password 'xmlss'.\n\nNOTE - Exact instructions for the above have not been detailed,\nas they can easily be found via Google.\n\n\n\nHow to Install XMLSS Training Application Pre-Requisites\n--------------------------------------------------------\nThe training applications for the XMLSS require\nSubversion client, Sun JDK 6, Maven 3, Scala 2.9\nand MySQL Server 5.1 to be installed first.\n\n1) Enable the lucid patner package repository, by uncommenting the line from /etc/apt/sources.list e.g.\n\nsudo vi /etc/apt/sources.list\n\ndeb http://archive.canonical.com/ubuntu lucid partner\n\n\n2) Install Subversion, MySQL Server 5.1 and Sun JDK 6 packages\n\nsudo apt-get install subversion mysql-server sun-java-6-jdk sun-java-6-source sun-java-6-fonts sun-java-6-plugin\n\nWhen prompted set the mysql root password as 'root'\n\n\n3) Set the JAVA_HOME environment variable.\nAppend the following line to the file /home/xmlss/.profile\n\nexport JAVA_HOME=\"/usr/lib/jvm/java-6-sun\"\n\n\n4) Download and install Maven 3.0.3 from maven.apache.com\nwget http://mirrors.ukfast.co.uk/sites/ftp.apache.org//maven/binaries/apache-maven-3.0.3-bin.tar.gz\ntar zxvf apache-maven-3.0.3-bin.tar.gz\nsudo mv apache-maven-3.0.3 /usr/local\nsudo ln -s /usr/local/apache-maven-3.0.3 /usr/local/maven\n\n\n5) Download and install Scala 2.9.1 from www.scala-lang.org\nwget http://www.scala-lang.org/downloads/distrib/files/scala-2.9.1.final-installer.jar\nsudo java -jar ./scala-2.9.1.final-installer.jar\n\nWhen prompted, choose /usr/local/scala as the installation path.\n\n\n6) Add Maven and Scala to your PATH environment variable.\nAppend the following line to /home/xmlss/.profile\n\nPATH=\"$PATH:/usr/local/maven/bin:/usr/local/scala/bin\"\n\n\n\nHow to Install XMLSS whatithink.com eXist-db Training Web Application\n---------------------------------------------------------------------\n1) Checkout eXist-db trunk from SourceForge Subversion e.g.\n\nsudo svn co http://svn.code.sf.net/p/exist/code/trunk/eXist /usr/local/eXist\nsudo chown -R xmlss:xmlss /usr/local/eXist\n\n\n2) Set an Environment Variable EXIST_HOME that points to the location where you just checked out eXist-db.\nAppend the following line to /home/xmlss/.profile, and also execute the same line at the command prompt.\n\nexport EXIST_HOME=\"/usr/local/eXist\"\n\n\n3) Enable the xslfo module in $EXIST_HOME/extensions/build.properties e.g.\n\n# XSL FO transformations (Uses Apache FOP)\ninclude.module.xslfo = true\n\n\n4) Build the eXist-db source code \ncd $EXIST_HOME\n./build.sh\n\n\n5) Uncomment the xslfo XQuery extension module in $EXIST_HOME/conf.xml e.g.\n\n\u003cmodule uri=\"http://exist-db.org/xquery/xslfo\" class=\"org.exist.xquery.modules.xslfo.XSLFOModule\"\u003e\n    \u003cparameter name=\"processorAdapter\" value=\"org.exist.xquery.modules.xslfo.ApacheFopProcessorAdapter\"/\u003e\n\u003c/module\u003e\n\n\n6) Uncomment datetime XQuery extension module in $EXIST_HOME/conf.xml e.g.\n\n\u003cmodule uri=\"http://exist-db.org/xquery/datetime\" class=\"org.exist.xquery.modules.datetime.DateTimeModule\"/\u003e\n\n\n7) Checkout the eXist-db database backup of the whatithink.com web application\nfrom SourceForge Subversion e.g.\n\nsudo svn co https://seewhatithink.svn.sourceforge.net/svnroot/seewhatithink/trunk /usr/local/seewhatithink\nsudo chown -R xmlss:xmlss /usr/local/seewhatithink\n\n\n8) Startup the eXist-db database e.g.\n\ncd $EXIST_HOME\nbin/startup.sh\n\n\n9) Restore the database backup from Step (8) e.g.\n\ncd $EXIST_HOME\nbin/backup.sh -u admin -r ../seewhatithink/applications/whatithink.com/db/__contents__.xml \n \n\n10) Shutdown the eXist-db database \ncd $EXIST_HOME\nbin/shutdown.sh\n\n\n11) Startup the eXist-db database \ncd $EXIST_HOME\nbin/startup.sh\n\n\n*** You can now visit the web application at http://localhost:8080/exist/apps/xmlss/whatithink.com/\n\n\n\nHow to Install XMLSS whatithink.com Printers Training Web Application\n---------------------------------------------------------------------\n1) Create the MySQL database for the Printer web application -\ncd /usr/local/seewhatithink/applications/Printer-database\nmysql -u root -p \u003c create-database.sql\n\n\n2) Load the MySQL database schema for the Printer web application -\ncd /usr/local/seewhatithink/applications/Printer-database\nmysql -u root -p -f xmlss_printer \u003c printer-mysql.sql\n\n\n3) Build the Printer web application\ncd /usr/local/seewhatithink/applications/Printer\nmvn install\n\n\n4) Run the Printer web application\ncd /usr/local/seewhatithink/applications/Printer\n./printer.sh\n\n*** You can now visit the Printer web application at http://localhost:9090/\n\n\n\nHow to Install additional Class Room software for the XMLSS training course\n---------------------------------------------------------------------------\n1) Download and Install NetBeans 7.0 Java EE edition from www.netbeans.com\n\nsudo ./netbeans-7.0-ml-javaee-linux.sh\nDe-select Glassfish, Select Tomcat\nInstall to /usr/local\n\n2) Download the ubuntu package for MySQL Workbench from the MySQL web site\nsudo apt-get install libctemplate0 libzip1 python-pysqlite2 mysql-client python-crypto python-paramiko liblua5.1-0\nsudo dpkg -i mysql-workbench-gpl-5.2.27-1ubu1004-i386.deb\n\n3) Download and Install Aqua Datastudio from www.aquafold.com\nStudio - LINUX (x86 - 32bit) (build: 9.0.15)\n\ntar zxvf ads-linux-x86-9.0.15.tar.gz\nsudo mv datastudio /usr/local\nAdd Item to Applications-\u003eProgramming Menu\n\n\n4) Download and Install oXygen 12 from www.oxygenxml.com\nhttp://www.oxygenxml.com/download_oxygenxml_editor.html\n\nchmod +x oxygen-Xbit.sh\nsudo ./oxygen-Xbit.sh\nInstall to /usr/local/Oxygen XML Editor 12\nAdd Item to Applications-\u003eProgramming Menu\n\n\n5) Download and Install Protege 4.1 from http://protege.stanford.edu/\n\nchmod +x install_protege_4.1rc4.bin\nsudo ./install_protege_4.1rc4.bin\nInstall to /usr/local/Protege_4.1_rc4\nAdd Item to Applications-\u003eProgramming Menu\n\n\n6) Download and Install Google Chrome from http://www.google.com/chrome\nChoose the .deb package for either the 32bit or 64bit version of Ubuntu\nthat you previously installed.\n\nsudo dpkg -i google-chrome-stable_current_i386.deb\n\n\n7) Cosmetics - \n    * Add Shortcuts to the desktop for eXist-db Server, eXist-db Client and Printer Webapp\n    * Add Shortcuts to the desktop for the two webapps\n\nTODO -\nInstall oXygen licence and Aqua DataStudio licence\nAdd eXist-db to Server Browser in oXygen\nAdd MySQL to Server Browser in Aqua DataStudio\n\n\nHowto Shrinking the VM disk in VirtualBox\n-----------------------------------------\nIf you find that your Virtual Machine hard disk file\nhas become rather large on your Host machine, then you\ncan attempt to compact the .vdi file\n\n\nIn the guest Ubuntu Virtual Machine - \n\nsudo apt-get install zerofree\nsudo apt-get clean\nrestart\n\nAt startup choose Recovery Mode, and then at the Menu first choose \"Clean\".\n\nRestart the VM with the Boot CD in the virtual cd, choose 'Try Ubuntu without Installing'\n\nsudo mkdir /mnt/sda1\nsudo mount -n -o ro -t ext4 /dev/sda1 /mnt/sda1 \nsudo /mnt/sda1/usr/sbin/zerofree /dev/sda1\n\nShutdown the Guest when done and remove the media from the virtual cd drive.\n\nOn the host you now need to compact the VDI file - e.g. -\n$ VBoxManage modifyhd XMLSS11-Test-VM-64bit.vdi --compact\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamretter%2Fxmlss-hands-on-apps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamretter%2Fxmlss-hands-on-apps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamretter%2Fxmlss-hands-on-apps/lists"}