From 5996302ab81a1c41b982be5f1ce649874faeaf0c Mon Sep 17 00:00:00 2001 From: MatthewHarffy Date: Fri, 10 Nov 2017 14:53:23 +0000 Subject: [PATCH] Fix headings and code-blocks formatting Headings added to aid navigation and fixed all the code examples to use code-block Issue-ID: DOC-114 Change-Id: I205f47016df26a298473ee8290931e0d809a140d Signed-off-by: MatthewHarffy --- .../AAI_Developer_Environment_Setup.rst | 170 ++++++++++++--------- 1 file changed, 99 insertions(+), 71 deletions(-) diff --git a/docs/platform/Getting Started/AAI_Developer_Environment_Setup.rst b/docs/platform/Getting Started/AAI_Developer_Environment_Setup.rst index a5809ec2..6f7871cc 100644 --- a/docs/platform/Getting Started/AAI_Developer_Environment_Setup.rst +++ b/docs/platform/Getting Started/AAI_Developer_Environment_Setup.rst @@ -13,15 +13,17 @@ Ubuntu 16.04.   For this exercise, I set up a new instance of Ubuntu in Virtualbox and gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. -- install openjdk 8 +Install openjdk 8 +----------------- - ..code:: bash + .. code:: bash - sudo apt install openjdk-8-jdk + sudo apt install openjdk-8-jdk -- Install single node hadoop/titan +Install single node hadoop/titan +-------------------------------- - ..code:: bash + .. code-block:: bash wget http://s3.thinkaurelius.com/downloads/titan/titan-1.0.0-hadoop1.zip @@ -31,9 +33,10 @@ gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. sudo ./bin/titan.sh start -- Install haproxy +Install haproxy +--------------- - ..code:: bash + .. code-block:: bash sudo apt-get -y install haproxy @@ -46,7 +49,7 @@ gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. `haproxy.cfg `__ - ..code:: bash + .. code-block:: bash sudo cp aai.pem /etc/ssl/private/aai.pem @@ -56,26 +59,29 @@ gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. `aai.pem `__ - ..code::bash + .. code-block:: bash sudo mkdir /usr/local/etc/haproxy -- Add these hostnames to the loopback interface in /etc/hosts:  +- Add these hostnames to the loopback interface in /etc/hosts - ..code:: bash + .. code-block:: bash 127.0.0.1 localhost aai-traversal.api.simpledemo.openecomp.org aai-resouces.api.simpledemo.openecomp.org - Restart haproxy - ..code:: bash + .. code-block:: bash sudo service haproxy restart -- Set up repos. First, follow the initial setup instructions in  +Set up repos +------------ + +- First, follow the initial setup instructions in  `Setting Up Your Development Environment `__ - ..code:: bash + .. code-block:: bash mkdir -p ~/LF/AAI @@ -95,9 +101,10 @@ gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. settings.xml file should solve this problem: `Setting Up Your Development Environment#MavenExamplesettings.xml `__ -- Build aai-common, traversal, and resources +Build aai-common, traversal, and resources +------------------------------------------ - ..code:: bash + .. code-block:: bash cd ~/LF/AAI/aai-common @@ -111,21 +118,26 @@ gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. mvn clean install # Should result in BUILD SUCCESS - cd ~/LF/AAI/traversal # I had to add the following to traversal/pom.xml to get - traversal to build:  + cd ~/LF/AAI/traversal + +You might need to add the following to traversal/pom.xml to get traversal to build:  + + .. code-block:: xml - ..code:: xml maven-restletRestlet repositoryhttps://maven.restlet.com + .. code-block:: bash + mvn clean install # Should result in BUILD SUCCESS -- Titan setup +Titan setup +----------- 1. Modify both titan-cached.properties and titan-realtime.properties to the following (for all MS’s that will connect to the local Cassandra backend) - ..code:: bash + .. code-block:: bash storage.backend=\ *cassandra* storage.hostname=\ *localhost* @@ -147,7 +159,7 @@ gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. specified Titan will try to create/use a defaulted keyspace named titan. - ..code:: bash + .. code-block:: bash storage.cassandra.keyspace= @@ -160,103 +172,119 @@ gave it 16G RAM, 200GB dynamically allocated storage, and 3 processors. Runnable class org.onap.aai.dbgen.GenTester with the following vm args. - ..code:: bash + .. code-block:: bash -DAJSC_HOME=~/LF/AAI/resources -DBUNDLECONFIG\_DIR="bundleconfig-local" 9. Here's the command I used, and it worked: - ..code:: bash + .. code-block:: bash cd ~/LF/AAI; java -DAJSC_HOME=/home/jimmy/LF/AAI/resources/aai-resources -DBUNDLECONFIG_DIR="bundleconfig-local" -cp aai-common/aai-core/target/aai-core-1.1.0-SNAPSHOT.jar:resources/aai-resources/target/aai-resources.jar:resources/aai-resources/target/userjars/\* org.onap.aai.dbgen.GenTester -- Start the "resources" microservice +Start the "resources" microservice +---------------------------------- 1. Resources runs on port 8446.  Go to the resources directory - ..code:: bash - cd ~/LF/AAI/resources + .. code-block:: bash + + $ cd ~/LF/AAI/resources 2. Set the debug port to 9446 - ..code:: bash - - export MAVEN_OPTS="-Xms1024m -Xmx5120m -XX:PermSize=2024m + .. code-block:: bash + + export MAVEN_OPTS="-Xms1024m -Xmx5120m -XX:PermSize=2024m -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=9446,server=y,suspend=n" 3. Start the microservice - ..code::bash + .. code-block::bash - mvn -P runAjsc + $ mvn -P runAjsc -16. Verify the resources microservice (this example uses Postman utility - for Google Chrome) +Verify the resources microservice (this example uses Postman utility for Google Chrome) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - 1. | Use basic auth, user = AAI, pw = AAI + 1. Use basic auth, user = AAI, pw = AAI - 2. | Set the X-TransactionId header (in the example below, the value is - | 9999) + 2. Set the X-TransactionId header (in the example below, the value is + 9999) - 3. | Set the X-FromAppId header (in the example below, the value is - | jimmy-postman) + 3. Set the X-FromAppId header (in the example below, the value is + jimmy-postman) - 4. | Perform a GET of https://127.0.0.1:8443/aai/v11/network/vces + 4. Perform a GET of https://127.0.0.1:8443/aai/v11/network/vces - 5. | You should see an error as below, 404 Not Found, ERR.5.4.6114.  - | This indicates that the service is functioning normally: + 5. You should see an error as below, 404 Not Found, ERR.5.4.6114.  + This indicates that the service is functioning normally: +------------------------------------------+ -| |image1| | +| |image1| | +------------------------------------------+ +Start the "traversal" microservice +---------------------------------- + + 1. Traversal runs on port 8447.  Go to the traversal directory: -18. Start the "traversal" microservice + .. code-block:: bash - 1. | Traversal runs on port 8447.  Go to the traversal directory - ..code:: bash - $ cd ~/LF/AAI/traversal + $ cd ~/LF/AAI/traversal + + 2. Set the debug port to 9447 - 2. | Set the debug port to 9447 - | $ export MAVEN_OPTS="-Xms1024m -Xmx5120m -XX:PermSize=2024m + $ export MAVEN_OPTS="-Xms1024m -Xmx5120m -XX:PermSize=2024m -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=9447,server=y,suspend=n" - 3. | Start the microservice - | $ mvn -P runAjsc - | Should see something like this: 2017-07-26 - 12:46:35.524:INFO:oejs.Server:com.att.ajsc.runner.Runner.main(): - Started @25827ms + 3. Start the microservice + + .. code-block:: bash + + $ mvn -P runAjsc + + You should see something like this: -- Verify the traversal microservice + .. code-block:: bash - 1. | Set up the widget models - | This will set up the postman to add widget models: `Add Widget Models.postman_collection.json `__ `NamedQuery.postman_collection.json `__ + 2017-07-26 + 12:46:35.524:INFO:oejs.Server:com.att.ajsc.runner.Runner.main(): + Started @25827ms - 2. | Create a runner using this file: +Verify the traversal microservice +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + 1. Set up the widget models + This will set up the postman to add widget models: `Add Widget Models.postman_collection.json `__ `NamedQuery.postman_collection.json `__ + + 2. Create a runner using this file: `models.csv `__ - 3. | Run the test runner - | |image2| + 3. Run the test runner + |image2| + + 4. Add a named query called "getComponentList" (this named query is used by VID): + + `NamedQuery.postman_collection.json `__ + + |image3| - 4. | Add a named query called "getComponentList" (this named query is used by VID):  - `NamedQuery.postman_collection.json `__ - | |image3| + 5. Add objects: - 5. | Add objects: - `Add Instances for Named Query.postman_collection.json `__ + `Add Instances for Named Query.postman_collection.json `__ - 6. | Execute named-query: - `Execute Named Query.postman_collection.json `__ - | You should see something like the following: - | |image4| + 6. Execute named-query: + `Execute Named Query.postman_collection.json `__ + You should see something like the following: + |image4| -- Your A&AI instance is now running, both the resources and traversal - microservices are working properly with a local titan graph. +- Your A&AI instance is now running, both the resources and traversal microservices are working properly with a local titan graph. - Next: `Tutorial: Making and Testing a Schema Change in A&AI `__ -- 2.16.6