...
Ensure you have OpenJDK 8 on your machine.
Ensure you have maven installed on your machine, and configured for ONAP. To build you will need to ensure you update your settings with the ONAP settings.xml (Workspace and Development Tools)
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
Edit conf/cassandra.yaml file
Code Block language bash theme Midnight authenticator: PasswordAuthenticator authorizer: CassandraAuthorizer
- Restart Cassandra
Login to cqlsh with default credentials (cqlsh can be found in $CASSANDRA_HOME/bin directory)
Code Block language bash theme Midnight ./cqlsh -u cassandra -p cassandra
Change default user create new user with the following command. Remember Fill in a username/password below and remember this username/password for music properties.
Code Block language sql theme Midnight CREATE USER new<new_useruser> WITH PASSWORD ‘new‘<new_password’password>’ SUPERUSER;
Change password for default user ‘Cassandra’ ‘cassandra’ so that no one will be able to login without proper authorization:
Provide the new user credentials to Music. Update music.properties file and uncomment or add the following:Code Block language sql theme Midnight ALTER USER cassandra WITH PASSWORD ‘SomeLongRandomStringNoonewillthinkof’‘<SomeLongRandomStringNoonewillthinkof>’;
Test to make sure Cassandra is running correctly by accessing it through cqlsh using the credentials created in step 4.
cassandra.user=Code Block language bash theme Midnight
cassandra.password=./cqlsh -u <new_user>
Test to make sure Cassandra is running correctly by accessing it through cqlsh using the credentials created in step 4.-p <new_password>
Zookeeper Installation
- Download Apache Zookeeper 3.4, install into /opt/app/music and follow these instructions https://zookeeper.apache.org/doc/r3.4.11/zookeeperStarted.html pertaining to the standalone operation. By the end of this you should have Zookeeper working.
Tomcat Installation
- 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) into /opt/app/music/.
- Follow RUNNING.txt instructions for completing tomcat installation. This file can be found in the tomcat directory. Or look at https://tomcat.apache.org/tomcat-8.5-doc/setup.html#Introduction for more in depth instructions
Music Installation
- Create a music.properties file and place it in /opt/app/music/etc/.
- The Here is a sample of the file, the cassandra.user & cassandra.password were created in should be replaced by your values from step 4 of Cassandra installation above.Here is a sample of the file:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
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
dir /opt/app/music/logs MUSIC dir with MUSICdirectory for MUSIC logs. The logs will be
created in this dirplaced here 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:
...
Code Block language bash theme Midnight title music.properties mkdir /opt/app/music/logs
Download MUSIC from the Music Gerrit into your music folder (/opt/app/music/)
Code Block language bash theme Midnight cd /opt/app/music/ git clone https://gerrit.onap.org/r/music
Build music using maven
...
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)
...
Code Block language bash theme Midnight cd music # If you installed settings.
...
xml in your ./m2 folder mvn clean package
...
If the build is successful,
...
you will find the MUSIC.war in the ./target folder. Copy this to your tomcat's webapp folder
...
Code Block language bash theme Midnight cp target/MUSIC.WAR $TOMCAT_HOME/webapps
Start tomcat and you should now have MUSIC running.
There is a folder called postman that contains a postman collection for testing with postman.
...
Continue with Authentication
...