aboutsummaryrefslogtreecommitdiffstats
path: root/docs/single.rst
diff options
context:
space:
mode:
authorNelson,Thomas(tn1381)(arthurdent3) <tn1381@att.com>2018-03-28 23:15:59 -0400
committerNelson,Thomas(tn1381)(arthurdent3) <tn1381@att.com>2018-03-28 23:15:59 -0400
commit03b8ac85fe37aa2c35f28f10cff3d460751b23d0 (patch)
tree2906067e0638f47e8a84c11d228365c3c85aecf9 /docs/single.rst
parent9cd6659574e58aae87a8aa40feaad492b2f3bde7 (diff)
Documentation added
Change-Id: I5fdf2b042451ea666a36a3ca31fb0783e0239878 Issue-ID: MUSIC-62 Signed-off-by: Nelson,Thomas(tn1381)(arthurdent3) <tn1381@att.com>
Diffstat (limited to 'docs/single.rst')
-rw-r--r--docs/single.rst85
1 files changed, 85 insertions, 0 deletions
diff --git a/docs/single.rst b/docs/single.rst
new file mode 100644
index 00000000..08c5e315
--- /dev/null
+++ b/docs/single.rst
@@ -0,0 +1,85 @@
+======================
+Single VM/Site install
+======================
+Local Installation
+------------------
+Prerequisites
+
+If you are using a VM make sure it has at least 8 GB of RAM (It may work with 4 GB, but with 2 GB it
+does give issues).
+
+Instructions
+
+- Create MUSIC Install dir /opt/app/music
+- Open /etc/hosts as sudo and enter the name of the vm alongside localhost in the line for 127.0.0.1. E.g. 127.0.0.1 localhost music-1. Some of the apt-get installation seem to require this.
+- Ensure you have OpenJDK 8 on your machine.
+- Download Apache Cassandra 3.0, install into /opt/app/music and follow these instructions http://cassandra.apache.org/doc/latest/getting_started/installing.html till and including Step
+- By the end of this you should have Cassandra working.
+- Download Apache Zookeeper 3.4.6, install into /opt/app/music and follow these instructions https://zookeeper.apache.org/doc/trunk/zookeeperStarted.html pertaining to the standalone operation. By the end of this you should have Zookeeper working.
+- Download the Version 8.5 Apache Tomcat and install it using these instructions https://tomcat.apache.org/download-80.cgi (this is for version 8.5).
+- Create a music.properties file and place it in /opt/app/music/etc/. Here is a sample of the file:
+
+music.properties::
+
+ music.properties
+ my.id=0
+ all.ids=0
+ my.public.ip=localhost
+ all.public.ips=localhost
+ ########################
+ # Optional current values are defaults
+ ######################################
+ # If using docker this would point to the specific docker name.
+ #zookeeper.host=localhost
+ #cassandra.host=localhost
+ #music.ip=localhost
+
+ #debug=true
+ #music.rest.ip=localhost
+ #lock.lease.period=6000
+ # Cassandra Login - Do not user cassandra/cassandra
+ cassandra.user=cassandra1
+ cassandra.password=cassandra1
+ # AAF Endpoint
+ #aaf.endpoint.url=<aaf url>
+
+- Make a dir /opt/app/music/logs MUSIC dir with MUSIC logs will be created in this dir after MUSIC starts.
+- Build the MUSIC.war and place in tomcat webapps dir.
+- Authentications/AAF Setup For Authentication setup.
+- Start tomcat and you should now have MUSIC running.
+
+Extra Cassandra information for Authentication:
+
+To create first user in Cassandra
+
+1. Edit conf/Cassandra.yaml file::
+
+ authenticator: PasswordAuthenticator
+ authorizer: CassandraAuthorizer
+
+
+2. Restart Cassandra
+3. Login to cqlsh with default credentials::
+
+ cqlsh -u cassandra -p cassandra
+
+4. To change default user create new user with the following command.::
+
+ CREATE USER new_user WITH PASSWORD ‘new_password’ SUPERUSER;
+
+5. Change password for default user ‘Cassandra’ so that no one will be able to login::
+
+ ALTER USER cassandra WITH PASSWORD ‘SomeLongRandomStringNoonewillthinkof’;
+
+6. Provide the new user credentials to Music. Update music.properties file and uncomment or add the following::
+
+ cassandra.user=<new_user>
+ cassandra.password=<new_password>
+
+To access keyspace through cqlsh, login with credentials that are passed to MUSIC while creating the keyspace.
+
+Continue with `Authentication <./automation.rst>`_
+
+
+
+ \ No newline at end of file