Ultra Light Client Guide and Reference


Setting up a ULC development image to run in production mode

If you package your application as described in Packaging ULC-based applications in XD, your application will be enabled for production mode. The following procedure enables you to run your application as a server from a development image:

  1. Add a startup method to the application, registerInUlcSystem, to register the application with the ULC system object. Note that this is a class method.
    MyUlcApp class>>registerInUlcSystem
     
      UlcSystem
        registerApplicationNamed: 'MySample'
        withStartupClass: MyUlcView
    
  2. Configure the UlcSystem instance for production mode. This can be done from the System Transcript window by selecting ULC->System->Change Server Port from the menu bar.
  3. From the System Transcript window, start the server process that will wait for new connections by selecting ULC->System->Start Server Mode from the menu bar.

    Your image is now ready to accept new connections from multiple UI Engine components.

  4. To connect to this image from a command prompt, use the following:
    UIEngine\bin\ulcUI.exe -url ulc://localhost:4444/MySample
    

    If connecting to the application from another machine, replace localhost with the IP address of the machine running the application. As appropriate, replace 4444 with the server port assigned earlier.

    If your application does not run for any reason, ensure that the Debug option is enabled on the ULC->Debug menu. Retry the previous sequence and watch the System Transcript window for error messages.

  5. You can connect multiple UI Engine components to the same Smalltalk image by repeating the previous step from multiple machines or from multiple command prompts on the same machine. After your tests are complete, you can put your image back in the default mode from the System Transcript window by selecting ULC->System->Stop Server Mode from the menu bar.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]