What's New in the Sun N1 Service Provisioning System 5.2 Update 2 Release

Chapter 1 Installing the N1 Service Provisioning System 5.2 Update 2

This release contains scripts that migrate your master server to run N1 Service Provisioning System 5.2 Update 2 from compatible previous releases and compatible previous patch updates.

Installing the N1 Service Provisioning System 5.2 Update 2 Release

This section describes how to install N1 Service Provisioning System 5.2 Update 2. This section explains the following topics:

You can check which version of the N1 Service Provisioning System master server software you are running by using the cr_server command as described in the Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual.

You can check which version of the N1 Service Provisioning System command line interface software you are running by using the cr_cli -version command as described in the Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual.

Supported Platforms and Operating Systems

The supported platforms and operating systems for this release are as follows.

Remote agents and local distributors

All operating systems and hardware platforms are supported as listed in Chapter 2, System Requirements for the Sun N1 Service Provisioning System 5.2, in Sun N1 Service Provisioning System 5.2 Installation Guide.

Master server and command line interface

All hardware platforms are supported as listed in Chapter 2, System Requirements for the Sun N1 Service Provisioning System 5.2, in Sun N1 Service Provisioning System 5.2 Installation Guide.

Only those versions of the Solaris operating system listed in Chapter 2, System Requirements for the Sun N1 Service Provisioning System 5.2, in Sun N1 Service Provisioning System 5.2 Installation Guide are supported. Other listed operating systems are not supported in this release.

ProcedureHow to Acquire the N1 Service Provisioning System 5.2 Update 2 Release

The N1 Service Provisioning System 5.2 Update 2 release is available from http://www.sun.com. This procedure describes how to acquire this release from the specific page http://www.sun.com/software/swportfolio/get.jsp

You can also download the release patches from the SunSolve site at http://sunsolve.sun.com Download the appropriate patches as follows:

Before You Begin

Make sure your system meets the hardware requirements set out in Chapter 2, System Requirements for the Sun N1 Service Provisioning System 5.2, in Sun N1 Service Provisioning System 5.2 Installation Guide.

  1. In your web browser, type the URL http://www.sun.com/software/swportfolio/get.jsp.

    The Sun's Software Portfolio download page is displayed.

  2. In the Select Your Software section, click the check box next to Sun N1 Service Provisioning System.

  3. Click the Get Downloads Media button.

  4. If prompted, log in or register for a Sun Online account.

    The Download Sun Products page is displayed.

  5. In the My Downloads table, click the arrow beneath the product platform that you want to download.

    The Download Page is displayed.

  6. Review and accept the license agreement.

    If you do not agree to the terms of the license agreement, click the radio button beside Decline License Agreement to cancel your download.

  7. Click the check boxes next to the files that you want to download.

    You must download the README file. Select the .zip file of the product that you want to install. You can also download ISO images compressed in .zip files if you want to create physical media for the product.

  8. Click the Download selected with Sun Download Manager button to download the files.

    The files are downloaded to your system.

  9. After you download the files, unzip the .zip files on your system.

ProcedureSPARC: To Install the N1 Service Provisioning System 5.2 Update 2 Release

Before You Begin

Make sure your system meets the hardware requirements set out in Chapter 2, System Requirements for the Sun N1 Service Provisioning System 5.2, in Sun N1 Service Provisioning System 5.2 Installation Guide.

To install the patches that comprise this update release of the N1 Service Provisioning System, you must already have installed and configured a compatible previous release or patch update of the Sun N1 Service Provisioning System. Compatible previous releases and patch updates are as follows:

