Welcome

You can now create your own Sybase Unwired Platform (SUP) developer environment on Amazon Web Services (AWS).

SAP won't charge you anything for the license, but you will be responsible for operating your own AWS account. The AWS instance type we chose for the SUP image is m1.large, find details on the pricing here. The simulator is pre-configured to 4 hours of "typical" usage per day, feel free to adjust. As AWS pricing depends on various variables, the simulator can only give you a good-enough understanding of your anticipated monthly cost, not an exact number.

As a basic recommendation, shut down your instance whenever you are not using it to control cost.

How to create your own SUP@AWS environment

Prerequisites

• An SCN user - if you don't have one yet, you can register free of charge here.
• An AWS account - if you don't have one yet, you can register here (click "Sign Up Now"). Have your credit card handy.

Part 1 - Accept the SAP Developer License Agreement on SCN

Checked all the prerequisites? Then you're ready to create you own SUP server on Amazon Web Services. The whole process should not take longer than about 15 minutes.

• Make sure you are logged in to SCN.
• Start here. Read the license agreement carefully and click the "I Have Read and Agree" button.
• Enter your AWS account ID, pick your preferred data center location and click the "Submit" button.
• You're done with the SCN part and will be forwarded to your Amazon account to complete the setup.

Part 2 - Create your own SUP instance on AWS

• Once you have completed Part 1, the installation process will jump to the AWS website. You will see an instance creation wizard that is automatically started. It provides the default stack name and template URL. You can change the name and click the “Continue” button. Don't change the template URL, though.
• On the following screens, leave the default values unchanged. Just click “Continue” until you get to the confirmation screen.
• Check your SUP stack information summary and then click on “Continue”.
• The stack creation can take a few minutes. This might be a good time to go back to the SUP Developer Center on SCN to download and install the mobile SDK to your local computer (see Part 3).
• You can monitor progress by selecting the stack name and choosing the events tab in the AWS Management Console. You can refresh the status by clicking the refresh button.

Part 3 - Download and install the Mobile SDK

The "Mobile SDK" is the Development Environment for SUP applications. It's based on Eclipse and distributed as a complete installer. The Mobile SDK is pre-installed on your Windows Desktop on AWS, but you can also download the Mobile SDK here and install it on your client computer.

• Again, make sure you are logged in.
• Accept the License Agreement (again, make sure to read it carefully, even though you already know it) and start the download by clicking the "I Agree - Download selected file" button.
• Once the archive is completely downloaded, unpack it and run setup.exe.

Part 4 - First connection to your SUP server on AWS

[Note: the ports used for the following steps maybe blocked by your company or personal firewall. Make sure all relevant ports are open to enjoy your SUP instance]

• If you just created your instance, it is already running. Open the EC2 Management Console and use the combo box in the top left corner of the screen to select the right AWS region.
• Otherwise, Log on to Amazon EC2 and start your SUP instance: In the “Navigation” frame, navigate to “INSTANCES>Instances”. This should show all your instances  in Amazon EC2. Make sure the SUP instance you want to connect to is in “running” state. If not, choose the instance, then click on “Instance Actions” menu, and click on “Start” in the pull down menu.
• Your SUP instance on AWS is automatically associated with an Elastic IP address (What is an Elastic IP?), an IP Address that will remain stable until you terminate the instance. You will need it to connect to this SUP instance in AWS from your locally installed Mobile SDK or from your mobile devices. You find your Elastic IP either by clicking the "Elastic IPs" link in the EC2 Management Console, or in the details of your SUP Instance (click "Instances" in the EC2 Management Console and select the SUP instance).
• Right-click your SUP Instance from the list of instances and choose "Connect". On the popup, you will be able to directly launch a Remote Desktop Connection or download a shortcut for future use. Open the Remote Desktop and logon as user Administrator with Admin1234. You will be prompted to change the password. Remember your password
  • [Note:Changing the password doesn't seem to work from the RDP Client for Mac OS-X, so use a Windows PC for your first logon]
• On the Remote Desktop, you find a Mobile SDK and you are able to Start and Stop your server (it should already be started)
  • [Note: If stopping the instance times out during the "Stop Sybase Control Center 3.2", follow the steps described in SUP Known Issue CR # 683775]
• If your Remote Desktop Connection works fine, test if you are able to access the Sybase Control Center web page:
  • From your local computer, open <https://<your-elastic-ip-address>:8283> in your browser. Skip over the certificate warning and login as user supAdmin with password Admin1234.
  • As a first security measure, change the password for user supAdmin:
    • in Sybase Control Center, navigate to "Security>admin"
    • open tab "Authentication" and double-click the "PreConfiguredUserLoginModule" entry
    • change the password and hit "Save"
    • open tab "General" and hit "Apply"
    • Log out and back in with the new password.
• If your Sybase Unwired Control Center access works fine, process to the next step - connect from your Mobile SDK:
  • Open the Mobile SDK
  • Create a new Unwired Server connection:
    • In the "Enterprise Explorer" view in the bottom left corner, right-click "Unwired Servers" and choose "New..."
    • Enter a name for your new server connection and hit "Next >"
    • As Host, enter the Elastic IP of your AWS instance. As Password enter the password of user supAdmin
    • Leave all other parameters unchanged and hit "Test Connection"
    • If the connection test was successful, hit "Finish". Otherwise, review and correct your settings.
  • Create a new Sample Database connection:
    • In the "Enterprise Explorer" view in the bottom left corner, right-click "Database Connections" and choose "New..."
    • Choose "Sybase ASA", enter a name for the database connection and  hit "Next >"
    • Enter your Elastic IP Address as Host and 5500 as Port and hit "Test Connection"
    • If the connection test was successful, hit "Finish". Otherwise, review and correct your settings.

Your instance should now be configured and you are ready to work through some of the tutorial (a good starting point may be this one), or jump into SUP development straight away.

Where to get help

If you read your license agreement carefully, you know that the SUP Developer License is free of charge (except your hosting cost on AWS), but comes without SAP product support. In case you any questions, please (1) check ourFAQ, (2) seek help on our discussion forumand should all other options fail, (3) send us an email at devcenter@sap.com.