Cisco CTE 1400 Series Content Transformation Engines

Table of Contents

Release Notes for Cisco CTE 1400 Series and Design Studio Release 2.7

December 2, 2002

These release notes contain important information and caveats for the Cisco Content Transformation Engine 1400 Series (CTE) and Design Studio Release 2.7. This document supplements information in the Cisco Content Transformation Engine 1400 Series Configuration Note and the Design Studio User Guide.

Contents

These release notes contain the following topics:

Important Security Information

Improper configuration of the CTE can result in a security risk. Before you deploy the CTE, verify that it does not have access to protected intranet sites.

By default, the CTE proxies only the web pages that it has identified (transcoded in Design Studio) to prevent access to protected servers that are on the same subnet as the CTE. If you choose to override that default, do not put the CTE on the same subnet as protected servers.

Note   If you configure the CTE to proxy all web pages, the CTE provides access to computers on the same subnet as the web servers that are configured to work with the CTE. For example, suppose a CTE has an external IP address of 24.221.1.1 and an internal IP address of 192.168.1.31. On the same subnet, you have an intranet server protected from outside access, with an IP address of 192.168.1.20. You can access all ports on the protected intranet server through the CTE by using this URL: http://24.221.1.1/http://192.168.1.20.

Also, be aware of the following security considerations:

Because IP phones do not support SSL, the connection between them and the CTE is not secure. We recommend that you locate the connection between an IP phone and the CTE behind a firewall.

When Design Studio is redirected to an SSL site from a non-SSL site (from HTTPS to HTTP), the connection between Design Studio and the CTE is not secure. We recommend that you locate the connection between Design Studio and the CTE behind a firewall.

Upgrading the CTE and Design Studio

These sections describe how to upgrade your CTE and Design Studio to release 2.7:

Upgrading from Release 2.2a or 2.5

To upgrade to release 2.7 from release 2.2a or 2.5, perform these steps:

Step 2   Insert the CTE Release 2.7 Restore CD-ROM into the CD-ROM drive of the CTE.

Step 3   Power down the CTE.

Step 4   Wait approximately 10 seconds.

Step 5   Power up the CTE.

The serial console displays the upgrade progress and indicates when the installation has successfully completed.

Step 6   When the upgrade is complete, eject the Restore CD and reboot the CTE.

Step 7   When the CTE restarts, the CTE Serial Console appears.

Upgrading from Release 1.1.6

To upgrade from release 1.1.6, perform these steps:

If you do not have the 2.2a Restore CD, you can obtain it in these two ways:

http://www.cisco.com/tac

http://www.cisco.com

For instructions on downloading these files, see the "Downloading Upgrades from Cisco.com" section.

Step 2   Once you have upgraded to 2.2a, obtain a Release 2.5 Restore CD from Cisco TAC by calling 1-800-553-2447 in the United States. To obtain a directory of toll-free Cisco TAC telephone numbers for all countries, go to this URL:

http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml

Step 3   Once you have the Release 2.5 CD, follow the instructions in the "Upgrading from Release 2.2a or 2.5" section.

Downloading Upgrades from Cisco.com

There are three types of patch files that you can download:

Downloading a Partial or Full Upgrade Patch File

To download a partial or full upgrade file, perform these steps:

Step 2   Download the appropriate patch file.

For a partial upgrade that does not overwrite your configuration files, download the following patch file:

CTEServerPartialUpgrade-version.tgz

For a full upgrade that overwrites any existing configuration information, download the following patch file:

CTEServerFullUpgrade-version.tgz

Step 3   Log on to the CTE Administration screens from any web browser, entering the following URL:

https://ipAddress:9001

where:

Step 4   For a full upgrade, use your regular administrative username and password to log on to the Administration screens. For a partial upgrade, use root as the username and cteadmin as the default password.

Step 5   From the Upload Server Upgrade field on Administration > Uploads screen, browse for the file to upload, and select it.

Step 6   Click the Submit button.

Step 7   Once the upload is complete, the CTE will automatically restart.

Step 8   If you downloaded the full patch file (CTEServerFullUpgrade-version.tgz), you will need to reconfigure the CTE from the CTE console. For more information on reconfiguring the CTE, refer to the description of the CTE Console menus in the CTE 1400 Configuration Note.

Downloading an ISO Image File

To download an ISO image file, perform these steps:

Step 2   Download the ISO Images file (CTEServerISO-version.zip).

---

Note    CTE1400ServerISO.2-7.zip contains the CD ISO image for the CTE 1400 Server. CTE1450ServerISO.2-7.zip contains the CD ISO image for the CTE 1450 Server.

---

Step 3   Burn a CD containing the ISO Images file information.