For full details of how to install the N1 Service Provisioning System 5.2, see Sun N1 Service Provisioning System 5.2 Installation Guide. Details on how to install the patch updates can be found in the relevant patch documentation.

  1. If you do not already have a compatible version of the N1 Service Provisioning System installed and configured on your system, download and install the n1_sps-5_2_1-ga-solaris-sparc.zip file from the Sun's Software Portfolio download page.

    For full details of how to install the N1 Service Provisioning System 5.2.1, see Sun N1 Service Provisioning System 5.2 Installation Guide

    Then, to bring N1 Service Provisioning System to the 5.2 Update 2 level, install the following patches:

    • 122989-12 for the Master Server

    • 122991-12 for the Command Line Interface

  2. After you apply the patches to the master server, update all the remote agents and local distributors in your environment.

    To auto-upgrade, log in to the patched master server. Go to the master server's host detail page and choose Upgrade Entire Host Network.

    You can also execute a selective upgrade using the node.* commands. See Chapter 9, node: CLI Commands for Performing Auto-upgrade Tasks, in Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual for more information.

    This release of the N1 Service Provisioning System contains scripts that migrate your master server from compatible previous releases and patch updates to run the N1 Service Provisioning System 5.2 Update 2 Release.


    Note –

    Only the Command Line Interface patch provided with this release can communicate as a command line interface with the master server patch provided with this release. If you upgrade your master server, you must also upgrade your Command Line Interface.


Procedurex86: To Install the N1 Service Provisioning System 5.2 Update 2 Release

Before You Begin

Make sure your system meets the hardware requirements set out in Chapter 2, System Requirements for the Sun N1 Service Provisioning System 5.2, in Sun N1 Service Provisioning System 5.2 Installation Guide.

To install the patches that comprise this update release of the N1 Service Provisioning System, you must already have installed and configured a compatible previous release or patch update of the Sun N1 Service Provisioning System. Compatible previous releases and patch updates are as follows:

For full details of how to install the N1 Service Provisioning System 5.2, see Sun N1 Service Provisioning System 5.2 Installation Guide. Details on how to install the patch updates can be found in the relevant patch documentation.

  1. If you do not already have a compatible version of the N1 Service Provisioning System installed and configured on your system, download and install the n1_sps-5_2_1-ga-solaris-x86.zip file from the Sun's Software Portfolio download page.

    For full details of how to install the N1 Service Provisioning System 5.2.1, see Sun N1 Service Provisioning System 5.2 Installation Guide

    Then, to bring N1 Service Provisioning System to the 5.2 Update 2 level, install the following patches:

    • 122990-12 for the Master Server

    • 122992-12 for the Command Line Interface

  2. After you apply the patches to the master server, update all the remote agents and local distributors in your environment.

    To auto-upgrade, log in to the patched master server. Go to the master server's host detail page and choose Upgrade Entire Host Network.

    You can also execute a selective upgrade using the node.* commands. See Chapter 9, node: CLI Commands for Performing Auto-upgrade Tasks, in Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual for more information.

    This release of the N1 Service Provisioning System contains scripts that migrate your master server from compatible previous releases and patch updates to run the N1 Service Provisioning System 5.2 Update 2 Release.


    Note –

    Only the Command Line Interface patch provided with this release can communicate as a command line interface with the master server patch provided with this release. If you upgrade your master server, you must also upgrade your Command Line Interface.


Cohabitation of the N1 Service Provisioning System with the N1 System Manager

This section explains how to manage installation this version of the N1 Service Provisioning System on the same system as a compatible version of the N1 System Manager.

Solaris: Installing an N1 Service Provisioning System Master Server and an N1 System Manager Management Server on the Same System

If you use the default installation scripts for the N1 Service Provisioning System master server and the N1 System Manager management server, you cannot install both applications on the same system.

To install both applications on the same system, modify the N1 Service Provisioning System Master Server installation script to install the master server in an alternate root directory. To use this workaround, perform the following steps.


Note –

