v5.1.3 Android Client

[NosekTomas]

Hi,
I'm starting to play around with NetXMS and I can't seem to connect the new application. Or rather, I can't get the WebAPI to work/open.

I used NetXMS a long time ago, and now I'm coming back to it. Back then, there was still the old Android application, which communicated via its mgmt port.

Unfortunately, I couldn't find any documentation on how to get this new application up and running; the documentation refers to the old version.

If I understand this thread correctly, the application requires the new WebAPI – the one that is set up as a module in netxmsd.conf (not the old one that was installed via a war file and tomcat).

I added the following section to netxmsd.conf:

Module = webapi

[WEBAPI]
ListenerPort = 8000

According to the logs, it looks like the module has loaded, but is it only accessible from the localhost address?  I haven't been able to change this in any way. Port 8000 is not available when trying to connect to the netxms server.

root@netxms-testing:/etc# ss -tulpn | grep 8000
tcp   LISTEN 0      4096       127.0.0.1:8000       0.0.0.0:*    users:(("netxmsd",pid=8114,fd=21))

Can anyone please help me or send me a link to existing documentation?

Thank you very much.

[Filipp Sudanov]

@nosektomas said in v5.1.3 Android Client:

Hi,
I'm starting to play around with NetXMS and I can't seem to connect the new application. Or rather, I can't get the WebAPI to work/open.

I used NetXMS a long time ago, and now I'm coming back to it. Back then, there was still the old Android application, which communicated via its mgmt port.

Unfortunately, I couldn't find any documentation on how to get this new application up and running; the documentation refers to the old version.

If I understand this thread correctly, the application requires the new WebAPI – the one that is set up as a module in netxmsd.conf (not the old one that was installed via a war file and tomcat).

Hi and welcome back

Mobile app expects the endpoint to be https, while server module produces only http. Prior to 6.0.2 recommendation was to put nginx in reverse proxy mode. In 6.0.2 now includes reproxy, which is started by server process. You need to generate certificate files and then the following server config should work:

[WEBAPI]
TLSEnable = yes
TLSCertificate = /opt/netxms/etc/server.crt
TLSCertificateKey = /opt/netxms/etc/server.key
TLSPort = 8443

Documentation is a bit behind because this is work in progress, but should be updated soon.

[NosekTomas]

Thank you very much for your reply.

Yesterday, I found out that when I add the following to the configuration:

[WEBAPI]
Address = 0.0.0.0
Port = 8000

the HTTP API becomes accessible from 0.0.0.0 – i.e. from outside of the system. I also found out that the application requires HTTPS when examining it with Wireshark. So I set up a reverse proxy ngnix in front of it and the app connected.

Thank you very much for the [WEBAPI] TLS configuration. I will try to add it so that I don't need an external proxy.

Is there a list of configuration options for [WEBAPI] somewhere? I tried about 10 options for writing "Address = 0.0.0.0". And I didn't find the TLS option (thanks for that).

But then - I found that when I open a node in the APP, I get an error:

Error: java.lang.NumberFormatException: For
input string: "action"

Is this normal?

Thank you very much!

Best regards,
Tomáš Nosek

[alk]

it's known issue, I'll publish app update soon

[NosekTomas]

@filipp-sudanov said in v5.1.3 Android Client:

Hi and welcome back

Mobile app expects the endpoint to be https, while server module produces only http. Prior to 6.0.2 recommendation was to put nginx in reverse proxy mode. In 6.0.2 now includes reproxy, which is started by server process. You need to generate certificate files and then the following server config should work:

Code Select Expand

[WEBAPI]
TLSEnable = yes
TLSCertificate = /opt/netxms/etc/server.crt
TLSCertificateKey = /opt/netxms/etc/server.key
TLSPort = 8443

Documentation is a bit behind because this is work in progress, but should be updated soon.

Thanks a lot. I tried to configure the built-in reproxy according to the instructions, but it won't start. And I dont know why 

[Filipp Sudanov]

Reproxy on linux needs it to be installed manually, as it's not easily available from package. On linux we might use something else in the future. So currently nginx is the way.

Supported parameters are basically Address and Port, Address supports "*" or "any" to bind to all interfaces. (https://github.com/netxms/netxms/blob/master/src/server/core/webapi.cpp#L410)

Rest of params are for reproxy which is not relevant if using nginx (https://github.com/netxms/netxms/blob/master/src/server/core/webapi_tls.cpp#L205)

[Filipp Sudanov]

UPD: reproxy has no repository, but there's .deb package - you can just install that: https://github.com/umputun/reproxy/releases

[nichky]

when we login from android, i tried
 ip-address:8000
ip-address:4701
ip-address.
No of them are working im getting error 500 and 525

[hellium]

Its kinda working now.

But the mobile client is incredibly limited in what data it shows.

We are mainly missing the "comment" field :/.

[alk]

@hellium said in v5.1.3 Android Client:

But the mobile client is incredibly limited in what data it shows.

well, that's why I'm asking for feedback

I've added comments section on object details, will be included in next update.

[hellium]

Great!
Thanks a lot :).

[alk]

Comments are available in open testing track (https://play.google.com/apps/testing/org.netxms.android); 1.0.6 / build 27.