We have a new community! Please visit support.timextender.com
Follow

How to set up the TX Remote Control

Note: This is an old article.  However, the basic concepts may still apply to newer versions.  

Introduction

The remote control is a small system tray application that enables you do a remote execution of a TX project without the need to install the full client. We like to call it "the CEO button", since the simple interface allows execution with a single click.

If you would like an easy way to execute a project on a local machine, consider running TX with parameters.

Prerequisites

The remote control uses the multiple environments feature of TX for remote execution. As such, you need to have the feature as a part of your license and have a server environment running.

System tray icon state

The remote control appears as a led light icon in the system tray (next to the clock in the Windows taskbar). The icon will appear in one of the following colors depending on the state of the program:

  • Green: Application is ready or the last execution was successful
  • Yellow: Project is being executed.
  • Red: An error occurred during last execution.

Step by step

  1. Locate TXRemoteControl.exe in the TX folder - C:\Program Files\TX2014 Server\TX2014 Server version\ - and start the program. If, for some reason, the file is not there, you can download the TX Remote Control here.

  2. Optional: Create a shortcut to the .exe in a convenient place, e.g. the desktop or the start menu. Or right click the .exe, drag it to Start -> Startup and choose Create shortcuts here to have it start up when the user logs in.
  3. Right-click the icon in the system tray and choose Settings. In the settings dialogue, enter your server connection settings. The settings will match those of an environment configured and running in the TX server service. Click Close when you are done.

    remote-control-01.png

  4. Right-click the icon in the system tray and choose Projects and Packages to display the list of projects and execution packages available on the server. Select a package and use the Set as Default button to choose a default package for execution. Click Close when you are done.

    remote-control-02.png

  5. Right-click the icon in the system tray and click on Start update to execute the execution package selected as default above. This will connect to the server, load the project and execute the execution package. While the package is executing, the led will change to yellow and subsequently into green or red, depending on the success or failure execution.

Troubleshooting:

If the Server service is unable to run, you may get this error in the Event Viewer Application log:

Service cannot be started. System.Exception: No local environment has been defined with a valid LocalPort setting
at TxServer.TxServer.OnStart(String[] args)

To resolve this, review the "Prerequisites" section near the beginning of this article.

 


This article applies to: timeXtender 4.5, tX2012, TX2014. Last updated: 2014-04-01.

Was this article helpful?
1 out of 1 found this helpful

5 Comments

  • 0
    Avatar
    Bjørn Götter

    I'm having some trouble with the remote control.

    I got IT to punch a hole in the firewall, and I can see packages on the remote server

    But when I try to execute them I get an error, not telling me much more than an error occurred. It could be something with the local port, I have no idea what the use for a local port is.

    Is the a good way to trouble shoot your installation? (I can log on to the server and execute packages from there, so they work)

    Kind Regards

    /Bjørn

  • 0
    Avatar
    Kurt Denolf

    To have this installed on another pc than the BI server, should we just copy the EXE to that other pc, and follow the same procedure?  Are the any special prereq on that pc ?

  • 0
    Avatar
    Permanently deleted user

    Hi Kurt,

    There is a download link in the article. There are no specific requirements as long as the OS is a recent version of Microsoft Windows.

  • 0
    Avatar
    Niclas Löfblad

    Hi

    Where can I see which ports are defined in TimeXtender?

    Which account will be running the exections? Is it the account used on the local computer where the remote is installed?

    Regards

    Niclas

  • 0
    Avatar
    Sven de Bie

    Is there a way how to run remote control for multiple environments? So that I can switch between dev, acc and prd? Next to that, what are the default ports that are needed and is something needed to adjust in our firewall settings? Because I get the error that it can't connect and the server is correct and I used the ports in the example.

    Edited by Sven de Bie
Please sign in to leave a comment.