Accessibility

Flex Documentation

Flex 1.0 Updater 1 Installation Instructions

The Macromedia Flex 1.0 Updater 1 includes performance and reliability improvements, enhanced documentation for Flex ActionScript and MXML API Reference, and more.

This document contains the following information about the Flex 1.0 Updater 1:

About Updater 1

Flex 1.0 Updater 1 installs new versions of application files and tools. Application files are JAR and SWC files that are used by the Flex applications running on your Java application server. The updated tools files include Macromedia Flash Debug Player (ActiveX, Netscape, and stand-alone versions), the FlexforFlash.zip file, and the flex-tools.jar file, which is used by the command-line compiler.

The type of Flex installation you have determines how you install Updater 1. There are two types of Flex installations: integrated and nonintegrated.

  • Integrated — You installed the JRun Java application server in addition to Flex. You installed the integrated version of Flex if you had no pre-existing application server prior to installing Flex.
  • nonintegrated — You deployed the flex.war file onto an existing Java application server. This installation might also include web applications that have been packaged with Flex and deployed to any number of application servers.

Updater 1 copies the following files and replaces them with new ones where applicable. File names in green are included for the integrated installation of Flex only. Updater 1 backs up the files whose names are marked with an asterisk (*). These files are backed up to the {flex_install_dir}/flex_updater1/backups directory. Updater 1 cannot back up all files because in a nonintegrated installation, the installer utility does not know where your JAR files are located.

Application files
{flex_install_dir}/flex_updater1/flashgateway.jar
{flex_install_dir}/flex_updater1/flex.jar
{flex_install_dir}/flex_updater1/mx.swc
{flex_install_dir}/flex_updater1/mx_debug.swc

{flex_install_dir}/jrun4/servers/default/samples/WEB-INF/flex/jars/flashgateway.jar
{flex_install_dir}/jrun4/servers/default/samples/WEB-INF/flex/jars/flex.jar
{flex_install_dir}/jrun4/servers/default/samples/WEB-INF/flex/frameworks/mx.swc
{flex_install_dir}/jrun4/servers/default/samples/WEB-INF/flex/frameworks_debug/mx_debug.swc

{flex_install_dir}/jrun4/servers/default/flex/WEB-INF/flex/jars/flashgateway.jar*
{flex_install_dir}/jrun4/servers/default/flex/WEB-INF/flex/jars/flex.jar*
{flex_install_dir}/jrun4/servers/default/flex/WEB-INF/flex/frameworks/mx.swc
{flex_install_dir}/jrun4/servers/default/flex/WEB-INF/flex/frameworks_debug/mx_debug.swc

Tools files
{flex_install_dir}/bin/Install Flash Player 7 AX.exe*
{flex_install_dir}/bin/Install Flash Player 7.exe*
{flex_install_dir}/bin/SAFlashPlayer.exe*

{flex_install_dir}/flexforflash/FlexforFlash.zip*

{flex_install_dir}/lib/flex-tools.jar*
{flex_install_dir}/lib/frameworks/mx.swc*
{flex_install_dir}/lib/frameworks_debug/mx_debug.swc*
      

This document uses the following variable locations:

  • {flex_install_dir} — The location of your Flex installation. The default location in Microsoft Windows is C:/Program Files/Macromedia/Flex, and /root/Macromedia/Flex in a Unix system.
  • {flex_app_root} — The top level of web applications that use Flex. An example of a {flex_app_root} directory is C:/jrun4/servers/default/myFlexApp. Web applications using Flex typically run on Java application servers in an open file structure, although they can be in a WAR file. In the latter case, explode the WAR file in order to carry out the instructions in this document. The top-level directory of that WAR file is the {flex_app_root} directory.

Creating new SWC files for Custom Components and Themes

If you created any custom components or custom theme files based on the FlexForFlash.zip file, and exported them to SWC files from Flash MX 2004, you have to export them again to create new SWC files using the version of FlexForFlash.zip included in the Flex Updater 1 release. For more information on using FlexForFlash.zip, see the chapters "Using Styles, Fonts, and Themes" and "Working with Flash MX 2004" in the "Developing Flex Applications" book. If you have not already done so, the chapter "Working with Flash MX 2004" explains how to configure Flash MX 2004 to create SWC files using the FlexForFlash.zip file.

Installing Updater 1

