You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

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).

Create MUSIC Install dir /opt/app/music

Ensure you have OpenJDK 8, and maven on your machine.

NOTE: If you are having trouble with some of the apt-get installation packages, enter the name of the vm alongside localhost in the line for 127.0.0.1 in /etc/hosts. Some of the apt-get installation may require this.

MUSIC Installation Instructions

Cassandra Installation

  • Download Apache Cassandra 3.0, install into /opt/app/music and follow these instructions http://cassandra.apache.org/doc/latest/getting_started/installing.html

  • Create a user in Cassandra

    1. Edit conf/cassandra.yaml file

      authenticator: PasswordAuthenticator
authorizer: CassandraAuthorizer
    2. Restart Cassandra

    3. Login to cqlsh with default credentials (cqlsh can be found in $CASSANDRA_HOME/bin directory)

      ./cqlsh -u cassandra -p cassandra

    4. Change default user create new user with the following command. Fill in a username/password below and remember this username/password for music properties.

      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 without proper authorization:

      ALTER USER cassandra WITH PASSWORD ‘<SomeLongRandomStringNoonewillthinkof>’;

  • Test to make sure Cassandra is running correctly by accessing it through cqlsh using the credentials created in step 4.

    ./cqlsh -u <new_user> -p <new_password>

Zookeeper Installation

Tomcat Installation

Music Installation

  • Create a music.properties file and place it in /opt/app/music/etc/.
  • Here is a sample of the file, the cassandra.user & cassandra.password should be replaced by your values from step 4 of Cassandra installation above.
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=<new_user>
cassandra.password=<new_password>
# AAF Endpoint
#aaf.endpoint.url=<aaf url>

  • Make a directory for MUSIC logs. The logs will be placed here after MUSIC starts

    music.properties
    mkdir /opt/app/music/logs
  • Build the MUSIC.war and place in tomcat webapps dir.
  • Download MUSIC from the Music Gerrit into your music folder (/opt/app/music/)
  • git clone https://gerrit.onap.org/r/music
  • Build music




  • Authentications/AAF Setup For Authentication setup.
  • Start tomcat and you should now have MUSIC running.



Build Music

Documentation will be updated to show that. Code can be downloaded from Music Gerrit. 
To build you will need to ensure you update your settings with the ONAP settings.xml (Workspace and Development Tools)

Once you have done that run the following:

# If you installed settings.cml in your ./m2 folder
mvn clean package
# If you placed the settings.xml elsewhere:
mvn clean package -s /path/to/settings.xml


After it is built you will find the MUSIC.war in the ./target folder. 

There is a folder called postman that contains a postman collection for testing with postman. 



Continue with Authentication




  • No labels