Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Upgrading Connectivity Services Director

 

Before you start the upgrade, ensure that you have:

  • Disabled monitoring for all categories from the Monitoring tab of the Preferences page. For more details, see Disabling Data Collection for Monitors section in Setting Up User and System Preferences.

  • Taken a back up your database using the Junos Space backup feature. For more details, see Backing Up and Restoring the Database Overview.

  • Junos Space Release 19.3R1 running on your appliance or virtual machine.

    If your appliance is running a Junos Space release that is earlier than the supported release, you must first determine the currently installed Junos Space version and then upgrade Junos Space before installing Connectivity Services Director. For instructions on how to upgrade Junos Space Platform, refer How Do I Upgrade Junos Space?.

    To determine the installed Junos Space version:

    1. Log in to Junos Space by using the default username and password for Junos Space: super and juniper123.

      Junos Space opens the dashboard.

    2. Click the add symbol (+) next to Administration to expand the Administration menu.
    3. Click Applications to list all of the applications installed.
    4. Note the version of the Network Management Platform or the Network Application Platform. (Some earlier versions of the Network Management Platform were named Network Application Platform.) If the currently installed release is a supported one, you can skip the rest of this procedure; if not, you must upgrade the Network Management Platform to a supported release.
  • Downloaded the Connectivity Services Director Release 5.0R1 software image to the hard disk or to an SCP server. The SCP server in this context is a Linux server on which the Connectivity Services Director image is stored. You can download Connectivity Services Director software image from http://www.juniper.net/support/downloads/space.html .

    You can either:

    • Copy the temporary download link generated by the software download page. You can use the wget download-link command from the remote server to download the image directly to the device, or

    • Download the software image to a local directory.

  • Configuring basic Junos Space settings

    You can configure a Junos Space Appliance as a Junos Space node or as a specialized node used for fault monitoring and performance monitoring (FMPM). For detailed steps to configure a Junos Space Appliance as a Junos Space node, see Configuring a Junos Space Appliance.

    After you deploy a Junos Space Virtual Appliance on a VMware ESX or VMware ESXi server, you must enter basic network and machine information to make your Junos Space Virtual Appliance accessible on the network. You must also increase the virtual machine (VM) drive size. For more information see, Configuring the Basic Settings of a Junos Space Virtual Appliance