Do not install the N1 Service Provisioning System OS Provisioning plug-in on a system that hosts both the N1 System Manager's management server and the N1 Service Provisioning System's master server.


  1. Install the N1 System Manager management server. For more information, see Sun N1 System Manager 1.3 Installation and Configuration Guide.

  2. Log in as root on the N1 System Manager management server system.

  3. Copy the appropriate N1 Service Provisioning System master server installation script to the system.

    For an x86 installation, copy the cr_ms_solaris_x86_pkg_5.2.sh from the N1 Service Provisioning System distribution.

    For a SPARC installation, copy the cr_ms_solaris_sparc_pkg_5.2.sh from the N1 Service Provisioning System distribution.

  4. If necessary, start a Korn shell session.


    # ksh
    
  5. Create a shell script file that is named aliases.sh with the following contents.

    #!/bin/ksh
    alias -x pkgadd='pkgadd -R $NEW_PKG_ROOT'
    alias -x pkginfo='pkginfo -R $NEW_PKG_ROOT'
    alias -x pkgparam='pkgparam -R $NEW_PKG_ROOT
  6. Create an alternate root directory for the N1 Service Provisioning System installation.

    # mkdir -p <alternate-root-path>
  7. Export the value of the alternate root directory to use with the N1 Service Provisioning System installation script.


    # export NEW_PKG_ROOT=alternate-root-path
    

    In the previous step, alternate-root-path specifies the root directory in which you want to install the N1 Service Provisioning System Master Server, for example, root1. This alternate root directory will contain a new package repository for the N1 Service Provisioning System Master Server packages.


    Note –

    The path for NEW_PKG_ROOT variable is critical. All steps must be executed in the shell where this new variable is exported.


  8. Create a symbolic link from the opt directory to an alternate opt directory in the new alternate root directory.


    # ln -s /opt alternate-root-path/opt
    
  9. Create a new installation script by prepending the aliases.sh script to the default N1 Service Provisioning System Master Server installation script. For example:


    # cat aliases.sh cr_ms_solaris_x86_pkg_5.2.sh > new_ms_installer.sh
    
  10. Install the N1 Service Provisioning System Master Server by running the new installation script.


    # ./new_ms_installer.sh
    
  11. Answer the installer questions.

    During the installation, consider the following limitations.

    • When you are prompted to specify the installation directory for the master server, enter a new subdirectory under /opt. To avoid overwriting the master server that is installed with N1 System Manager, ensure that this new subdirectory is different from the installation directory of the master server that is installed with N1 System Manager. For example, if, in step 8, you created a symbolic link from /opt to /root1/opt, specifying an installation directory of /opt/ms1 during the installation installs the new N1 Service Provisioning System master server in /root1/opt/ms1.

    • When you are prompted to choose a port to use with the master server, ensure that you specify a port that is different from the port that is used by the master server used by N1 System Manager.

    For more information about how to install N1 Service Provisioning System, see Sun N1 Service Provisioning System 5.2 Installation Guide.

  12. After the installation is completed, change to the directory that contains the N1 Service Provisioning System master server scripts. For example:


    # cd /root1/opt/ms1/N1_Service_Provisioning_System_5.2/server/bin
    
  13. Create a backup copy of the N1 Service Provisioning System Master Server uninstallation script.


    # cp cr_uninstall_ms.sh cr_uninstall_ms.sh.backup
    
  14. Edit the cr_uninstall_ms.sh.backup script to perform the package operations on the alternate root. You can use the sed command to make these changes to the script by typing the following command.


    # /usr/bin/sed -e 's!pkginfo!& -R '${NEW_PKG_ROOT}'!g' \
    -e 's!pkgrm!& -R '${NEW_PKG_ROOT}'!g' \
    -e 's!pkgparam!& -R '${NEW_PKG_ROOT}'!g' \
    cr_uninstall_ms.sh.backup > cr_uninstall_ms.sh
    
  15. Remove the backup copy of the uninstallation script.


    # rm cr_uninstall_ms.sh.backup
    

    To uninstall the N1 Service Provisioning System Master Server, use this revised version of the cr_uninstall_ms.sh script.


    Note –

    Do not remove the new alternate root directory. This directory is required to uninstall the N1 Service Provisioning System master server.