System requirements

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

• Supported Microsoft^® Windows^® platforms: Windows XP SP3, Windows Vista SP1, Windows 7
• Supported Linux^® platforms: SuSE Linux Enterprise Desktop(SLED) 10 SP2, RedHat Enterprise Linux(RHEL) 5.2, Ubuntu 8.04
• Supported Mac^® platforms: Macintosh OS X 10.5, Macintosh OS X 10.6.2, Intel only
• At least 450 MB of free disk space on Linux, at least above 1GB of free disk space on Windows and at least 750MB of free disk space on Mac
• At least 512 MB RAM
• 32-bit operating system both for Linux and Windows

Note: Windows installer does not support AMD64 processor with Windows XP or Vista 64-bit platforms installed.

Before you install

• 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: ";|*?!#&$',=^@%
• Uninstall any previous version before installing Lotus Symphony to avoid potential conflicts.
• You must uninstall Lotus Symphony before you switch to a different account on the same system to reinstall Lotus Symphony.

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.

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

There are four RPM packages for IBM Lotus Symphony: the basic package symphony*.rpm, and the three language packages: symphony-nl1*.rpm, symphony-nl2*.rpm, symphony-nl3*.rpm. The basic package contains all functional files and English user interfaces. The language packages contain the features of dictionary, help, template, and user interfaces per language. The packages are:

• symphony-nl1*.rpm: Catalan, Chinese (Simplified), Chinese (Traditional), French, German, Italian, Japanese, Korean, Portuguese (Brazilian), Spanish
• symphony-nl2*.rpm: Arabic, Czech, Danish, Dutch, Finnish, Greek, Hebrew, Hungarian, Norwegian-Bokmal, Polish, Portuguese, Russian, Swedish, Turkish
• symphony-nl3*.rpm: Thai, Slovakian, Slovenian

As the language package depends on the basic package, the basic package should be installed first when uninstalling, the basic package should be uninstalled after the language packages.

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-1.3.i586.rpm file to start the installation, and follow the instructions on the screen.
2. Double-click the symphony-nl1-1.3.i586.rpm, symphony-nl2-1.3.i586.rpm, or symphony-nl3-1.3.i586.rpm file to install the translation packages if you want.

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 directory /etc/lotus/Symphony.
   2. Create the file /etc/lotus/Symphony/install.options.
   3. Add these lines to the file:
      • deviceManagementUserName=username
      • deviceManagementUserPassword=password
      • deviceManagementServerURL=URL

      Get the values of the parameters from ECM server administrator.

3. Run the command rpm -ihv symphony-1.3.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 10.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-1.3.i586.rpm [symphony-nl1-1.3.i586.rpm] [symphony-nl2-1.3.i586.rpm] [symphony-nl3-1.3.i586.rpm].

Note: Options quoted with [] depend on which language packages you previously installed, for example, if you only have the nl1 language package installed, run the command rpm -Uvh symphony-1.3.i586.rpm symphony-nl1-1.3.i586.rpm.

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

Installing IBM Lotus Symphony DEB packages on Ubuntu 8.04

There are four DEB packages for IBM Lotus Symphony: the basic package symphony*.deb, and the three language packages: symphony-nl1*.deb, symphony-nl2*.deb, and symphony-nl3*.deb. The basic package contains all functional files and English user interfaces. The language packages contain the features of dictionary, help, template and user interfaces per language. The packages are:

• symphony-nl1*.deb: Catalan, Chinese (Simplified), Chinese (Traditional), French, German, Italian, Japanese, Korean, Portuguese(Brazilian), Spanish
• symphony-nl2*.deb: Arabic, Czech, Danish, Dutch, Finnish, Greek, Hebrew, Hungarian, Norwegian-Bokmal, Polish, Portuguese, Russian, Swedish, Turkish
• symphony-nl3*.deb: Thai, Slovakian, Slovenian

As the language package depends on the basic package, the basic package should be installed first when uninstalling, the basic package should be uninstalled after the language packages.

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_1.3-1hardy1_i386.deb file to start the installation, and follow the instructions on the screen.
2. Double-click the symphony-nl1_1.3-1hardy1_i386.deb, symphony-nl2_1.3-1hardy1_i386.deb, or symphony-nl3_1.3-1hardy1_i386.deb file to install the translation packages if you want.

Installing or upgrading using the command line

