Install Symphony DE on one host

Windows

  1. Double-click the MSI installer and follow the installation prompts.
    Note:

    The default installation directory is: C:\SymphonyDE\DE51. If you are installing Symphony DE 5.1 on the same host as an older version of Symphony DE is installed, specify a different installation directory from your older installation.

  2. When you click finish after accepting the default setting in the Installation Completed window, Getting Started: Developer Overview and Launch DE Platform Management Console (PMC) displays on your screen, and Symphony DE starts automatically.
  3. Log out and log in to the host to apply environment variable changes made during installation.

    During installation, the installer sets the Path and SOAM_HOME environment variables.

Instructions for .NET API users

Perform the following steps only if you are using .NET APIs:

Note:

Make sure you have local administrator privileges to register the .NET assembly. After you install Symphony DE, log on as a local administrator.

  1. Open Administrative Tools > Microsoft .NET Framework version Configuration.
  2. Click Manage the Assembly Cache.
  3. Search for Platform.Symphony.Soam.Net.dll at the following location %SOAM_HOME%\5.1\win32-vc7\lib or %SOAM_HOME%\5.1\w2k3_x64-vc7-psdk\lib and open the .dll file to add it to the Assembly Cache.
  4. Click Add an Assembly to the Assembly Cache in the Assembly Cache window.

Instructions for COM API users

Perform the following steps only if you are using COM APIs:

Note:

Make sure you have local administrator privileges to register the .NET assembly. After you install Symphony DE, log on as a local administrator.

  1. If you did not install with administrator privileges, register Platform.Symphony.Soam.COM.dll, which is at the location %SOAM_HOME%\5.1\win32-vc7\lib\COM or %SOAM_HOME%\5.1\w2k3_x64-vc7-psdk\lib\COM with regsvr32:

    regsvr32 Platform.Symphony.Soam.COM.dll

  2. In the SoamExcelSample.xls spreadsheet, click Tools>Macro>Visual Basic Editor or press Alt+F11.
  3. In the Visual Basic window, click Tools>References and select Platform.Symphony.Soam.COM 1.0 Type Library.
  4. Click Browse and open Platform.Symphony.Soam.COM.dll from the location %SOAM_HOME%\5.1\win32-vc7\lib\COM or %SOAM_HOME%\5.1\w2k3_x64-vc7-psdk\lib\COM.

Linux/UNIX (using the tar.gz file)

  1. Install Symphony DE by using the tar.gz file.
    • On Linux, enter

      tar xzvf install_file.tar.gz

      For example, to install Symphony DE to ./symphonyDE on Red Hat Enterprise Linux 4 and SuSE Linux Enterprise Server 9, enter on one line

      tar xzvf symphonyDE-linux2.6-glibc2.3-x86-5.0.0-build_number.tar.gz

    • On Solaris, enter

      gunzip install_file.tar.gz

      tar xvf install_file.tar.gz

  2. Configure SOAM_HOME in cshrc.soam or profile.soam.
    1. Go to the conf directory in the directory in which Symphony DE was installed.

      For example, if you installed Symphony DE in /opt/symphonyDE/DE51, go to /opt/symphonyDE/DE51/conf.

    2. Set the SOAM_HOME environment variable to the directory in which you have installed Symphony DE.
      • For csh, edit cshrc.soam and cshrc.symclient; change the following line to the directory in which you installed Symphony DE from this line:

      setenv SOAM_HOME $SOAM_HOME

      to:

      setenv SOAM_HOME /opt/symphonyDE/DE51

      • For bash, edit profile.soam and profile.symclient; change the following line to the directory in which you installed Symphony DE from this line:

      SOAM_HOME=$SOAM_HOME

      to:

      SOAM_HOME=/opt/symphonyDE/DE51

    3. Save the file you just edited.

Linux (using the RPM file)

If you have root permissions, you can install using the default settings. To install the RPM file, follow these steps:

  1. Set the environment variable CLUSTERADMIN to your user account to be able to run Symphony DE without root permissions after installation.
    • For example, for csh, enter the following command, where user1 is your operating system user name

      setenv CLUSTERADMIN user1

    • For example, for bash, enter the following command, where user1 is your operating system user name

      export CLUSTERADMIN=user1

  2. Install the package:
    1. Default installation:

      The default installation directory is /opt/symphonyDE/DE51.

      For example, to install Symphony DE on Red Hat Enterprise Linux 4 and SuSE Linux Enterprise Server 9, enter on one line

      rpm -ivh symphonyDE-linux2.6-glibc2.3-x86-5.0.0-build_number.rpm

    1. Custom installation:

      RPM syntax is

      rpm -ivh --dbpath dbpath_dir --prefix install_dir install_file.rpm

      Note:

      --dbpath and --prefix are both optional parameters. Their parameters must be absolute paths. If you install without the --prefix option, Symphony DE is installed in its default directory /opt/symphonyDE/DE51.