System requirements

The following list contains the client system requirements for Lotus Symphony:

• Supported Microsoft^® Windows^® platforms: Windows XP SP3, Windows Vista SP2, Windows 7
• Supported Linux^® platforms: SuSE Linux Enterprise Desktop 11, RedHat Enterprise Linux 5 Update 4, Ubuntu 8.04
• Supported Mac^® platforms: Macintosh OS X 10.5, Macintosh OS X 10.6.2, Intel only
• At least 750 MB of free disk space on Linux, at least 1 GB of free disk space on Windows, 1 GB of free disk space on Macintosh OS X
• At least 512 MB RAM
• 32-bit operating system both for Linux and Windows

Before you install

• If there is a possibility that you may wish to return to your current Symphony 1.3 installation, including preferences and plug-ins, there are additional steps that you must take prior to the installation of Symphony 3 Beta 2. To view the detailed instructions, please visit the Lotus Symphony wiki and search for "Symphony 3 Beta 2 upgrade" - http://www-10.lotus.com/ldd/lswiki.nsf
• Save the installer packages to a new directory, for example, C:\Symphony_Install on Windows or $USER/Symphony_Install on Linux. If you do not download the installer packages to a new directory, you should move or copy the file to a new directory after the download is complete. The name of your Windows temporary directory and the directory from which you launch Lotus Symphony installation cannot contain non-ASCII characters or any of the following characters: ";|*?!#&$',=^@%.
• You can choose to either uninstall previous version before installing a new version, or install a new version directly. Symphony supports to upgrade from the earlier version, however, some user settings may not be reserved after upgrading.

To uninstall any previously installed version of IBM Lotus Symphony on Windows, complete these steps:

1. Close IBM Lotus Symphony before uninstalling.
2. Open the Control Panel by clicking Start -> Control Panel.
3. Double-click Add or Remove programs.
4. Select IBM Lotus Symphony, and click Remove.

Note: If the uninstallation fails, see the Manually uninstalling on Windows below.

To uninstall any previously ISMP installed versions of IBM Lotus Symphony on Linux (once installed using a *.bin file), complete these steps:

1. Log in as the root user.
2. Change to the <$INSTALLDIR/_uninst> folder, such as /opt/ibm/lotus/Symphony/_uninst.
3. Double-click the uninstaller.bin file to start uninstalling the software.
4. Uninstaller.bin can also be run in silent mode or console mode (only for version 1).
• To run it in silent mode use the command ./uninstaller.bin -silent. To run it in console mode use the commad ./uninstall.bin -console and follow instructions on the screen.
• Set the $HOME environment variable with the value $HOME=/root in case user uses command to get root permission instead of logging in as root user directly. For example, use sudo -H ./uninstaller.bin -console.

Note: If uninstallation fails, see the Manually uninstalling on Linux for earlier ISMP version below.

To uninstall any previously installed version of IBM Lotus Symphony on Mac OS X, complete these steps:

1. Close IBM Lotus Symphony before uninstalling.
2. Delete Symphony.app under /Applications.
3. Delete "Lotus Symphony Data" folder under /Users/$USER/Library/Application Support.

Installing IBM Lotus Symphony RPM packages on Linux SLED 11 and RHEL5

Preparation

1. Log in as the root user.
2. Locate the *.rpm file that you downloaded.
3. Make sure that the additional package standard C++ library libcstdc++.so.6 is installed. This package is installed by default.
4. Make sure that any previous ISMP version, RPM version of Lotus Symphony and RPM version of language packages are uninstalled.

Installing using the GUI mode

1. Double-click the symphony-3.0.i586.rpm file to start the installation, and follow the instructions on the screen.

Installing using the command line

1. Open a command prompt and change the directory to where you downloaded the *.rpm files.
2. If you have an ECM (Expeditor Client Management) server setup, you can configure it to add your client before basic package installation.
1. Create the /etc/lotus/Symphony directory.
2. Create the plugin_customization.ini file under /etc/lotus/Symphony directory.
3. Add these lines to the file:
   • com.ibm.rcp.osgiagent.scheduler/PollingEnabled=true
   • com.ibm.osg.service.osgiagent/UserName=username
   • com.ibm.osg.service.osgiagent/ClientPW=password
   • com.ibm.osg.service.osgiagent/Addr=URL

   Get the values of the parameters from ECM server administrator.

3. Run the command rpm -ihv symphony-3.0.i586.rpm.
4. Lotus Symphony is installed in the /opt/ibm/lotus/Symphony directory. You can start it by clicking Application -> Office on RHEL5 or Computer -> More Applications -> Office on SLED 11.You can use the symbol link /usr/bin/symphony.

