This chapter describes how to troubleshoot installations of Beebox- AEM Connector. During installation, you may encounter a few issues based on the configuration of your Beebox Server.
Connection issues
Ports and Firewalls
Please ensure the relevant ports and firewall are properly configured as described in Beebox Installation Guideyour AEM instance is able to access your Beebox server. You will need to have proper inbound and outbound outbound rules configured on your AEM server, and proper inbound rules configured for Beebox Server.
The Beebox Installation Guide lists all the required configurations in details.
| Info |
|---|
| You can download the Beebox installation Guide here. |
Proxy Troubleshooting
The following points help in troubleshooting the proxy related issues:
- The browser or client is misconfigured: A A misconfigured browser is a common error that proxy server administrators face. In many environments, users can modify their browser settings without restriction, which often leads to users changing important proxy server settings. To To ensure appropriate proxy server configuration for every user's browser, you can use system policies to prevent users from altering settings.
- The URL or Web site is down: When When users enter an incorrect URL, each browser responds differently. Proxy Proxy servers also return this message in a file.You can customize this file to help in troubleshooting.
- Connectivity or network problems: Network Network problems are common problems that every proxy server administrator faces. If If the remote site is down or inaccessible, it's often up to the administrator to break the bad news to end users.A simple ping to the proxy server can help troubleshoot this problem.
Proxy Server Problems: One One common problem during setup is the presence of multiple default gateways. This problem generates a 10060 error (Connection Timed Out) to any request sent to the Web Proxy service. Though this error is often associated with slow external links to the Internet, if it occurs right after setup, more than one default gateway is probably present.
Connection Troubleshooting
Connection problems can be checked by pinging to the server's Ip and ports.
Using Telnet:
You can use telnet to chcek the Ip and port connectivity. to check if your AEM server is able to communicate with your Beebox server.
Open the command prompt and use the following command "telnet stargate.terrassl.net 25telnet myserver.beebox.wordbee.com 8089". Here stargatemyserver.beebox.terrasslwordbee.netcom is the host/IP address and 25is 8089 is the port which u that you want to connect to. If the connection is a success, the telnet window to corresponding address opens
E.g.: telnet stargatemyserver.beebox.terrasslwordbee.net 25com 8089
Using PING :
To check if you can access the connection, you can ping the server:
TRACERT :Using Traceroute
A tracert is similar to ping, but will show the details the connection takes to the server. This is a useful debugging tool for generic server access problems.
Translation Troubleshooting
...
The following are some of the reasons where translation does not work:
- The AEM site language and the Beebox configured language should be the same. If these two are different, then the page will not be translated.
- The source language and target language should not be the same. If the source and target languages are the same, then translation does not work.
- The page can be translated to only those languages which are configured in the Beebox server.
For proper configuration, please refer Installing & configuring the plugin.Configuring the plugin.
Exception occurred
When sending an item, it is possible that you get the error message "Exception occurred. Please wait. The system is processing another Job. You may need to Sign-out and Sign-in again".
This error message pops when the system catches an unrecognized error, that is usually visible in the Beebox logs, accessible using the AEM Web Console Log Files.
Here are the known issues:
- Trying to send an item for translation that contains prohibited characters such as plus sign ( + ) in its name.
- Trying to send or retrieve content while your user rights do not permit such action.
The Beebox Translation Console is white
If the Beebox Translation Console is white, it is usually because an error occurred in the back-end.
Please check that all the elements of the components list use a valid format : /path/to/the/components=property1,property2
Content page was not translated
If the translated page could be translated it should be created in a proper way.
Currently, it's not possible to translate node which has only HTML content For example:
But the page which was created and has items can be translated properly
Wordbee Support
If you decide to take support from Wordbee, it is advised to keep the Beebox, IIS logs as well as any screenshot that may help Wordbee to solve the issue.
The Wordbee support can be reached at support@wordbee.com.