To upgrade Connectivity Services Director from the Administration > Applications page of Junos Space:

  1. Select Connectivity Services Director and click Upgrade Application from the Actions list.

    Alternatively, right click Connectivity Services Director and select Upgrade Application.

    The Administration > Applications > Upgrade Application page appears.

  2. Click either Upload via HTTP or Upload via SCP and upload the image as follows:

    To upload Connectivity Services Director software image by using HTTP:

    1. Click Upload via HTTP.

      The Upload Software via HTTP page appears.

    2. Click Browse.

      You can either navigate to the local directory and select the Connectivity Services Director software image, or copy and paste the download URL in the File name field if the image is not already downloaded to the local directory.

      The image file starts downloading when you click Open.

    3. After the image file is downloaded, click Upload to load the image file to Junos Space.
    4. Click OK on the Upload Software via HTTP page that appears.

    To upload Connectivity Services Director software image by using SCP:

    Note

    To upload Connectivity Services Director application by using the SCP option, you must have access to a remote server. The software image is stored on the remote server. The credentials to access the server and the location of the image must be provided in the Upload Software via SCP page when prompted.

    1. Click Upload via SCP.

      The Upload Software via SCP page appears.

    2. Enter the access credentials and the location of the image on the remote server to upload the image to Junos Space:
      • Username: Enter the username.

      • Password: Enter the password.

      • Confirm password: Reenter the password.

      • Machine IP: Enter the IP address of the remote server on which the image is stored.

      • Software File Path: Enter the directory on the remote Server where the Connectivity Services Director software image is stored.

    3. Click Upload to load the image file in to Junos Space.
    4. Click OK to confirm.
  3. In the Upload Application Job Information page that appears:
    • Click the job ID to view the job status in the Jobs > Job Management page.

    • Alternatively, click OK to skip viewing job status and to take you back to the Administration > Applications > Add Application page.

  4. In the Administration > Applications > Upgrade Application page, select Connectivity Services Director and click Upgrade.
  5. In the Upgrade Configuration page, click OK to confirm the upgrade.
  6. In the Upgrade Application Job Information page that appears,
    • click the job ID to view the job status in the Jobs > Job Management page.

      or

    • click OK to skip viewing job status and to take you back to the Administration > Applications page.

    Note

    You can monitor the progress of upgrade from the Jobs > Job Management page.

    Note

    Download the DMI schemas for devices that require a newer version of the schema, and upload the schema to Junos Space.

  7. After the upgrade is complete, select the upgraded version of Connectivity Services Director application from the Applications list.

    Connectivity Services Director starts in your browser window.

    Note

    You must log out and log back in to your Junos Space Application for the upgraded version of the Connectivity Services Director application to appear in the Applications list.

  8. Log in to Junos Space CLI and restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.

    To restart the JBoss server in a standalone setup:

    1. Log in to Junos Space CLI.
    2. Enter the service jmp-watchdog stop, service jboss-dc stop, and service jboss stop commands to stop the watchdog, domain controller, and JBoss services on the standalone node as shown in the following example:
    3. Enter the service jmp-watchdog start command to start the watchdog service as shown in the following example:
      Note

      Starting the watchdog service restarts the JBoss and domain controller services as well.

      JBoss server takes up to 20 minutes to start.

    To restart the JBoss server in a cluster setup:

    1. Enter the service jmp-watchdog stop, and service jboss stop commands to stop the services on the secondary node.
    2. Enter theservice jmp-watchdog stop, service jboss-dc stop, and service jboss stop commands to stop the services on the primary node (You can find the VIP hosted node on the Administration > Fabric page).
    3. Enter the service jmp-watchdog start command to start the services on the primary node.
    4. Enter the service jmp-watchdog start command to start the service on the secondary node.

      JBoss Server takes up to 20 minutes to start.

The following topics describe how to upgrade from previous versions of Connectivity Services Director to Release 5.0R1:

Upgrading from Connectivity Services Director Release 4.2

You can upgrade Connectivity Services Director from Release 4.2R1 to Release 5.0R1 by following the steps given below.

  1. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.

  2. Upgrade Connectivity Services Director to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.

  3. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.

    Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

Upgrading from Connectivity Services Director Release 4.1

You can upgrade Connectivity Services Director from Release 4.1R1 to Release 5.0R1 by following the steps given below.

  1. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.

  2. Upgrade Connectivity Services Director to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.

  3. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.

    Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

Upgrading from Connectivity Services Director Release 4.0

You can upgrade Connectivity Services Director from Release 4.0R1 to Release 5.0R1 by following the steps given below.

  1. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.

  2. Upgrade Connectivity Services Director to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.

  3. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.

    Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

Upgrading from Connectivity Services Director Release 3.0

You can upgrade Connectivity Services Director from Release 3.0R1 to Release 5.0R1 by following the steps given below.

  1. Upgrade Junos Space Platform to Release 18.3R1 or 18.4R1. See Upgrading to Junos Space Network Management Platform Release 18.3R1 or Upgrading to Junos Space Network Management Platform Release 18.4R1 for instructions on upgrading to Junos Space Platform Release 18.3R1 and 18.4R1 respectively.

  2. Upgrade Connectivity Services Director to Release 4.0R1 or 4.1R1. For more information, see Installing and Uninstalling Connectivity Services Director.

  3. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.

  4. Upgrade Connectivity Services Director to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.

  5. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.

    Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

Upgrading from Connectivity Services Director Release 2.2

