From 03b8ac85fe37aa2c35f28f10cff3d460751b23d0 Mon Sep 17 00:00:00 2001 From: "Nelson,Thomas(tn1381)(arthurdent3)" Date: Wed, 28 Mar 2018 23:15:59 -0400 Subject: Documentation added Change-Id: I5fdf2b042451ea666a36a3ca31fb0783e0239878 Issue-ID: MUSIC-62 Signed-off-by: Nelson,Thomas(tn1381)(arthurdent3) --- docs/single.rst | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 docs/single.rst (limited to 'docs/single.rst') 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= + +- 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= + cassandra.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 -- cgit 1.2.3-korg