Use this task to upload your product plugin from the system where your software distribution media containing the product plugin is kept to OCSDM.

1. On the menu bar, select Tools, Plugin Management.
2. In the Plugin Management Tool pane, click Upload.
3. In the Upload Plugin dialog box, click Browse to navigate to the directory on your system where you keep the product plugin software package to upload to OCSDM.
   For example:

   sd1.0_Package.zip

4. In the Upload Plugin dialog box, click Upload.
   A dialog box displays showing the upload was successful and the plugin appears in the Element Manager Plugins table in the EM (element manager) tab.

Use this task to install the product plugin in OCSDM.

1. On the menu bar, select Tools, Plugin Management.
2. In the Element Manager Plugins table, select the plugin row and click Install.
3. In the plugin installation dialog box, click Yes to continue the product plugin installation. Your installed plugin contains instructions that initiate core features and functionality in OCSDM. This results in new functionality displaying in existing sliders and new sliders appearing in OCSDM.
4. If the dialog box shows that the installation failed, you are prompted to resolve the identified problem. Once the problem is fixed, click Recover to put the system into a state where another installation of the plugin can be attempted.

When a plugin is uninstalled, it is out of service. OCSDM loses the ability to manage the network functions (NF) and their respective devices that are dependent on this plugin. For example, configuration, polling, trap processing, device statistic gathering, and so on are suspended. However, the devices themselves continue to operate normally on the network.

1. On the menu bar, select Tools, Plugin Management.
2. In the Element Manager Plugins table, select the installed plugin row and click Uninstall.
3. In the confirmation dialog box, click Yes.
4. In the success dialog box, click OK.

   Note:

   The plugin continues to be listed in the Element Manager Plugins table on the EM tab. The Status column shows the state of the plugin as UNINSTALLED and the functionality of that plugin ceases. For example, sliders, folder and leaf nodes may disappear and fields, drop down lists, and so on may disappear from functionality that remains.
5. If the dialog box shows that the plugin failed to uninstall, you are prompted to resolve the identified problem if applicable. Once any applicable error(s) are fixed, click Recover until it is successfully uninstalled.

You can replace an existing product plugin to a different version of the same product plugin.

1. On the menu bar, select Tools, Plugin Management.
2. In the Element Manager Plugins table, select the plugin row and click Install.

   Note:

   A warning appears that this process suspends OCSDM service for any devices associated with the plugin.
3. In the dialog box that appears, click Yes to continue the product plugin installation.
   A dialog box displays the successful replacement of the plugin and all affected services return to operation. If there are any NFs that are no longer supported by the installed plugin, all devices belonging to these NFs are marked as unmanageable and can be removed by the system administrator manually.
4. If the dialog box shows that the replacement of the plugin failed, you are prompted to resolve the identified problem if applicable. Once any applicable error(s) are fixed, click Recover to put the system into a state where another installation of the plugin can be attempted.

When you delete a product plugin from the Element Manager Plugins table, the product plugin .zip file that exists on the OCSDM server is deleted.

1. On the menu bar, select Tools, Plugin Management.
2. In the Element Manager Plugins table, select the uninstalled plugin row and click Delete.
   The following options are presented, depending on whether or not other uninstalled versions of a plugin are present:

   • If you are deleting the last remaining version of an uninstalled product plugin, the following confirmation dialog box appears:

     
   • If you are deleting one plugin version among others, a confirmation dialog box appears with the following options:
     • Check the Clean up NFs checkbox to remove network functions (NFs) and any devices associated with the plugin from OCSDM.
     • Check the Clean up file system checkbox to clean the plugin directory on the OCSDM server. For example:

       AcmePacket/NNCArchive/pluginArchive/<pluginVendorProduct>/<pluginName>/temp
       

3. Click Yes in the confirmation dialog box to complete the deletion of the plugin.
4. In the success dialog box, click OK.

   Note:

   If the plugin displays a Failed_Delete status, the system prompts you to confirm the deletion of the plugin to force its deletion.
   The plugin is no longer listed in the Element Manager Plugins table on the EM tab.

Use this section to view status information for your plugin during installation.

1. On the menu bar, select Tools, Plugin Management.
2. In the Plugin Management Tool pane, you can view plugin information in the following columns displayed in the Element Manager Plugins table on the EM tab:

   Name	The name of the plugin.
   Status	Plugin states: INSTALLED—The plugin is successfully installed. UPLOADED—The plugin is successfully uploaded. UNINSTALLED—The plugin is successfully uninstalled. Failed plugin states: FAILED UPLOAD—The plugin failed to upload from your local directory. FAILED INSTALL—Check if there is an installed plugin with the same plugin Name, Vendor, Product, and version. Errors may also have occurred during the installation. FAILED UNINSTALL—This message may display when uninstalling the previous version of a plugin and errors occur because the database service is temporarily down, the file system is busy, network system is down, and so on. FAILED DELETE—The plugin failed to be removed.
   Server	The IP address of the OCSDM server on which the plugin is installed.
   Version	The version of the plugin.
   Vendor	The company that developed the plugin.
   Product	The product name of the plugin.
   Description	The description of the plugin specified by the system administrator.
   Package Name	The full OCSDM server directory on which the plugin package is installed.
   Date Modified	The date on which the plugin was last modified. For example, this can be its install date, the date the plugin was uploaded, and so on.
   Object ID	(Hidden) The internal OCSDM object ID item.
   pluginType	(Hidden) The type of plugin that allows communication to network elements.

   The following Element Manager Plugins table shows an example of a cluster installation with two-nodes. Two versions of the session delivery (SD) plugin exist (v1.0. and v2.0), and only one version is installed at a time. This example also shows how the plugin status can become unsynchronized across the nodes of a cluster in the case of the EnterpriseExt plugin where the delete action is processed on 10.196.65.3 OCSDM server node, but not completed yet on the 10.196.65.19 OCSDM server node.

   

1. On the menu bar, select Tools, Plugin Management.
2. In the Plugin Management Tool pane, click Edit.
3. In the Plugin Management Edit Plugin dialog box, change, add or remove a description in the Plugin Description field.
4. Click Update.