TangoWebapp installation tutorial (Windows)

Intended audience: developers, administrators, Programming language: java

  1. Download Apache Tomcat 8 and install it to C:/apache-tomcat-8. To verify that it got installed successfully, try to go to http://127.0.0.1:8080
  2. Download the latest mtangorest.server.jar and put it in C:/apache-tomcat-8/webapps
  3. Follow the .jar installation on mtangorest.server Wiki (it is assumed below tango host is on localhost i.e. 127.0.0.1)
TANGO_ACCESS –> tango://127.0.0.1:20000/sys/access_control/1
TANGO_DB –> tango://127.0.0.1:20000/sys/database/2
TOMCAT_PORT –>8844
  1. Export DatabaseDS, and load it to create a TangoAccessControl server (For this step, you will need to update “database” by “tangoAccessControl”).
TangoAccessControl
1
TangoAccessControl
sys/access_control/1
  1. On jive, click on edit, then create free property named “CtrlSystem”. Then go to property (last tab), click on CtrlSystem, add a new property named “Services” with the value AccessControl/tango:sys/access_control/1
  2. Download the latest TangoWebapp.war on then put it to C://apache-tomcat-8/webapp (When TomCat starts it creates a TangoWebapp folder).
  3. define a tomcat user in C://apache-tomcat-8/conf:
<role rolename="mtango-user"/>
<role rolename="mtango-rest"/>
<user password="tango" roles="mtango-rest, root, manager-script,admin" username="tango-cs"/>
  1. Go to $Tango_home/bin and launch with a command line TangoAccessControl.exe 1
  2. Go to C:/apache-tomcat-8/webapp and launch mtangorest.server with a command line java -jar -DTANGO_HOST=127.0.0.1:20000 mtango.server-rc4-0.4.jar test
  3. Open Jive, then open an atk panel on TangoControlAccess DS, then test device, and execute the AddDeviceForUser command with [“tango-cs”,”sys/database/2”, “write”] as parameter. Also, add a new environment variable name SUPER_TANGO with the value true. Then go on Astor, tool and open AccessControl HMI. Add ..*.* as allowed address for the user tango-cs.
  4. Try your mtango server instance by the URL : http://127.0.0.1:8844/tango/rest (enter username: tango-cs, password : tango if necessary).
  5. Time to try the tango webapp. try to go to the URL : http://127.0.0.1:8080/TangoWebapp. Get logged, then at the top enter as rest host : http://127.0.0.1:8844 (http:// is important), and as host : $Tango_host. Then refresh the page via CTRL+F5. You should have an access to the device tree.

Contributed by Florian Pourchayre