Note: This is an old article. However, the basic concepts may still apply to newer versions.
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.
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
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.
- 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.
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.
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.
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.
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.
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)
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 ?
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.
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?