Installing and upgrading Notes on Linux

Notes® installation on Linux™ supports multi-user install.

About this task

If you are upgrading to the current Notes release using an rpm or deb install kit, and installed the earlier release with an ISMP installer, uninstall the earlier release before installing the current release.

Note: See the related topic on considerations for installing before proceeding. For additional and related information about Notes deployment on the Linux platform, see the IBM® Support site and the Notes and Domino® wiki.

deb kit install instructions

About this task

Notes is available as a Debian (.deb) install kit for installing on the Ubuntu platform.

Procedure

  1. Shut down all applications.

    Make sure that all processes are terminated, including eclipse/javaw, eclipse/notes2w, sametime, notes, taskldr, and nsdexec.

    To be sure there are no Notes processes running, change to the Notes data directory and type the following command:

     /opt/ibm/notes/nsd.sh -kill
  2. As the root user, open a terminal window or file browser.
  3. If you are obtaining the deb install kit from a Web downloads page, open your browser and navigate to the Web page from which to obtain the download.
  4. Locate the Notes deb install kit and save it to your /root folder.

    For example, obtain the deb install kit CD or open a browser and navigate to the Web site at which the deb install kit resides.

  5. Navigate to the folder in which you saved the deb install kit and unpack the tar file.
  6. Navigate to the directory that contains the unpacked deb files.
    Note: To install, you must switch to the root user or be logged in as a root user.
    Note: Install to a directory that is readable, but not writeable, by all users.
  7. Specify the deb packages to install. Use either a command line or GUI install method.

    Notes deb packages provide one required component (Notes) and other optional components (Connections, Composite Application Editor, IBM OpenSocial, IBM Feed Reader and IBM Sametime®). Optional components are dependent on the required component. The required component must be installed before installing optional components. Likewise, optional components must be uninstalled before the required component can be uninstalled. The deb file names are Notes version-specific.

deb install file names

About this task

The Notes options and deb file names are as follows; deb file names reflect the Notes version:

  • Notes - Select to install Notes (ibm-notes-version.i586.deb).
  • Feed Reader -- Select to install the Notes Feed Reader (ibm-feedreader-version.i586.deb).
  • Activities/Connections -- Select to install Connections. A Connections server is required to use this feature (ibm-activities-version.i586.deb).
  • Sametime (integrated) -- Select to install basic Sametime capabilities such as chat and live names. A Sametime server is required to use this feature (ibm-sametime-versioni586.deb).
  • Composite Application Editor -- Select to install the Composite Applications Editor for use with composite applications (ibm-cae-version.i586.deb).
  • IBM OpenSocial -- Select to install the IBM OpenSocial component, which extends the Widgets framework to support OpenSocial Gagets and Embedded Experiences (ibm-opensocial-version.i586deb).

You can use the following command to check if you have already installed one or more of the deb packages:

$dpkg -l "ibm-*"

Command line install instructions for deb

Sample instructions for command line deb install are as follows. Deb package names should reflect the Notes version, as supplied.

Note: Refer to the preceding section, deb install file names for the list of version-specific deb file names.
  • To install Notes
    $sudo dpkg -i ibm-notes-version.i586.deb
  • To install Feed Reader
    $sudo dpkg -i ibm-feedreader-version.i586.deb
  • To install Activities/Connections
    $sudo dpkg -i ibm-activities-version.i586.deb
  • To install Composite Application Editor
    $sudo dpkg -i ibm-cae-version.i586.deb
  • To install Sametime
    $sudo dpkg -i ibm-sametime-version.i586.deb
  • To install IBM OpenSocial
    $sudo dpkg -i ibm-opensocial-version.i586.deb

GUI install instructions for deb

Sample instructions to install the deb packages through the operating system GUI installer for Notes are as follows.

Note: Refer to the section, deb install file names earlier in this topic for version-specific deb file names.

The GUI package installer can include a directory in which the required packages reside. In this example, the following packages reside in the /root/notesdebs directory.

Procedure

  1. Place the required deb packages in a target directory, for example /root/notesdebs.
    The GUI package installer can include a directory in which the required packages reside. The following packages reside in the /root/notesdebs directory. The package name should include the Notes version, as supplied.
    • ibm-activities-version.i586.deb
    • ibm-cae-version.i586.deb
    • ibm-notes-version.i586.deb
    • ibm-feedreader-version.i586.deb
    • ibm-sametime-version.i586.deb
    • ibm-opensocial-version.i586.deb
  2. Navigate to the directory using Nautilus or another file manager on your system, right-click the deb file you want to install, and then click Open with GDebi Package installer:
    Be sure to Install ibm-notes-version.i586.deb first and then repeat for each package you want to install.
    Note: If installation is unsuccessful, review the log file at install_dir/framework/rcp/installer_logs/framework_install.log.
    Note: After install, application icons are visible by clicking Computer > More Applications > Office > Notes and are resident in /usr/share/applications.
    Note: On initial startup, the license agreement appears. Read and accept the license agreement terms and continue with Notes setup.