The process of installing Updater 1 depends on whether you installed the integrated or nonintegrated version of Flex. The Updater 1 installer detects which version of Flex you are running and installs the appropriate files, but you must still take additional steps to ensure a proper update. The following sections describe how to install Updater 1 on both the integrated and nonintegrated versions of Flex 1.0.

Installing Flex 1.0 Updater 1 for a nonintegrated Flex installation

To install Updater 1 for a nonintegrated Flex installation, you run the installer, which extracts the new Flex files to your {flex_install_dir}/flex_updater1 directory. After backing up your original files, you copy the new files into your Flex applications, overwriting the existing files when possible. In addition, the Updater copies new versions of Flash Debug Player, the FlexforFlash.zip file, and the flex-tools.jar file to the appropriate locations under your {flex_install_dir} directory.

The Updater 1 does not back up the JAR or SWC files in your Flex applications. You must do this manually.

The following procedure describes how to install Updater 1. For information on how to install the updated players, see the Flex 1.0 installation instructions.

To install Updater 1 for a nonintegrated Flex installation:

  1. Download the appropriate Flex Updater 1 installer:
    • flex-updater1a-win.exe (Windows)
    • flex-updater1-sol.bin (Solaris)
    • flex-updater1-lin.bin (Linux)
  2. Execute the Updater 1 installer and follow the on-screen instructions.

    The Updater installs the tools files listed above, and backs up all the files that it replaces. Back-up files are stored in the {flex_install_dir}/flex_updater1/backup directory. The Updater also copies the new application files listed above to the {flex_install_dir}/flex_updater1 directory.
  3. Stop your Java application server.
  4. For each application that you are upgrading with Updater 1, perform the following steps:
    1. If your Flex application is installed as a WAR file, explode the contents of the WAR file into an open directory structure so that you can overwrite individual files. (If your Flex application is installed as an open directory, you do not need to do this.)
    2. Back up the following files that are in your Flex application's directory structure:
      • {flex_app_root}/WEB-INF/flex/jars/flex.jar
      • {flex_app_root}/WEB-INF/flex/jars/flashgateway.jar
      • {flex_app_root}/WEB-INF/flex/frameworks/mx.swc
      • {flex_app_root}/WEB-INF/flex/frameworks_debug/mx_debug.swc
      You are only required to back these files up for one application; all applications use the same files and can be restored, if necessary, with the same backed-up files.
    3. Copy the {flex_install_dir}/flex_updater1/mx.swc file to the {flex_app_root}/WEB-INF/flex/frameworks directory.
    4. Copy the {flex_install_dir}/flex_updater1/mx_debug.swc file to the {flex_app_root}/WEB-INF/flex/frameworks_debug directory.
    5. Copy the {flex_install_dir}/flex_updater1/flex.jar file to the {flex_app_root}/WEB-INF/flex/jars directory.
    6. Copy the {flex_install_dir}/flex_updater1/flashgateway.jar file to the {flex_app_root}/WEB-INF/flex/jars directory.
  5. Start your Java application server.
  6. (Optional) Install the new versions of Flash Debug Player. Updater 1 copied these Players to the {flex_install_dir}/bin directory. For information on how to install the updated Players, see the Flex 1.0 installation instructions.

Installing Flex 1.0 Updater 1 for an integrated Flex installation

To install Updater 1 for an integrated Flex installation, you run the installer, which extracts the new Flex files to your {flex_app_root} and {flex_install_dir}/flex_updater1 directories. In addition, the Updater copies new versions of Flash Debug Player, the FlexforFlash.zip file, and the flex-tools.jar file to the appropriate locations under your {flex_install_dir} directory.

The following procedure describes how to install Updater 1 for an integrated Flex installation. For information on how to install the updated Players, see the Flex 1.0 installation instructions.