1. Open a command prompt and change the directory to where you downloaded the *.deb file.
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 directory /etc/lotus/Symphony.
   2. Create the file /etc/lotus/Symphony/install.options.
   3. Add these lines to the file:
      • deviceManagementUserName=username
      • deviceManagementUserPassword=password
        deviceManagementServerURL=URL

      Get the parameters from the ECM server administrator.

3. Run the command sudo dpkg -i symphony_1.3-1hardy1_i386.deb [symphony-nl1_1.3-1hardy1_i386.deb] [symphony-nl2_1.3-1hardy1_i386.deb] [symphony-nl3_1.3-1hardy1_i386.deb].

Note: You must upgrade language packages together with base package if you have previous language packages installed. Options quoted with []depend on which language packages you previously installed, for example, if you only have the nl1 language package installed, run the command sudo dpkg -i symphony_1.3-1hardy1_i386.deb symphony-nl1_1.3-1hardy1_i386.deb.

4. 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 /opt/ibm/lotus/Symphony/*.log when the installation or uninstallation fails.

Installing IBM Lotus Symphony on Windows XP, Windows Vista, 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 version 1.3 automatically switches to the native language version specified in this setting.
2. Locate the IBM_Lotus_Symphony_w32.exe file 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 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, use the following three parameters to control the installation of the client.
     • DEVICEMANAGEMENTUSERNAME="username"
       Specify user name on ECM server.
     • DEVICEMANAGEMENTUSERPASSWORD="password"
       Specify user password on ECM server.
     • DEVICEMANAGEMENTSERVERURL="URL"
       Specify the URL of ECM server, along with the protocol and port.

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 begin working with IBM Lotus Symphony to create new 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

There are three installation packages for IBM Lotus Symphony and it supports 18 languages including English, which are the same languages supported on Mac OS X. Download one package according to your need.

• IBM Lotus Symphony.dmg contains all functional files and English user interfaces.
• IBM Lotus Symphony nl1.dmg contains all functional files and user interfaces for languages: English, Chinese (Simplified), Chinese (Traditional), French, German, Italian, Japanese, Korean, Portuguese (Brazilian), Spanish.
• IBM Lotus Symphony nl2.dmg contains all functional files and user interfaces for languages: English, Danish, Dutch, Finnish, Norwegian-Bokmal, Polish, Portuguese, Russian, Swedish.

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 begin working with IBM Lotus Symphony to create new documents, spreadsheets, and presentations. You have one icon for Lotus Symphony under Applications and 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.

Deploying the translation dictionary, hover tips and templates on Windows

1. Ensure that you have installed Lotus Symphony version 1.3 using your target language locale setting before you deploy the translation package.
2. Start Lotus Symphony.
3. Select File > Application > Install to open the Install/Update window.
4. Select Search for new features to install, and click Next.
5. In the Application Location window, click Add Zip/Jar Location. Navigate to the folder where your translation package is located. Select one compressed file, such as updateSite_zh_CN.zip, and click Open. Click OK.
6. Click Finish.
7. In the Search Results window, select all the features contained in the compressed language package, recursively. Click Next to show the feature licenses. Select I accept the terms in the license agreement, and click Next.
8. In the Installation summary window, click Finish to start the file copying process.
9. When the installation completes, restart Lotus Symphony to work with the new language dictionary and templates.
10. The translation package is enabled for all users after it is installed on Windows. Each user needs to perform steps 2 - 10 to enable translation packages on Linux.

Notes:

1. You can switch from English to any other supported languages. But you can only switch from one non-English languages to another within the same package:
   • Package 1 refers to Catalan, Simplified Chinese, Traditional Chinese, French, German, Italian, Japanese, Korean, Portuguese (Brazilian), and Spanish.
   • Package 2 refers to Arabic, Czech, Danish, Dutch, Finnish, Greek, Hebrew, Hungarian, Norwegian, Polish, Portuguese, Russian, Swedish, and Turkish.
   • Package 3 refers to Thai, Slovak, and Slovenian.
   • With an unsupported language switch, for example from French in package 1 to Danish in package 2, you can get a partially translated Danish or completely English user interface. This problem also exists when you upgrade from a different translated installation of the same version.
2. The Windows desktop icon and menu item cannot be created in some special cases. This problem usually happens when you switch between operating system language locales. You can still launch Lotus Symphony directly by navigating to the installation folder and double-clicking the symphony.exe file.
3. These features need to be deployed again after you upgrade from a previous version.

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.