RTView Solace AMI - Quick Start

Owned by SL Docs
Last updated: Sept 13, 2018
3 min read



There are three main steps to create and configure an RTView Solace Monitor AMI. "Prerequisites for Solace AMI", proceed to "Create Instance from RTView Monitor for Solace" and then "Add Message Router Connections".

Prerequisites for Solace AMI


For complete RTView® system requirements, see README_sysreq.txt. You will need:

  • URL and Port number for each router you wish to monitor along with user ID and password (Use the private IP address to connections to connect the AMI to virtual routers running in the same Amazon environment. Contact your AWS admin if you want to connect to external VMR's )
  • VPN name that you want to monitor (optional)
  • AWS admin rights (needed to create instance)

Create Instance from RTView Monitor for Solace

  1. IMPORTANT – Log onto your AWS account as 'admin' – use the same browser for the remaining steps.
  2. Open http://sl.com/solace-ami-free-trial/ and complete the form. Once submitted you will be redirected to a document showing the AWS regional links available.
  3. Click on the appropriate link (as per your AWS guidelines) This will open the AWS console at "Step2 –Choose an instance type". The process automatically uses the "RTView Monitor for Solace AMI"
  4. Complete the configuration process in compliance with your AWS policy (t2.large with 8GB of storage suggested minimum). Note: you will be using a browser to connect to the AMI on port 8068 – please make sure that the security group you choose allows for access
  5. One the instance has been launched, assign a name and record the Public IP address (you will use this to connect from your local Windows environment)
  6. Use the Public IP address to launch a putty session.

Connect as ec2-user, no password.
Once connected, from the /bin directory execute "./start_servers.sh"

    
Add Message Router Connections

  1. Open a browser and type the following URL to open the RTView Configuration Application:

http://IPAddress:8068/rtview/solmon_rtvadmin* if you are running the Monitor remotely (public IP Address from AWS Console). Note: you will be using a browser to connect to the AMI on port 8068 – please make sure that the security group you choose allows for access


Use rtvadmin/rtvadmin as the username/password. The RTView Configuration Application HOME page opens.

2. The configuration page for the Solace Message Router Monitor project opens.


3. Select Solace Message Router in the navigation tree (left panel).



The CONNECTIONS tab opens.

4. Select MESSAGE ROUTER and click to add a message router connection.



The Add Connection dialog opens.


5. In the Add Connection dialog: enter the Connection Name, URL, Username and Password, toggle on Edition if this is a VMR, enter the SEMP Version and the VPN Name.



Notes:

    1. if you want to collect additional metrics for a specific VPN, enter the VPN Name. Use this option carefully as this can increase the amount of data collected and impact monitor performance.
    2. if your message router is a Solace Cloud Edition VMR, toggle on the Edition option and enter the SEMP Version for previous versions to Solace 7.2. Otherwise, leave the default value.


6. Click to close the dialog and     (in the title bar) to save your settings.



The connections you create are listed in the Connections tab.


7. Repeat these steps to add multiple message routers and click when finished.


8. Click to return to the HOME page, then click to apply your settings.

The data server will be available again in 10-15 seconds. (Note that the RESTART
DATASERVER option is visible only if you saved your connection entries.)


9.  Open a browser and go to the RTView Solace Monitor: *http://IPAdress:8068/rtview/solmon* if you are running the monitor remotely. Note: you will be using a browser to connect to the AMI on port 8068 – please make sure that the security group you choose allows for access


Use solmon/solmonpw for username/password (if login is enabled).


10. Verify that you see monitoring data. If you encounter issues, check the log files in the RTViewSolaceMonitor/projects/rtview-server/log directory for errors.

You have completed the Quick Start!