To install Updater 1 for an integrated Flex installation:

  1. Download the appropriate Flex Updater 1 installer:
    • flex-updater1a-win.exe (Windows)
    • flex-updater1-sol.bin (Solaris)
    • flex-updater1-lin.bin (Linux)
  2. Stop JRun.
  3. Execute the Updater 1 installer and follow the on-screen instructions.

    The Updater updates the SWC files (mx.swc and mx_debug.swc) and JAR files (flex.jar and flashgateway.jar) inside the "flex" and "samples" applications that are running on the default JRun server. The Updater also installs the tools files listed above, and backs up all the files that it replaces. Back-up files are stored in the {flex_install_dir}/flex_updater1/backup directory.
  4. If you created new applications in addition to the "flex" and "samples" applications, you must manually update those applications. To do this, perform the following steps:
    1. Make a back-up copy of your {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/flex directory. You can use this to back out of the Updater if necessary.
    2. Copy the {flex_install_dir}/flex_updater1/mx.swc file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/frameworks directory.
    3. Copy the {flex_install_dir}/flex_updater1/mx_debug.swc file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/frameworks_debug directory.
    4. Copy the {flex_install_dir}/flex_updater1/flex.jar file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/jars directory.
    5. Copy the {flex_install_dir}/flex_updater1/flashgateway.jar file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/jars directory.
  5. Start JRun.
  6. (Optional) Install the new versions of Flash Debug Player. Updater 1 copied these Players to the {flex_install_dir}/bin directory. For information on how to install the updated Players, see the Flex 1.0 installation instructions.

Uninstalling Updater 1

The process you use to uninstall Updater 1 depends on whether you installed the integrated or nonintegrated version of Flex. The following sections describe how to uninstall Flex using both versions.

Uninstalling Updater 1 for a nonintegrated Flex installation

The following procedure describes how to uninstall Updater 1 for a nonintegrated Flex installation.

To uninstall Updater 1 for a nonintegrated Flex installation:

  1. Stop your Java application server.
  2. For each of your Flex applications, perform the following steps:
    1. If your Flex application is installed as a WAR file, explode the contents of the WAR file into an open directory structure so that you can overwrite individual files. (If your Flex application is installed as an open directory, you do not need to do this.)
    2. Copy the flex.jar file and flashgateway.jar file from your back-up location to the {flex_app_root}/WEB-INF/flex/jars directory.
    3. Copy the mx.swc file from your back-up location to the {flex_app_root}/WEB-INF/flex/frameworks directory.
    4. Copy the mx_debug.swc file from your back-up location to the {flex_app_root}/WEB-INF/flex/frameworks_debug directory.
  3. Copy the mx.swc file from your back-up location to the {flex_install_dir}/lib/frameworks directory.
  4. Copy the mx_debug.swc file from your back-up location to the {flex_install_dir}/lib/frameworks_debug directory.
  5. Copy the {flex_install_dir}/flex_updater1/backup/FlexforFlash.zip file to the {flex_install_dir}/flexforflash directory.
  6. Copy the {flex_install_dir}/flex_updater1/backup/flex-tools.jar file to the {flex_install_dir}/lib directory.
  7. Copy the Flash Debug Players from the {flex_install_dir}/flex_updater1/backup directory to the {flex_install_dir}/bin directory and reinstall them using the instructions in the Flex 1.0 installation instructions.
  8. Start your Java application server.

Uninstalling Updater 1 for an integrated Flex installation

The following procedure describes how to uninstall Updater 1 for an integrated Flex installation.

To uninstall Updater 1 on an integrated Flex installation:

  1. Stop JRun.
  2. For each Flex application that is running on your JRun server, perform the following steps:
    1. Copy the {flex_install_dir}/flex_updater1/backup/mx.swc file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/frameworks directory.
    2. Copy the {flex_install_dir}/flex_updater1/backup/mx_debug.swc file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/frameworks_debug directory.
    3. Copy the {flex_install_dir}/flex_updater1/backup/flex.jar file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/jars directory.
    4. Copy the {flex_install_dir}/flex_updater1/backup/flashgateway.jar file to the {flex_install_dir}/jrun4/servers/{server_name}/{app_name}/WEB-INF/flex/jars directory.
  3. Copy the {flex_install_dir}/flex_updater1/backup/mx.swc file to the {flex_install_dir}/lib/frameworks directory.
  4. Copy the {flex_install_dir}/flex_updater1/backup/mx_debug.swc file to the {flex_install_dir}/lib/frameworks_debug directory.
  5. Copy the {flex_install_dir}/flex_updater1/backup/FlexforFlash.zip file to the {flex_install_dir}/flexforflash directory.
  6. Copy the {flex_install_dir}/flex_updater1/backup/flex-tools.jar file to the {flex_install_dir}/lib directory.
  7. Copy the Flash Debug Players from the {flex_install_dir}/flex_updater1/backup directory to the {flex_install_dir}/bin directory, and reinstall them using the instructions in the Flex 1.0 installation instructions.
  8. Start JRun.

 

Getting Started

 

Application Development

 

Security

 

Downloads

 

Documentation

 

Community Resources