Skip to content
Browse files

fixes #13 #14

  • Loading branch information...
1 parent ac36ddc commit 9c66b6f31c20d7a5e4c8de6f424b4a3a70919607 @thallium205 committed Jul 27, 2013
Showing with 30 additions and 0 deletions.
  1. +30 −0 README.md
  2. BIN server/jar/BlockViewer.jar
  3. BIN server/jar/BlockViewer_lib/antlr-2.7.7.jar
  4. BIN server/jar/BlockViewer_lib/antlrworks-1.4.3.jar
  5. BIN server/jar/BlockViewer_lib/asm-3.1.jar
  6. BIN server/jar/BlockViewer_lib/asm-analysis-3.2.jar
  7. BIN server/jar/BlockViewer_lib/asm-commons-3.2.jar
  8. BIN server/jar/BlockViewer_lib/asm-tree-3.2.jar
  9. BIN server/jar/BlockViewer_lib/asm-util-3.2.jar
  10. BIN server/jar/BlockViewer_lib/bcprov-jdk16-140.jar
  11. BIN server/jar/BlockViewer_lib/bitcoinj-0.4.jar
  12. BIN server/jar/BlockViewer_lib/blueprints-core-1.2.jar
  13. BIN server/jar/BlockViewer_lib/blueprints-neo4j-graph-1.2.jar
  14. BIN server/jar/BlockViewer_lib/commons-beanutils-1.8.0.jar
  15. BIN server/jar/BlockViewer_lib/commons-beanutils-core-1.8.0.jar
  16. BIN server/jar/BlockViewer_lib/commons-cli-1.2.jar
  17. BIN server/jar/BlockViewer_lib/commons-collections-3.2.1.jar
  18. BIN server/jar/BlockViewer_lib/commons-configuration-1.6.jar
  19. BIN server/jar/BlockViewer_lib/commons-digester-1.8.1.jar
  20. BIN server/jar/BlockViewer_lib/commons-io-2.3.jar
  21. BIN server/jar/BlockViewer_lib/commons-lang-2.4.jar
  22. BIN server/jar/BlockViewer_lib/commons-logging-1.1.1.jar
  23. BIN server/jar/BlockViewer_lib/gephi-toolkit-0.8.2-20121211.190103-146-all.jar
  24. BIN server/jar/BlockViewer_lib/geronimo-jta_1.1_spec-1.1.1.jar
  25. BIN server/jar/BlockViewer_lib/gremlin-groovy-1.5.jar
  26. BIN server/jar/BlockViewer_lib/gremlin-java-1.5.jar
  27. BIN server/jar/BlockViewer_lib/groovy-1.8.5.jar
  28. BIN server/jar/BlockViewer_lib/guava-12.0.jar
  29. BIN server/jar/BlockViewer_lib/jackson-core-asl-1.9.7.jar
  30. BIN server/jar/BlockViewer_lib/jackson-jaxrs-1.9.7.jar
  31. BIN server/jar/BlockViewer_lib/jackson-mapper-asl-1.9.7.jar
  32. BIN server/jar/BlockViewer_lib/janino-2.5.10.jar
  33. BIN server/jar/BlockViewer_lib/jansi-1.5.jar
  34. BIN server/jar/BlockViewer_lib/jcl-over-slf4j-1.6.1.jar
  35. BIN server/jar/BlockViewer_lib/jersey-core-1.9.jar
  36. BIN server/jar/BlockViewer_lib/jersey-multipart-1.9.jar
  37. BIN server/jar/BlockViewer_lib/jersey-server-1.9.jar
  38. BIN server/jar/BlockViewer_lib/jettison-1.3.jar
  39. BIN server/jar/BlockViewer_lib/jetty-6.1.25.jar
  40. BIN server/jar/BlockViewer_lib/jetty-util-6.1.25.jar
  41. BIN server/jar/BlockViewer_lib/json-lib-2.4-jdk15.jar
  42. BIN server/jar/BlockViewer_lib/jsontools-core-1.7.jar
  43. BIN server/jar/BlockViewer_lib/jsoup-1.6.2.jar
  44. BIN server/jar/BlockViewer_lib/jsr311-api-1.1.2.r612.jar
  45. BIN server/jar/BlockViewer_lib/log4j-1.2.16.jar
  46. BIN server/jar/BlockViewer_lib/logback-access-0.9.30.jar
  47. BIN server/jar/BlockViewer_lib/logback-classic-0.9.30.jar
  48. BIN server/jar/BlockViewer_lib/logback-core-0.9.30.jar
  49. BIN server/jar/BlockViewer_lib/lucene-core-3.5.0.jar
  50. BIN server/jar/BlockViewer_lib/mimepull-1.6.jar
  51. BIN server/jar/BlockViewer_lib/mysql-connector-java-5.1.22-bin.jar
  52. BIN server/jar/BlockViewer_lib/neo4j-backup-1.8.jar
  53. BIN server/jar/BlockViewer_lib/neo4j-com-1.8.jar
  54. BIN server/jar/BlockViewer_lib/neo4j-cypher-1.8.jar
  55. BIN server/jar/BlockViewer_lib/neo4j-cypher-plugin-1.8.jar
  56. BIN server/jar/BlockViewer_lib/neo4j-graph-algo-1.8.jar
  57. BIN server/jar/BlockViewer_lib/neo4j-graph-matching-1.8.jar
  58. BIN server/jar/BlockViewer_lib/neo4j-gremlin-plugin-1.8.jar
  59. BIN server/jar/BlockViewer_lib/neo4j-ha-1.8.jar
  60. BIN server/jar/BlockViewer_lib/neo4j-jmx-1.8.jar
  61. BIN server/jar/BlockViewer_lib/neo4j-kernel-1.8.jar
  62. BIN server/jar/BlockViewer_lib/neo4j-lucene-index-1.8.jar
  63. BIN server/jar/BlockViewer_lib/neo4j-management-1.8.jar
  64. BIN server/jar/BlockViewer_lib/neo4j-server-1.8-static-web.jar
  65. BIN server/jar/BlockViewer_lib/neo4j-server-1.8-tests.jar
  66. BIN server/jar/BlockViewer_lib/neo4j-server-1.8.jar
  67. BIN server/jar/BlockViewer_lib/neo4j-server-advanced-1.8.jar
  68. BIN server/jar/BlockViewer_lib/neo4j-server-enterprise-1.8.jar
  69. BIN server/jar/BlockViewer_lib/neo4j-shell-1.8.jar
  70. BIN server/jar/BlockViewer_lib/neo4j-udc-1.8.jar
  71. BIN server/jar/BlockViewer_lib/org-gephi-layout-plugin-openord.jar
  72. BIN server/jar/BlockViewer_lib/org.apache.servicemix.bundles.jline-0.9.94_1.jar
  73. BIN server/jar/BlockViewer_lib/org.apache.servicemix.bundles.netty-3.2.5.Final_1.jar
  74. BIN server/jar/BlockViewer_lib/pipes-1.0.jar
  75. BIN server/jar/BlockViewer_lib/rrd4j-2.0.7.jar
  76. BIN server/jar/BlockViewer_lib/scala-library-2.9.1-1.jar
  77. BIN server/jar/BlockViewer_lib/server-api-1.8.jar
  78. BIN server/jar/BlockViewer_lib/servlet-api-2.5-20081211.jar
  79. BIN server/jar/BlockViewer_lib/slf4j-api-1.6.2.jar
  80. BIN server/jar/BlockViewer_lib/stax-api-1.0.1.jar
  81. BIN server/jar/BlockViewer_lib/zookeeper-3.3.2.jar