rpm kit install instructions

About this task

Notes is available as an rpm install kit for installing on the Red Hat platform.

Procedure

  1. Shut down all applications.

    Make sure that all processes are terminated, including eclipse/javaw, eclipse/notes2w, sametime, notes, taskldr, and nsdexec.

    To be sure there are no Notes processes running, change to the Notes data directory and type the following command:

    /opt/ibm/notes/nsd.sh -kill
  2. Uninstall any Notes Beta installations.
  3. As the root user, open a terminal window or file browser.
  4. If you are obtaining the rpm install kit from a Web downloads page, open your browser and navigate to the Web page from which to obtain the download.
  5. Locate the Notes rpm install kit and save it to your /root folder.

    For example, obtain the rpm install kit CD or open a browser and navigate to the Web site at which the rpm install kit resides.

  6. Navigate to the folder in which you saved the rpm install kit and unpack the tar file.
  7. Navigate to the directory that contains the unpacked rpm files.
    Note: To install, you must switch to the root user or be logged in as a root user.
    Note: Install to a directory that is readable, but not writeable, by all users.
  8. Optional: Select the features to install by installing the additional rpms that have been included in the rpm install kit. Notes rpm packages provide one required component (Notes) and other optional components (Connections, Composite Application Editor, IBM OpenSocial, IBM Feedreader, and Sametime). Optional components are dependent on the required component. The required component must be installed before installing optional components. Likewise, optional components must be uninstalled before the required component can be uninstalled. The rpm file names are Notes version-specific.

rpm install file names

About this task

The Notes rpm options and file names are as follows; rpm file names reflect the Notes version:

  • Notes - Select to install Notes (ibm_notes-version.i586.rpm).
  • Activities/Connections -- Select to install Connections. A Connections server is required to use this feature (ibm_activities-version.i586.rpm).
  • Feed Reader -- Select (ibm_feedreader-version.i586.rpm) to install the Notes Feed Reader.
  • Sametime (integrated) -- Select to install basic Sametime capabilities such as chat and live names. A Sametime server is required to use this feature (ibm_sametime-version.i586.rpm).
  • Composite Application Editor -- Select to install the Composite Applications Editor for use with composite applications (ibm_cae-version.i586.rpm).
  • IBM OpenSocial -- Select to install the IBM OpenSocial component, which extends the Widgets framework to support OpenSocial Gagets and Embedded Experiences (ibm_opensocial-version.i586rpm).

You can use the following command to check if you have already installed one or more of the rpm packages.

rpm -qa | grep ibm_

Command line instructions

Sample instructions for command line rpm install for Notes are as follows.

Refer to the preceding section, rpm install file names for version-specific rpm file names.
  • To install Notes
    #rpm -i ibm_notes-version.i586.rpm
  • To install Feed Reader
    #rpm -i ibm_feedreader-version.i586.rpm
  • To install Activities/Connections
    #rpm -i ibm_activities-version.i586.rpm
  • To install Composite Application Editor
    #rpm -i ibm_cae-version.i586.rpm
  • To install Sametime
    #rpm -i ibm_sametime-version.i586.rpm
  • To install IBM OpenSocial
    #rpm -i ibm_opensocial-version.i586.rpm

GUI install instructions for rpm

Sample instructions to install the rpm packages through the operating system GUI installer for Notes are as follows.

Refer to the section rpm install file names earlier in this topic for version-specific rpm file names.

The GUI package installer can include a directory in which the required packages reside. In this example, the following packages reside in the /root/notesrpms directory.

Procedure

  1. Place the required rpm packages in a target directory, for example ./root/notesrpms.
    The GUI package installer can include a directory in which the required packages reside. In this example, the packages reside in the /root/notesrpms directory. The package name should include the Notes version, as supplied.
    • ibm_activities-version.i586.rpm
    • ibm_cae-version.i586.rpm
    • ibm_feedreader-version.i586.rpm
    • ibm_notes-version.i586.rpm
    • ibm_sametime-version.i586.rpm
    • ibm_opensocial-version.i586.rpm
  2. Navigate to the directory using Nautilus or another file manager on your system, right-click the deb file you want to install, and then click Open with Package Installer.
    Be sure to Install ibm_notes-version.i586.rpm first and then repeat for each package you want to install.
    Note: If installation is unsuccessful, you can open the install log file at install_dir/framework/rcp/installer_logs/framework_install.log.
    Note: After install, application icons are visible by clicking Computer > More Applications > Office > Notes and reside in /usr/share/applications.
    Note: On initial startup, the license agreement appears. Read and accept the license agreement terms and continue with Notes setup.

Running the Notes client on Linux as a user after root user install

About this task

After you install the Notes client, users can log in and run Notes.

Procedure

  1. Log in as a non-root user.
  2. Start Notes by clicking Computer > More Applications > Office > Notes.
  3. Respond to Notes setup prompts as they appear.
    Note: If you upgraded Notes, you may need to update your mail template.