You can upgrade Connectivity Services Director from Release 2.2R1 to Release 5.0R1 by following the steps given below.

  1. Upgrade Junos Space Platform to Release 18.3R1. See Upgrading to Junos Space Network Management Platform Release 18.3R1 for instructions on upgrading to Junos Space Platform Release 18.3R1.
  2. Upgrade Connectivity Services Director from Release 2.2R1 to Release 4.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  3. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.
  4. Upgrade Connectivity Services Director from Release 4.0R1 to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  5. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

Upgrading from Connectivity Services Director Release 2.1

You can upgrade Connectivity Services Director from Release 2.1R1 to Release 5.0R1 by following the steps given below.

  1. Upgrade Junos Space Platform to Release 18.2R1. See Upgrading to Junos Space Network Management Platform Release 18.2R1 for instructions on upgrading to Junos Space Platform Release 18.2R1.
  2. Upgrade Connectivity Services Director to Release 3.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  3. Upgrade Junos Space Platform to Release 18.3R1 or 18.4R1. See Upgrading to Junos Space Network Management Platform Release 18.3R1 or Upgrading to Junos Space Network Management Platform Release 18.4R1 for instructions on upgrading to Junos Space Platform Release 18.3R1 and 18.4R1 respectively.
  4. Upgrade Connectivity Services Director to Release 4.0R1 or 4.1R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  5. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.
  6. Upgrade Connectivity Services Director to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  7. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

Upgrading from Connectivity Services Director Release 2.0

You can upgrade Connectivity Services Director from Release 2.0R1 to Release 5.0R1 by following the steps given below.

  1. Upgrade Junos Space Platform to Release 17.2R1. See Upgrading to Junos Space Network Management Platform Release 17.2R1 for instructions on upgrading to Junos Space Platform Release 17.2R1.
  2. Upgrade Connectivity Services Director to Release 2.0R1 or 2.2R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  3. Upgrade Junos Space Platform to Release 18.3R1. See Upgrading to Junos Space Network Management Platform Release 18.3R1 for instructions on upgrading to Junos Space Platform Release 18.3R1.
  4. Upgrade Connectivity Services Director to Release 4.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  5. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.
  6. Upgrade Connectivity Services Director to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  7. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

Upgrading from Network Activate Release 14.3R1, Transport Activate 14.3R1, OAM Insight 14.3R1, and Sync Design 14.3R1

You cannot directly upgrade to Connectivity Services Director Release 5.0R1 from the applications in Services Activation Director Release 14.3R1 or 14.3R2, such as Network Activate, NetworkAppsApi, Transport Activate, OAM Insight, QoS Design, and Sync Design. You must first upgrade from Services Activation Director Release 14.3R1 or 14.3R2 to Connectivity Services Director Release 2.0R6, and then upgrade to Connectivity Services Director Release 5.0R1.