Uninstalling using the GUI mode

1. Open the package manager by clicking Applications -> Add/Remove Software on RedHat or Computer -> Control Center -> Open Administrator Settings -> Software -> Software Management on SuSe.
2. Select the package symphony, symphony-nl1, symphony-nl2 or symphony-nl3 from the list and select delete and uninstall the package following the instructions.

Uninstalling using the command line

1. Open a command prompt.
2. Run the command rpm -e symphony-nl1 to uninstall the language package, if it is installed.
3. Run the command rpm -e symphony-nl2 to uninstall the language package, if it is installed.
4. Run the command rpm -e symphony-nl3 to uninstall the language package, if it is installed.
5. Run the command rpm -e symphony to uninstall the basic package.

Upgrading using the command line

If you have a previous version of IBM Lotus Symphony RPM package installed, you can upgrade it using the new package. You must upgrade all installed packages together in one command line if you have previous language packages installed.

1. Open a command prompt.
2. Run the command rpm -Uvh symphony-3.0.i586.rpm.

Note: You can get the exact error information from the *.log file under /opt/ibm/lotus/Symphony directory when the installation or uninstallation fails.

Preparation

1. Log in to the Ubuntu system.
2. Locate the *.deb file that you downloaded.
3. Make sure that the additional package standard C++ library libcstdc++.so.6 is installed. This package is installed by default.
4. Make sure that any previous ISMP version of Lotus Symphony is uninstalled.

Installing or upgrading using the GUI mode

Note: It's recommended to use command line to upgrade all the packages at the same time if you also have language packages installed.

1. Double-click the symphony_3.0-1hardy1_i386.deb file to start the installation, and follow the instructions on the screen.

Installing or upgrading using the command line

1. Open a command prompt and change the directory to where you downloaded the *.deb file.
2. Run the command sudo dpkg -i symphony_3.0-1hardy1_i386.deb .
3. Lotus Symphony is installed in the /opt/ibm/lotus/Symphony directory. You can start it by clicking Applications -> Office -> IBM Lotus Symphony or use the symbol link /usr/bin/symphony.

Uninstalling using the GUI mode

1. Open the package manager by clicking System -> Administrator -> Synaptic Package.
2. Search package symphony, symphony-nl1, symphony-nl2 or symphony-nl3.
3. Uninstall the package following the instructions.

Uninstalling using the command line

1. Open a command prompt.
2. Run the command sudo dpkg -P symphony-nl1 to uninstall the language package, if it is installed.
3. Run the command sudo dpkg -P symphony-nl2 to uninstall the language package, if it is installed.
4. Run the command sudo dpkg -P symphony-nl3 to uninstall the language package, if it is installed.
5. Run the command sudo dpkg -P symphony to uninstall the basic package.

Note: You can get the exact error information from the *.log file under /opt/ibm/lotus/Symphony directory when the installation or uninstallation fails.

Installing IBM Lotus Symphony on Windows XP, Windows Vista and Windows 7

Note: On Windows Vista, you cannot install Lotus Symphony from a remote server.

Installing using the GUI mode

1. Specify your local language setting. Click Start > Control Panel > Region and Language Options, if necessary. Lotus Symphony automatically switches to the native language version specified in this setting.
2. Locate the *.exe file (such as: IBM_Lotus_Symphony_w32.exe) that you downloaded.
3. Double-click the file to start the installation process.
4. Follow the instructions to complete the installation. Click Finish when the installation process is complete.

Installing in silent mode

1. Open a terminal and change to the folder where *.exe file (such as: IBM_Lotus_Symphony_w32.exe) is located.
2. Run the silent installation command IBM_Lotus_Symphony_w32.exe /s /a /s /v/qn. Note that two /s are needed and that there is no space between /v and /qn.

Properties are provided as below:
• INSTALLDIR=< Install folder >
  Target installation folder, which is C:\Program Files\IBM\Lotus\Symphony\ by default.
• LAUNCH=1,0
  Specifies whether or not to launch Lotus Symphony after installation. 1 means launch, 0 means do not launch. It is set to 0 by default.
• FILETYPE=0,1,2,3...
  Specifies which file type is associated with Lotus Symphony. It is set to 3 by default, and ODF and OpenOffice.org 1.1 are associated.
  • 0. No file type is associated with Lotus Symphony
  • 1. ODF file is associated with Lotus Symphony
  • 2. OpenOffice.org 1.1 file is associated with Lotus Symphony
  • 3. ODF and OpenOffice.org 1.1 are associated with Lotus Symphony To associate Lotus Symphony with multiple file types, add the options. For example, 3 (1+2) means it is associated with ODF and OpenOffice.org 1.1 files.
