summaryrefslogtreecommitdiffstats
path: root/docs/single.rst
blob: 060f02b4f9aaa814b6cec9bb2656cd4aa71bea2d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
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/r3.4.6/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>`_