Installing IBM Spectrum Symphony Developer Edition on one host

Learn how to install IBM® Spectrum Symphony Developer Edition on a Windows or Linux® host.

1. Install IBM Spectrum Symphony Developer Edition on a Windows host:
   1. Double-click the MSI installer and follow the installation prompts.
      Take note of the following:

      • IBM Spectrum Symphony Developer Edition is by default installed to the C:\Program Files\IBM\SpectrumComputingDE\DE731 directory.
      • If you do not have permission to install, enable permissions.
      • If you are installing IBM Spectrum Symphony Developer Edition 7.3.1 on the same host as an older version of IBM Spectrum Symphony Developer Edition, verify that the installation directory is different from your older installation.
   2. When you click finish after accepting the default setting in the Installation Completed window, IBM Spectrum Symphony Developer Edition 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.

   4. 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 IBM Spectrum Symphony Developer Edition, 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%\version\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.
   5. 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 IBM Spectrum Symphony Developer Edition, 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%\version\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 %SOAM_HOME%\version\w2k3_x64-vc7-psdk\lib\COM directory.
2. Install IBM Spectrum Symphony Developer Edition on a Linux host:

   If you have root permissions, you can install using the default settings.

   1. Set the environment variable CLUSTERADMIN to your user account to be able to run IBM Spectrum Symphony Developer Edition without root permissions after installation. For example:
      • (bsh) export CLUSTERADMIN=user1
      • (tcsh) setenv CLUSTERADMIN user1

      where user1 is your operating system user name.

   2. If you plan to use MapReduce (available only on Linux 64-bit hosts), set JAVA_HOME to point to the directory where the JDK is installed. For example:
      • (bsh) export JAVA_HOME=/opt/java/j2sdk1.x
      • (tcsh) setenv JAVA_HOME /opt/java/j2sdk1.x
   3. If you plan to use the Hadoop Distributed File System (HDFS) with MapReduce:
      1. Set HADOOP_HOME to the installation directory where Hadoop is installed. For example:
         • (bsh) export HADOOP_HOME=/opt/hadoop-2.7.2
         • (tcsh) setenv HADOOP_HOME /opt/hadoop-2.7.2
      2. Set HADOOP_VERSION to Hadoop 2.7.2.
         For example:

         • (bsh) export HADOOP_VERSION=2_7_2
         • (tcsh) setenv HADOOP_VERSION 2_7_2
   4. Install the package:
      • To install with default settings, run:

        ./symphony_DE_package_name.bin

        IBM Spectrum Symphony Developer Edition will be installed to the default directory of /opt/ibm/platformsymphonyde/de731.

      • To install with custom settings:
        1. Extract the .rpm files from the symphony_DE_package_name.bin file:

           symde-symphony_DE_package_name.bin --extract extract_directory

           where extract_directory specifies the directory to extract .rpm files.
           For example:

           symde-7.3.1_x86_64.bin --extract myExtractDirectory/

        2. Install each .rpm file:

        ./rpm -ivh symphony_DE_package_name.rpm --prefix install_location --dbpath dbpath_location
        

        where the --prefix and --dbpath are both optional parameters. If you specify any of them, you must provide the absolute paths.
        For example:

        ./rpm -ivh symde-7.3.1.x86_64.rpm --prefix /opt/symphonyde --dbpath /opt/db/ABCdb
        

        Note: Ubuntu: To install the .rpm files on Ubuntu, you must also specify the --ignorearch parameter. For example:

        -ivh --ignorearch --prefix install_location --dbpath dbpath_location RPM_file_name