To upgrade from Network Activate Release 14.3R1, Transport Activate 14.3R1, OAM Insight 14.3R1, and Sync Design 14.3R1 to Connectivity Services Director Release 5.0R1:

  1. Back up the Junos Space Platform database. For more details, see Backing Up and Restoring the Database Overview.
  2. Upgrade Junos Space Platform to Release 15.1R1.
  3. Reboot Junos Space Platform from the Maintenance Mode Options page.
  4. Uninstall Red Hat Package Manager.

    If you are running a version of Junos Space Platform earlier than Release 15.2R2, uninstall Red Hat Package Manager.

    You can uninstall the Red Hat Package Manager manually, or you can run the uninstall_rpm.sh script to uninstall the Red Hat Package Manager.

    For information about uninstalling Red Hat Package Manager manually, see Installing and Uninstalling Red Hat Package Manager for Connectivity Services Director.

    For more information about the Red Hat installation script, contact the Juniper Networks Technical Assistance Center.

  5. Upgrade Junos Space Platform to Release 15.2R2.Note

    You must not reboot Junos Space Platform from the Maintenance Mode Options page.

  6. Install Red Hat Package Manager.

    You can install the Red Hat Package Manager manually, or you can run the install_rpm.sh script to install the Red Hat Package Manager.

    For more information about installing the Red Hat Package Manager manually, see Installing and Uninstalling Red Hat Package Manager for Connectivity Services Director.

    For more information about the Red Hat installation script, contact the Juniper Networks Technical Assistance Center.

  7. Reboot Junos Space Platform from the Maintenance Mode Options page.
  8. Install the Junos Space Platform hot patch release 15.2R2 v11.

    To install Junos Space Platform hot patch release 15.2R2 v11:

    1. Download the 15.2R2-hotpatch-v11.tgz patch to your local computer from the https://www.juniper.net/support/downloads/?p=space#sw location.
    2. Log in to the Junos Space active VIP node as the admin user.
    3. Transfer the patch to the Junos Space node by using Secure Copy Protocol (SCP). Save the file in a temporary location, such as /tmp/patch or /home/admin.
    4. Navigate to the location on the node where you stored the patch.
    5. Extract the patch by using the following command:
      tar zxf 15.2R2-hotpatch-v11.tgz
    6. Change to the extracted patch directory.
      cd 15.2R2-hotpatch-v11
    7. Type the following command and press Enter to install the patch:
      sh patchme.sh
    8. You are prompted to enter your password. Enter your CLI password.

      The JBoss server is rebooted automatically.

  9. Upgrade to Connectivity Services Director Release 2.0R6.
  10. Upgrade Junos Space Platform to Release 16.1. See Upgrading to Junos Space Network Management Platform Release 16.1R1 for instructions on installing Junos Space Platform Release 16.1R1.
  11. Upgrade to Junos Space Platform to Release 17.1. See Upgrading Junos Space Network Management Platform for instructions on installing Junos Space Platform Release 17.1R1.
  12. Upgrade Connectivity Services Director to Release 2.1. For more information, see Installing and Uninstalling Connectivity Services Director.
  13. If you are using Junos Space Platform Release 17.1, upgrade Junos Space Platform to Release 17.2, 18.1, 18.2 or 18.3. See Upgrading to Junos Space Network Management Platform Release 17.2R1 or Upgrading to Junos Space Network Management Platform Release 18.1R1 or Upgrading to Junos Space Network Management Platform Release 18.2R1 or Upgrading to Junos Space Network Management Platform Release 18.3R1for instructions on upgrading Junos Space Platform Release 17.2R1, 18.1R1, 18.2R1, or 18.3R1 respectively.
  14. Upgrade Connectivity Services Director to Release 2.2. For more information, see Installing and Uninstalling Connectivity Services Director.
  15. Upgrade Junos Space Platform to Release 19.3R1. See Upgrading to Junos Space Network Management Platform Release 19.3R1 for instructions on upgrading Junos Space Platform Release 19.3R1.
  16. Upgrade Connectivity Services Director to Release 5.0R1. For more information, see Installing and Uninstalling Connectivity Services Director.
  17. Uninstall other applications (such as Junos Space QoS Design or Junos Space Transport Activate) as needed before you uninstall Network Activate.
  18. Uninstall NetworkAppsApi.
  19. Uninstall Network Activate.
  20. Restart the JBoss server for the monitoring and fault features to work properly in standalone and cluster setups.Note

    Enable monitoring for all categories from the Monitoring tab of the Preferences page.

    Note

    QoS Design cannot be installed on the same system as Connectivity Services Director. After you uninstall the legacy applications such as Network Activate 14.3R1, Transport Activate 14.3R1, Sync Design 14.3R1, or OAM Insight 14.3R1, wait until the applications are removed from the Applications page of the Junos Space Platform application. After the applications are uninstalled, ensure that you restart the JBoss server for the Connectivity Services Director application to work.