• /lv <logfile>
  Specifies whether to record installation logs in the file < logfile >, which is a MSI parameter.
• If you have an ECM server installed, extract the IBM_Lotus_Symphony_w32.exe file first by winrar or 7-zip, and append below contents in the deploy\plugin_customization.ini file.
  • • com.ibm.rcp.osgiagent.scheduler/PollingEnabled=true
    • com.ibm.osg.service.osgiagent/UserName=username
    • com.ibm.osg.service.osgiagent/ClientPW=password
    • com.ibm.osg.service.osgiagent/Addr=URL

    Get the values of the parameters from ECM server administrator.

A sample command line is: IBM_Lotus_Symphony_w32.exe /s /a /s /v"/lv c:\installogs.txt INSTALLDIR=\"c:\My Program\Lotus\Symphony\" FILETYPE=1 LAUNCH=1 /qn" . The option after /v should use double quotes and use a backslash(\) before other quotation marks which follow.

You are ready to work with IBM Lotus Symphony to create documents, spreadsheets, and presentations. You have one icon for Lotus Symphony on your desktop, and one shortcut on the Start > All Programs menu.

Installing IBM Lotus Symphony on Mac OS X

You can  install Lotus Symphony on Mac OS X using the GUI mode or in silent mode.

Installing using the GUI mode

1. If you have installed previous Lotus Symphony version, uninstall it first and then delete ~/Library/Applications Support/Lotus Symphony Data. If you do not delete it, the old data folder will be reused and upgraded.
2. Double-click the dmg file to mount it.
3. Click the IBM Lotus Symphony.mpkg file to start the installation.
4. Follow the instructions on the screen to complete the installation. Click Finish when the installation process is complete.
5. The installation location is: /Applications/Symphony.app.

   You are ready to work with IBM Lotus Symphony to create documents, spreadsheets, and presentations. An icon for Lotus Symphony is under the Applications directory. You can drag it to your dock bar.

   Note: The installation location cannot be changed.

Installing in silent mode

1. Open a terminal.
2. If you have mounted a Symphony dmg file before, unmount it using the command hdiutil detach /Volumes/"IBM_Lotus_Symphony.mpkg".
3. Go to the directory where the dmg file is,and run the command hdiutil attach "IBM Lotus Symphony.dmg" to mount it.
4. Go to the "IBM_Lotus_Symphony.mpkg" directory, usually it is /Volumes/"IBM_Lotus_Symphony.mpkg"/.
5. Run the installation command sudo installer -pkg "IBM_Lotus_Symphony.mpkg" -target /Applications/.

You can also install Lotus Symphony in other partitions by changing the target to /Volumes/partitionName/Applications/.

Notes:

1. The installing in silent mode sets Lotus Symphony as the default application to open ODF and OO1.1 files.
2. If installation fails, you can get error reason from the ~/SymphonyInstall.log file.

Manually uninstalling on Windows

Try this manual uninstallation approach only when the normal uninstallation process fails.

1. Close IBM Lotus Symphony if it is running.
2. Use the Windows Installer Cleanup Utility to remove IBM Lotus Symphony. You can download the utility from the following location: http://support.microsoft.com/kb/290301.
3. Delete the desktop icon and Start menu item. If the utility does not find any versions of IBM Lotus Symphony, proceed with the standard installation.
4. Delete the installation directory completely. If it is running, end the soffice.exe and the symphony.exe process from the Task Manager window, then remove the installation folder, for example, C:\Program Files\IBM\Lotus\Symphony.
5. Proceed with standard installation.

Manually uninstalling on Linux (once installed from *.bin file)

Try the manual uninstallation approach only when the normal uninstallation process fails.

1. Log in as the root user.
2. Close IBM Lotus Symphony if it is running.
3. Remove the installation directory, such as /opt/ibm/lotus/Symphony. End the soffice.bin and the symphony process, if it is still running.
4. Remove the registry file, /etc/lotus/Symphony.
5. Remove the InstallShield install/uninstall data under /root/InstallShield/Universal/ibm/Symphony.
6. Remove the workspace user data under /root/.lotus/symphony.
7. Remove the shortcut file: /usr/share/applications/IBM Lotus Symphony.desktop.

Manually uninstalling on Mac OS X

Try the manual uninstallation approach only when the normal uninstallation process fails.

1. Close IBM Lotus Symphony before uninstalling.
2. Delete Symphony.app under /Applications.
3. Delete "Lotus Symphony Data" folder under /Users/$USER/Library/Application Support.