Step 4   Go to the "Upgrading from Release 2.2a or 2.5" section, and use the CD that you have created in this procedure to upgrade your CTE.

Upgrading Design Studio and Configuration Files

To upgrade Design Studio, install the Design Studio software from the CD. For more information on installing Design Studio, refer to the Design Studio User Guide.

When you open a configuration file created in a previous release, Design Studio displays the "Update CTE Design Studio File?" dialog box. You must upgrade the file to work on it in release 2.7.

Note   Due to improvements in Design Studio handling of HTML that is not well-formed, the appearance of transformed pages can differ in release 2.7, particularly for iPAQ devices. As described in the following procedure, you should reload a page in Design Studio before changing or adding rules in order to view how the page will be transformed in release 2.7.

To upgrade a configuration file to release 2.7, perform these steps:

Step 2   In the "Update CTE Design Studio File?" dialog box, choose whether or not you want to use the same file name:

Step 3   Before you change or add rules to a page, we recommend that you refresh the page. In Design Studio, click a page, click the Browse tab, and click the Refresh icon. Alternatively, you can browse to the page in Design Studio and click Apply Rules.

If the original HTML was malformed (for example, it contained two body elements or a meta element inside of a body element), some transformation rules may no longer work.

New Features in Release 2.7

These sections describe new features in the CTE and Design Studio release 2.7:

New CTE Features

The CTE includes the following new features:

You can make ScreenTop Menu always available to IP phone users by using the soft switch to set a phone or phone group's idle URL to the CTE IP address. ScreenTop Menu displays on any device when the device connects to the CTE.

New Design Studio Features

Design Studio includes the following new features:

For more information, refer to the Design Studio User Guide.

Unsupported Software Features

The CTE does not support the following software features:

For a list of unsupported JavaScript features, refer to "JavaScript Features Not Supported by the CTE" in Chapter 6 of the Design Studio User Guide.

Documentation Updates

These sections supplement the CTE and Design Studio documentation:

New DDF Subkey

The DDF contains a new subkey, convert-inputs, under the keys geometry > display > images. Use convert-inputs for devices that support images but not input type="image" elements. This key converts input elements to type="submit".

XHTML Extension to Disable URL Rewriting

The syntax for the XHTML extension that disables URL rewriting is incorrectly stated in the Design Studio User Guide. The correct syntax is as follows:

Tool for Copying Rules from One Device to Another

Design Studio now enables you to copy all transformation rules from one device to another. This new feature is useful when you upgrade Design Studio to support additional device types.

Note   When you copy rules, Design Studio replaces the entire set of rules on the target device with the rules from the source device. Any rules previously on the target device are removed.

To copy all rules from one device to another, perform these steps:

Step 2   From the Tools menu, choose Map New Devices.

Step 3   In the Open dialog box, choose the project that you want to update, and click Open.

The project that you choose should be the project to which you will copy rules.

Step 4   In the From Device area of the Device Mapping dialog box, select the device that has the transformation rules that you want to copy.

Step 5   In the To Device(s) area, select each device to which you want to copy the rules.

If a device already has rules defined, those rules will be replaced with the new rule set.

Step 6   Click Map.

Step 7   Open the configuration file and verify that the rules have the intended results for each device.

CTE Administration Console Changes

These options have been removed from the CTE Administration Console:

Open and Resolved Caveats in Release 2.7

This section contains the following topics:

Open Caveats

This section describes the known limitations for the CTE and Design Studio release 2.7:

The CTE does not support web pages that exceed 256 KB.

Workaround: None.

You cannot delete or edit multiple rules simultaneously by selecting them in the Transformation Rules or Identifier Rules lists and then clicking the Delete or Edit button. Design Studio performs the command only on the last rule selected.

Workaround: Delete or edit the rules individually.

Design Studio and the CTE support only the XSL and XHTML namespaces. If you import an XSL style sheet that contains references to other namespaces, the console displays a message such as the following: "Unsupported stylesheet operation: no such prefix: rdf." Design Studio might stop responding after you load an XSL or XML page.

Workaround: Remove references to unsupported namespaces in XSL style sheets.

When you enter either File > Open or File > Save As and the appropriate dialog box appears, the list/detail icons in the upper-right corner of the dialog box do not work.

Workaround: Use your Windows file browser to view file details.

The CTE does not correctly render animated GIFs.

Workaround: Use Design Studio to clip animated GIFs.

The Dial Number rule does not work on an IP Phone when applied to an element if the label is the same as the element. For example, if you attempt to apply the rule to a phone number 888-123-1234 and the label is also 888-123-1234, the rule will not work, and the phone number will not display on the IP phone.

Workaround: Choose a different element for the label.

After you remove a page from a project, Design Studio does not allow you to undo the operation.

Workaround: Before removing a page, back up the configuration file.

