Skip to Content

Connecting a real device or a local simulator to the DevCenter

Hi everyone,
We are getting more and more requests from people asking how they can connect their external devices to their Developer Center SUP Server that is hosted by Cloudshare for you. So I thought I write a quick how to show you how to do this and also tell you what you have to know to be able to do this with the Hybrid Web Container (Workflow) of SUP.

I assume you have already installed the Sybase SUP Workflow a.k.a Hybrid Web Container application on your device or simulator. If not have a look here.

In order to connect you have to know the external hostname that your environment was assigned when you started it up. This external hostname can change from time to time as you or Cloudshare stop the server. So please make sure that every time you return to Cloudshare and start up your server you check for the external hostname. You can fine the external hostname under the details link under the “Overview” tab inside Cloudshare.

Startup Settings 2.PNG

If this hostname is the same from your last visit where you configured an external device you are good to go if not you have to re-register the device. Remember that the license we use on the Developer Center allows only 5 devices at any given time. Therefore delete any old entries when you have to re-register.

Once you know the external hostname you have two options to connect your device. Either you pre-register the device for any person/string (not user) that comes to your mind on the SUP server before connecting the device or you simply use the automatic registration which requires you to use a real user on the SUP Server.

Connecting to the SUP Server using the pre-registration:

To do this log on to the Sybase Control Center and under “Applications” choose the “Application Connections” tab. Click the Register button to pre-register the device. In the User field choose any username respectively string that you like (this does not have to be a SUP server user any name will do here) and as a servername type the external hostname that you got from Cloudshare. The Server name has to be the external hostname otherwise your device will not be registered at all.

Device Registration 1.PNG

Click the Specify activation code and choose an activation code. Click ok to pre-register the device.

Now on your external device fill out the fields in the settings of the workflow app in the same way. Click the save button to start the registration. You can see in the log via the menu the comunication that your device does with the SUP Server. At least on Android and iOS ;). I guess this works on BB too somehow.

Device Registration 2.PNG

Once the device is connected you can find the information of you device in the same tab under “Applications” -> “Application Connections”

Device Registration 3.PNG

Connecting using a real user in the SUP Server:

If you simply want to use the Automatic Registration you do not have to do anything on the SUP server before registering. Simply make sure your Cloudshare environment is up and running and your SUP server is started. Fill out the fields as shown in the screenshot below. Make sure you use your hostname and not the one that is shown on this screenshot 😉 . As a user you can only use supAdmin with password s3pAdmin. This is the only real user on the SUP server within the Developer Center. Click save and then check the logfile from the menu.

supAdmin 1.PNG

Also here to see if your device connected successfully use the logfiles withing the Hybrid Web Container a.k.a. Workflow application or go to “Applications” -> “Application Connections” inside the SUP Control Center on your Cloudshare environment

Device Registration 3.PNG

10 Comments
You must be Logged on to comment or reply to a post.
  • Hello Ingo

    thank you for the great info

    I have a question though, i installed the workflow application from android market on my android (2.2) device and i followed the steps of setting the hostname, port, and username and yet on the SCC the status of the device wasn't changed. it is still pending.

    can you tell me what possibly went wrong ?

    • HI Osama,

      what is the log inside the Workflow application saying. I would start from there and see if the two connect at all or if there is some network issue in between. There is always the chance that someting on the network between your device and the server blocks traffic.

    • The hybrid web container (HWC), does not allow for the server name to be changed once its value is specified (for security reasons).  What you might want to do is delete the application connection in SCC, then on your Android device or simulator, select Settings > Applications > Manage Applications > Hybrid Web Container > Clear Data.

      You will then be able to create a new application connection in SCC and re-enter the settings in the HWC's settings screen. 

      If you are using iOS or BlackBerry, I believe you have to uninstall the HWC and re-install it before you can modify its settings once they are initially set.

      • Hi all,

        unforunately this hybrid container behaviour that Daniel describes is correct. They started this with SUP 2.2 and it is very unforunate in our scenario where we host the SUP server on a cloud provider and where external hostnames and IP's potentially change very time one starts up the SUP Server.

        It is kind of hard to me to grasp why uninstall/install one time enter hostname should be more secure that being able to change the hostname right in on the screen. But that is just me I guess 🙂 .

  • Helo Ingo,

    Thank for great tutorial.
    I tried on android emulator, android device and ios device.
    It's ok for all, just not for android device.
    When i go in Hybrid Web Container "Workflow" and i clic on my application, the application start but bug with this error message : " _HWC is not defined".

    I tried to uninstal/instal "Workflow" on the android device, tried to deleted connection in Sybase control center...But impossible :/
    So what work on android emulator and ios device and not android device?

    Thank,

  • I tried out the below steps:

    I selected the Automatic Registration option in iPhone and then entered the username and password, supAdmin and s3pAdmin, respectively, along with other server details required, like server, farm id, port, etc. My device gets connected automatically ( registers automatically ) on Sybase Control Center. My device gets listed as supAdmin.

    I used another iPhone device and did the same step, new device also gets registered with the same name: supAdmin. In this way, there will be multiple devices with the same username, i.e supAdmin.

    Can you please let me know as to how we can have unique username of devices listed on Sybase Control Center.

  • I tried out the below steps:

    I selected the Automatic Registration option in iPhone and then entered the username and password, supAdmin and s3pAdmin, respectively, along with other server details required, like server, farm id, port, etc. My device gets connected automatically ( registers automatically ) on Sybase Control Center. My device gets listed as supAdmin.

    I used another iPhone device and did the same step, new device also gets registered with the same name: supAdmin. In this way, there will be multiple devices with the same username, i.e supAdmin.

    Can you please let me know as to how we can have unique username of devices listed on Sybase Control Center.