View
30 README.md
@@ -60,6 +60,36 @@ where
* **client** = Just enables the Neo4j embedded database, and given the config settings, receives data from the server.
BlockViewer's backend is fully recoverable (except during a download from the API TODO), which means it can be stopped at resumed where it left at any time during this process without any issue.
+## Detailed Usage
+In order to run the BlockViewer application that builds the graph, the following must happen:
+
+Backend:
+0) Java needs to be installed
+1) You need to run the Neo4j coordinator application separately because this program is using the high availability database. If you are running windows, you need to download and execute this program before starting the jar: /neo4j-enterprise-1.8-windows/neo4j-enterprise-1.8/bin/Neo4jCoordinator.bat This can be downloaded from the Neo4j website!
+2) Once that is running, you need to seed the genesis block. Put this file in the directory where the BlockViewer.jar resides: http://blockchain.info/rawblock/000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f Save it as: "1.json". You have to do this because of a known bug that I wish I had more time to fix, but if you are so inclined, please check out latestDiskBlockIndex() function in GraphBuilder.java
+3) Finally, run the application itself: java -jar -Xmx6g BlockViewer.jar -dbPath ../graph.db/ -configPath ../neo4j.properties -validate false -low -high (There are several more flags that can be set... an easy way to test that things are working is to use the -client flag so no building happens but just starts the database).
+4) If you are going to be exporting the visualizations, you need to have a mysql database setup. Also, look at the export code to determine what stuff you actually want exported (pdf, gexf, png, etc). It loads it as a LONGBLOB into a mysql table.
+
+Frontend:
+If you are interested in running the frontend application that allows visualization in the browser, it requires a few environment variables to be set:
+0) Nodejs needs to be installed and its dependencies (npm install)
+// Since you are hosting a website, this makes it so you can run a website on port 80 without having to do it as root by running it on 8080
+sudo iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 8080
+// It has a logger from http://loggly.com/ if you are interested in loging frontend activity
+export logsubdomain=???
+export loguser=???
+export logpass=???
+export logtoken=???
+// It requires a mysql server
+export sqlhost=10.0.0.1
+export sqluser=root
+export sqlpass=???
+export sqldatabase=blockviewer
+
+Known Issue:
+Gephi toolkit has a known problem when casting the ID's to Long datatypes. I reported and have been working with them for some time in getting it resolved: https://github.com/gephi/gephi/issues/707 They just now got around to fixing it, but my dirty hack is being used in the meantime.
+There is a memory leak when exporting graph visualizations. It is occuring in the Neo4jImporter importDatabase function. I modified the source code of the importer so it doesn't have to close the database connection and repoen it upon each import. By keeping it open, when i clear the graph workspace, some kind of memory is not being released. Over time, the memory fills up and eventually results in an OutOfMemoryError exception. The unmodified, original importer (which also doesn't allow users to traverse through time which I added), can be found here -> https://github.com/gephi/gephi-plugins/blob/neo4j-plugin/Neo4jPlugin/src/org/gephi/neo4j/plugin/impl/Neo4jImporterImpl.java#L96
+Relationships between the owner nodes are only being expressed with one transaction - even if there are more interactions between owners. This process takes place in the relinkOwners function under GraphBuilder.java
## Issues
Issues are being tracked in Github.
View
BIN server/jar/BlockViewer.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/antlr-2.7.7.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/antlrworks-1.4.3.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/asm-3.1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/asm-analysis-3.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/asm-commons-3.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/asm-tree-3.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/asm-util-3.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/bcprov-jdk16-140.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/bitcoinj-0.4.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/blueprints-core-1.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/blueprints-neo4j-graph-1.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-beanutils-1.8.0.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-beanutils-core-1.8.0.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-cli-1.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-collections-3.2.1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-configuration-1.6.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-digester-1.8.1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-io-2.3.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-lang-2.4.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/commons-logging-1.1.1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/gephi-toolkit-0.8.2-20121211.190103-146-all.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/geronimo-jta_1.1_spec-1.1.1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/gremlin-groovy-1.5.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/gremlin-java-1.5.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/groovy-1.8.5.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/guava-12.0.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jackson-core-asl-1.9.7.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jackson-jaxrs-1.9.7.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jackson-mapper-asl-1.9.7.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/janino-2.5.10.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jansi-1.5.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jcl-over-slf4j-1.6.1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jersey-core-1.9.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jersey-multipart-1.9.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jersey-server-1.9.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jettison-1.3.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jetty-6.1.25.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jetty-util-6.1.25.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/json-lib-2.4-jdk15.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jsontools-core-1.7.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jsoup-1.6.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/jsr311-api-1.1.2.r612.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/log4j-1.2.16.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/logback-access-0.9.30.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/logback-classic-0.9.30.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/logback-core-0.9.30.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/lucene-core-3.5.0.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/mimepull-1.6.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/mysql-connector-java-5.1.22-bin.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-backup-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-com-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-cypher-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-cypher-plugin-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-graph-algo-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-graph-matching-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-gremlin-plugin-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-ha-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-jmx-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-kernel-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-lucene-index-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-management-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-server-1.8-static-web.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-server-1.8-tests.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-server-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-server-advanced-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-server-enterprise-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-shell-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/neo4j-udc-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/org-gephi-layout-plugin-openord.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/org.apache.servicemix.bundles.jline-0.9.94_1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/org.apache.servicemix.bundles.netty-3.2.5.Final_1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/pipes-1.0.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/rrd4j-2.0.7.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/scala-library-2.9.1-1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/server-api-1.8.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/servlet-api-2.5-20081211.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/slf4j-api-1.6.2.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/stax-api-1.0.1.jar
Binary file not shown.
View
BIN server/jar/BlockViewer_lib/zookeeper-3.3.2.jar
Binary file not shown.

0 comments on commit 9c66b6f

Please sign in to comment.
Something went wrong with that request. Please try again.