When using the Paginate rule to paginate an anchor that contains a link to slash (a href="/"), the Paginate rule does not appear to work while you are in Design Studio. The Paginate rule, when used as documented, works fine for content displayed on devices.

Workaround: The Paginate rule used as described works fine when content is displayed on devices.

Design Studio checks login passwords for validity up to the eighth character only.

Workaround: Do not create passwords longer than eight characters for Design Studio users.

The CTE does not process content with a content-type of gzip.

Workaround: None.

If an IP phone or wireless device user attempts to navigate in more than one frame of a multi-frame page, the navigation attempt will fail and the browser will report an internal error 500.

Workaround: Use Design Studio transformation rules to change the page so that only one frame is sent at a time. The CTE currently does not support frames.

If you receive a dialog box about a merge conflict while attempting to upload a configuration file to the CTE and you click Ignore and Continue, the configuration file on the CTE will be overwritten even if you originally requested a merge.

Workaround: When the merge conflict dialog box appears, click Cancel, wait a few minutes, and try the upload again.

Resolved Caveats

This section describes caveats resolved in the CTE and Design Studio release 2.7:

Design Studio now supports XSL style sheets that have an xsl:include element.

You can no longer save a configuration file to a blank file name. The problem was a condition of Java 1.2.2 and does not occur now that Design Studio uses Java 1.3.

You can perform multiple uploads of a DDF file from Design Studio without reconnecting to the CTE before each upload.

Additional Documentation

The following documents are available for the CTE and Design Studio:

Obtaining Documentation

The following sections explain how to obtain documentation from Cisco Systems.

World Wide Web

You can access the most current Cisco documentation on the World Wide Web at the following URL:

http://www.cisco.com

Translated documentation is available at the following URL:

http://www.cisco.com/public/countries_languages.shtml

Documentation CD-ROM

Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which is shipped with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual subscription.

Ordering Documentation

Cisco documentation is available in the following ways:

http://www.cisco.com/public/ordsum.html

http://www.cisco.com/go/subscription

Documentation Feedback

If you are reading Cisco product documentation on Cisco.com, you can submit technical comments electronically. Click the Fax or Email option under the "Leave Feedback" section at the bottom of the Cisco Documentation home page. After you complete the form, print it out and fax it to Cisco at 408 527-0730.

You can e-mail your comments to bug-doc@cisco.com.

To submit your comments by mail, use the response card behind the front cover of your document, or write to the following address:

Cisco Systems
Attn: Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883

We appreciate your comments.

Obtaining Technical Assistance

Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools by using the Cisco Technical Assistance Center (TAC) Web Site. Cisco.com registered users have complete access to the technical support resources on the Cisco TAC Web Site.

Cisco.com

Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information, networking solutions, services, programs, and resources at any time, from anywhere in the world.

Cisco.com is a highly integrated Internet application and a powerful, easy-to-use tool that provides a broad range of features and services to help you to:

You can self-register on Cisco.com to obtain customized information and service. To access Cisco.com, go to the following URL:

http://www.cisco.com

Technical Assistance Center

The Cisco TAC is available to all customers who need technical assistance with a Cisco product, technology, or solution. Two types of support are available through the Cisco TAC: the Cisco TAC Web Site and the Cisco TAC Escalation Center.

Inquiries to Cisco TAC are categorized according to the urgency of the issue:

Which Cisco TAC resource you choose is based on the priority of the problem and the conditions of service contracts, when applicable.

Cisco TAC Web Site

The Cisco TAC Web Site allows you to resolve P3 and P4 issues yourself, saving both cost and time. The site provides around-the-clock access to online tools, knowledge bases, and software. To access the Cisco TAC Web Site, go to the following URL:

http://www.cisco.com/tac

All customers, partners, and resellers who have a valid Cisco services contract have complete access to the technical support resources on the Cisco TAC Web Site. The Cisco TAC Web Site requires a Cisco.com login ID and password. If you have a valid service contract but do not have a login ID or password, go to the following URL to register:

http://www.cisco.com/register/

If you cannot resolve your technical issues by using the Cisco TAC Web Site, and you are a Cisco.com registered user, you can open a case online by using the TAC Case Open tool at the following URL:

http://www.cisco.com/tac/caseopen

If you have Internet access, it is recommended that you open P3 and P4 cases through the Cisco TAC Web Site.

Cisco TAC Escalation Center

The Cisco TAC Escalation Center addresses issues that are classified as priority level 1 or priority level 2; these classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer will automatically open a case.

To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to the following URL:

http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml

Before calling, please check with your network operations center to determine the level of Cisco support services to which your company is entitled; for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). In addition, please have available your service agreement number and your product serial number.

Copyright © 2001-2002, Cisco Systems, Inc.
All rights reserved.