Waltz (ex. TangoWebapp) installation tutorial (Windows)¶
Intended audience: developers, administrators, Programming language: java, javascript
Contributed by Florian Pourchayre
- 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
- Download the latest rest-server.jar unzip and put it in C:/apache-tomcat-8/webapps
- Follow the .jar installation on rest-server Wiki (it is assumed below tango host is localhost:20000 i.e. 127.0.0.1:20000)
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
- 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
- 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
- Download the latest TangoWebapp.war on then put it to C://apache-tomcat-8/webapp (When TomCat starts it creates a TangoWebapp folder).
- 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"/>
- Go to $Tango_home/bin and launch with a command line
TangoAccessControl.exe 1
- Go to C:/apache-tomcat-8/webapp and launch mtangorest.server with a command line e.g.
java -jar -DTANGO_HOST=127.0.0.1:20000 rest-server-1.8.jar test
- 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.
- Try your rest-server instance by the URL :
http://127.0.0.1:8844/tango/rest
(enter username: tango-cs, password : tango if necessary). - 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 devices tree.