{"id":18972336,"url":"https://github.com/eis/jboss-websocket-demo","last_synced_at":"2025-04-19T16:12:52.289Z","repository":{"id":8007240,"uuid":"9415191","full_name":"eis/jboss-websocket-demo","owner":"eis","description":"Demo of WebSocket functionality in JBoss","archived":false,"fork":false,"pushed_at":"2014-10-10T11:23:22.000Z","size":311,"stargazers_count":6,"open_issues_count":2,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-29T09:51:18.083Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-04-13T14:58:51.000Z","updated_at":"2025-01-27T07:43:54.000Z","dependencies_parsed_at":"2022-07-11T04:16:53.692Z","dependency_job_id":null,"html_url":"https://github.com/eis/jboss-websocket-demo","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eis%2Fjboss-websocket-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eis%2Fjboss-websocket-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eis%2Fjboss-websocket-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eis%2Fjboss-websocket-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eis","download_url":"https://codeload.github.com/eis/jboss-websocket-demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249223935,"owners_count":21232833,"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-11-08T15:08:10.172Z","updated_at":"2025-04-16T09:33:01.416Z","avatar_url":"https://github.com/eis.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"#JBoss EAP 6.1 (AS 7.2) using WebSocket alpha extension + jQuery + websockets\n\nRequirements:\nJBoss AS 7.1.2 or later + JBoss Native connectors enabled + Maven + WebSocket-supporting browser such as Chrome\n\nTested with\n - Windows 7 64-bit, JBoss EAP 6.1.Alpha, Oracle JDK 7\n - Centos 6.5 64-bit, JBoss EAP 6.1, Oracle JDK 7, running on VirtualBox\n\nThere are two ways to run this demo, either set up JBoss yourself, deploy there and use\nyour regular browser (Chrome or Firefox) or use Vagrant script to set up JBoss environment\nfor you in a VirtualBox box and deploy there. First one is recommended, but if you're having\ndifficulties to set it up you can try the automated script way.\n\n## Configuring your JBoss instance yourself\n\nIf you go with setting up JBoss yourself, often the only change needed to vanilla JBoss\nconfiguration is that APR (Apache Portable Runtime) needs to be enabled.\nIt should be enabled with changing:\n\n```xml\n\u003csubsystem xmlns=\"urn:jboss:domain:web:1.1\"\n          default-virtual-server=\"default-host\" native=\"false\"\u003e\n```\nto:\n\n```xml\n\u003csubsystem xmlns=\"urn:jboss:domain:web:1.1\"\n          default-virtual-server=\"default-host\" native=\"true\"\u003e\n```\nin standalone.xml / domain.xml\n\nThat should be it, as the native connectors *should* be packaged with the installation out of the box.\nAfter that you can start your JBoss, issue `mvn clean package jboss-as:deploy -Djboss-as.username=YOURUSERNAME\n-Djboss-as.password=YOURPASS`, open your browser and navigate to [http://localhost:8080/websocket-web-app/](http://localhost:8080/websocket-web-app/)\n\nIf on startup you get an error like this:\n\n```\n21:27:30,434 INFO  [org.apache.catalina.core] (MSC service thread 1-10) JBWEB001065: The native library which allows optimal\nperformance in production environments was not found on the java.library.path\n```\n\ncheck for the folder \"org/jboss/as/web/main/lib\" within your JBoss modules folder. It should list your\ncurrent architecture as a subfolder, containing native connectors for your platform. If lib folder is\nmissing - it is missing at least if you build your JBoss server yourself - you need to retrieve and instal\nnative connectors as well.\n\nAlso, for some environments, such as ARM architecture, native connectors are not available OOB.\n\nIf you need to install native connectors yourself, you should first try one of the [binaries provided for\ndownload](http://www.jboss.org/jbossweb/downloads.html) and if that is not an option or doesn't work,\ncompile them from source code. To compile, download sources from http://www.jboss.org/jbossweb/downloads.html -\u003e\nJBoss Web Native Connectors -\u003e source tarball, and follow the compiling and installing steps\ngiven here: https://community.jboss.org/wiki/JbosswebBuildNative.\n\nIt's been reported in [issue #6](https://github.com/eis/jboss-websocket-demo/issues/6) that native libraries\nneed to be installed separately on OSX as well.\n\n## Using Vagrant script to create a VM for you and run it there\n\nRequirements for this:\n - [Vagrant](https://www.vagrantup.com/) installed\n - [VirtualBox](https://www.virtualbox.org/) installed\n - Vagrant-omnibus plugin for Vagrant (Installing: `vagrant plugin install vagrant-omnibus`)\n - Support for 64-bit VMs (often means 64-bit host OS + virtualization support turned on from BIOS)\n - 500MB memory to spare to throw to VM\n\nRecommended pre-step:\n - download JBoss EAP 6.1 and save the downloaded jboss-eap-6.1.0.zip to the same folder as this file (has to be exactly that file!)\nRequired steps:\n - run `vagrant up` (will take some time, 30+ minutes)\n - run `mvn clean package jboss-as:deploy -Djboss-as.username=admin -Djboss-as.password=adminpass1!`\n - Switch to VM window\n - Login with vagrant/vagrant (the black screen you see is just a screen saver, it'll go away when you type)\n - Start graphical window system with `startx`\n - Start firefox with firefox icon on the top of the screen (if you don't have a mouse cursor, restart the VM. Machine -\u003e Reset.)\n - Navigate to [http://localhost:8080/websocket-web-app/](http://localhost:8080/websocket-web-app/)\n\nYou don't have to download JBoss EAP yourself, in which case the script will download the source codes and build the EAP for you.\nThis is slow though, it takes about an hour on my machine. The reason the script doesn't just download the binary is JBoss EAP\nlicensing. However, building it from source code should be ok. It will only build it once, after which it leaves the built .zip\nfile in this folder from where it can be used on subsequent VM creations if needed.\n\nReason for using a browser within VM is that VirtualBox seems to have issues with exposing WebSockets outside VM. Regular\nHTTP traffic works just fine.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feis%2Fjboss-websocket-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feis%2Fjboss-websocket-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feis%2Fjboss-websocket-demo/lists"}