developerWorks online trial connection FAQs

Solutions for common problems connecting to online trials

Having trouble connecting to developerWorks free online trials? Start here, where you'll find suggested solutions to some common connectivity issues. If you don't find what you're looking for check out the forum.

Error: 0% of launch.ica from xxx.xx.xxx.xxx completed

Problem:
After you log in on the Citrix window and click the icon for the application, the online trial fails to launch and the following error message is displayed: "0% of launch.ica from IP_address completed."

Cause:
The secure URL for ibm.com needs to be added to the list of trusted sites.

Solution:
In the security settings for your web browser, add the following URLs to the list of trusted sites:
https://*.ibm.com
https://www.ibm.com

For Internet Explorer 8, go to Tools > Internet Options > Security > Trusted Sites > Sites > Add

Error: Cannot connect to the Citrix MetaFrame Server. There is no route to the specified subnet address.

Problem:
When attempting to log on, the following error message is received: "Cannot connect to the Citrix MetaFrame Server. There is no route to the specified subnet address."

Cause:
The port used by Session Reliability (default port 2598) is not responding.

Solution:
Check the resolution section of the Citrix article on Troubleshooting the Citrix XTE Service and Errors. This thread in the Citrix forum also addresses this issue.

Error: Cannot connect to the Citrix MetaFrame Server. Protocol Driver Error.

Problem:
When attempting to log on, the following error message is received: "Cannot connect to the Citrix MetaFrame Server. Protocol Driver Error."

Cause:
The port used by Session Reliability (default port 2598) is not responding.

Solution:
Check the resolution section of the Citrix article on Troubleshooting the Citrix XTE Service and Errors. This thread in the Citrix forum also addresses this issue.

Error: Cannot connect to the Citrix XenApp server. The Citrix XenApp server you have selected is not accepting connections

Problem:
When you try to start an application on the Citrix Server, the following error message is displayed: “Cannot connect to the Citrix XenApp server. The Citrix XenApp server you have selected is not accepting connections” or "No Citrix MetaFrame Server configured on the specified address."

Cause:
This error usually happens when your computer is protected by either a hardware or software firewall. That is, there is a firewall between your computer and the Citrix Server.

Solution:
The following ports must be open in the firewall to allow Citrix internet traffic to pass through to communicate with the Citrix Server:

  • TCP/IP port 1494 or forwarding port ranges 10001 - 10230 or 5001 - 5230 (INBOUND)
    Important note: In environments where Session Reliability is enabled, TCP/IP port 2598 replaces port 1494 as the port that the ICA protocol uses. See this blog post for more detail.

To reconfigure the Windows XP SP2 firewall to allow Citrix traffic to pass through:

Error: Cannot connect to the Citrix MetaFrame server. Selected Citrix SSL server is not accepting connections.

Problem:
When attempting to log on, the following error message is received: "Cannot connect to the Citrix MetaFrame server. The Citrix SSL server you have selected is not accepting connections."

Cause:
Multiple causes.

Solution:
Either remove SSL/TLS + HTTP as the server locator protocol, resolve the SSL Relay/Secure Gateway configuration, or investigate and correct possible .ini corruption in the users’ profile. Consult the Citrix article Cannot connect to the Citrix MetaFrame server for a step-by-step approach.

Error: Cannot connect to the Citrix MetaFrame server. Socket operation on non-socket.

Problem:
When attempting to log on, the following error message is received: "Cannot connect to the Citrix MetaFrame server. Socket operation on non-socket"

Cause:
Multiple causes.

Solution:
The best information Citrix provides on this error is found in this thread on the SOCKS error in the Citrix forum.

Error: Cannot save files to local drives

Problem:
When you connect to a Terminal Server, the Citrix client automatically maps your local drives. If you try to save files to the C: drive, you get an error that says you do not have permission to save files.

Cause:
The Citrix ICA client needs permission to write to your local drives.

Solution:
While you are connected, do the following:

You should now be able to save files to your local drives.

Error: Citrix refused connection error

Problem:
Connection to image via Citrix is blocked.

Cause:
Firewall blocking Citrix connection to Sandbox.

Solution:
You need an open outgoing port range 10001 - 10230 and 5001 - 5230. If you know your VM ID, for example: http://204.90.115.95:10141/Citrix/MetaFrame/default/login.aspx, you just need an open port 10141 and 5141.

There is a simple way to check if you have been blocked by a firewall; open telnet and try to connect to 204.90.115.95 10141 and telnet 204.90.115.95 5141. If you can connect, it will show information like "Connected to 204.90.115.95".

Error: ICA file not found

Problem:
When accessing Citrix-delivered applications via the Citrix web Interface, you can log in and see the icons for applications. You have the Citrix client for PC installed, but when you try to start an application, the message “ICA file not found” is displayed and the application does not start.

Cause:
This problem occurs when the Temporary Internet Files cache folder used by Internet Explorer becomes too large, causing too much delay when saving the .ICA file that is used to launch an application from the web. The error is displayed because the browser can’t find the file.

Solution:
Clear the browser cache as follows:

If that fails:

You can find more information about this error on the Citrix support site.

Error: Internal server error connecting or poor performance from server. The server encountered an internal error or misconfiguration and was unable to complete your request. Please contact the server administrator, [no address given] and inform them of the time the error occurred, and anything you might have done that may have caused the error.

Problem:
Citrix Receiver 3.4 in some environments shows poor performance and will time out before a connection is made.

Cause:
Unknown

Solution:
Unistall version 3.4 and install version 3.3.

URLs with instructions for Citrix

Client software
Sandboxes use the Citrix Receiver to connect your workstation to the remote server running the IBM product you are evaluating. You will need to download the latest Receiver appropriate for your operating system.

Note on Citrix Receiver version 3.4: In some environments significant performance issues lead to a failure to connect. At this time, we are recommending users download version 3.3 as long as it is available.

Note: When you install the Receiver, you are asked at the last step of the installation to provide a work email or server address. (The screen captures show how the prompts look on a Windows system.)

Error: The MetaFrame servers reported an unspecified error.

Problem:
When attempting to log on, the following error message is received: "Error: The MetaFrame servers reported an unspecified error. "

Cause:
MetaFrame server with which Web Interface communicates (the XML broker) is available but unable to service a request.
When using the Web Interface Version 2.0 site, the account or group to which the account belongs was not granted the Log on locally policy or was added to the Deny log on locally policy on the server that is providing XML data to the Web Interface. If using the Web Interface, the MetaFrame server with which Web Interface communicates (the XML broker) is available but unable to service a request.

Solution:
See the Citrix article Troubleshooting the Unspecified Error Message in Web Interface for a number possible solutions to the unspecified error. For help troubleshooting an unspecified error when using the Web Interface Version 2.0 site, try this additional Citrix article Error: The Citrix MetaFrame servers reported an unspecified error.

Can't use the Java Client

Problem:
The Java Client isn't working in the online trial environment.

Cause:
The Java Client has to be configured.

Solution:
To configure the Java Client, follow these steps:

What is address of the server hosting your published apps?

Problem:
The Citrix client is expecting a server address, but you don't know the address.

Solution:
Leave the Server Address field blank and press Next.

Error: Citrix online plug-in could not contact the server

Problem:
Proxy settings can cause this problem.

Solution:
Is there a proxy setting in your web browser? The online plug-in will attempt to use these proxy settings and could cause the message you are seeing. Try the solutions in the article Citrix XenApp could not contact the server.

Note: Citrix now offers the Citrix Receiver that can be used with a Merchandising Server, which deploys your Citrix plug-ins.