OSID Logo
OSID Specifications
installation package
Version 3.0.0
Release Candidate Preview
Interfaceosid.installation.InstallationProxyManager
Implementsosid.OsidProxyManager
osid.installation.InstallationProfile
Description

The installation manager provides access to package installation sessions and provides interoperability tests for various aspects of this service. Methods in this manager accept a Proxy for passing information from server environments. The sessions included in this manager are:

  • InstallationLookupSession: a session to look up local installations
  • InstallationQuerySession: a session to query local installations
  • InstallationSearchSession: a session to search local installations
  • InstallationManagementSession: a session to install and remove packages
  • InstallationUpdateSession: a session to get package updates
  • InstallationNotificationSession a session for subscribing to new or deleted installations
  • SiteLookupSession: a session for listing installation sites
  • PackageLookupSession: a session to look up packages
  • PackageQuerySession: a session to query packages
  • PackageSearchSession: a session to search packages
  • PackageAdminSession: a session to create, modify and delete packages
  • PackageNotificationSession: a session to receive messages pertaining to package changes
  • PackageDepotSession: a session for retrieving package and depot mappings
  • PackageDepotAssignmentSession: a session for managing package and depot mappings
  • PackageSmartDepotSession: a session for managing smart depots of packages
  • DepotLookupSession: a session to lookup depots
  • DepotQuerySession: a session to query depots
  • DepotSearchSession : a session to search depots
  • DepotAdminSession : a session to create, modify and delete depots
  • DepotNotificationSession : a session to receive messages pertaining to depot changes
  • DepotHierarchySession: a session to traverse the depot hierarchy
  • DepotHierarchyDesignSession: a session to manage the depot hierarchy
MethodgetInstallationLookupSession
Description

Gets the OsidSession associated with the installation lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationLookupSessionan InstallationLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsInstallationLookup() is false
ComplianceoptionalThis method must be implemented if supportsInstallationLookup() is true.
MethodgetInstallationLookupSessionForSite
Description

Gets the OsidSession associated with the installation lookup service for the given site.

Parametersosid.id.IdsiteIdthe Id of the site
osid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationLookupSession an InstallationLookupSession
ErrorsNOT_FOUND siteId not found
NULL_ARGUMENT siteId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsInstallationLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsInstallationLookup() and supportsVisibleFederation() are true.
MethodgetInstallationQuerySession
Description

Gets the OsidSession associated with the installation query service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationQuerySession[]an InstallationQuerySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsInstallationQuery() is false
ComplianceoptionalThis method must be implemented if supportsInstallationQuery() is true.
MethodgetInstallationQuerySessionForSite
Description

Gets the OsidSession associated with the installation query service for the given site.

Parametersosid.id.IdsiteIdthe Id of the site
osid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationQuerySession[] an InstallationQuerySession
ErrorsNOT_FOUND siteId not found
NULL_ARGUMENT siteId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsInstallationQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsInstallationQuery() and supportsVisibleFederation() are true.
MethodgetInstallationSearchSession
Description

Gets the OsidSession associated with the installation search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationSearchSessionan InstallationSearchSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsInstallationSearch() is false
ComplianceoptionalThis method must be implemented if supportsInstallationSearch() is true.
MethodgetInstallationSearchSessionForSite
Description

Gets the OsidSession associated with the installation search service for the given site.

Parametersosid.id.IdsiteIdthe Id of the site
osid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationSearchSession an InstallationSearchSession
ErrorsNOT_FOUND siteId not found
NULL_ARGUMENT siteId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsInstallationSearch() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsInstallationSearch() and supportsVisibleFederation() are true.
MethodgetInstallationManagementSession
Description

Gets the OsidSession associated with the installation management service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationManagementSessionan InstallationAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsInstallationManagement() is false
ComplianceoptionalThis method must be implemented if supportsInstallationManagement() is true.
MethodgetInstallationManagementSessionForSite
Description

Gets the OsidSession associated with the installation management service for the given site.

Parametersosid.id.IdsiteIdthe Id of the site
osid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationManagementSession an InstallationAdminSession
ErrorsNOT_FOUND siteId not found
NULL_ARGUMENT siteId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsInstallationManagement() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsInstallationManagement() and supportsVisibleFederation() are true.
MethodgetInstallationUpdateSession
Description

Gets the OsidSession associated with the installation update service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationUpdateSessionan InstallationAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsInstallationUpdate() is false
ComplianceoptionalThis method must be implemented if supportsInstallationUpdate() is true.
MethodgetInstallationUpdateSessionForSite
Description

Gets the OsidSession associated with the installation update service for the given site.

Parametersosid.id.IdsiteIdthe Id of the site
osid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationUpdateSession an InstallationUpdateSession
ErrorsNOT_FOUND siteId not found
NULL_ARGUMENT siteId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsInstallationUpdate() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsInstallationUpdate() and supportsVisibleFederation() are true.
MethodgetInstallationNotificationSession
Description

Gets the notification session for notifications pertaining to installation changes.

Parametersosid.installation.InstallationReceiverinstallationReceiverthe installation receiver
osid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationNotificationSessionan InstallationNotificationSession
ErrorsNULL_ARGUMENT installationReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsInstallationNotification() is false
ComplianceoptionalThis method must be implemented if supportsInstallationNotification() is true.
MethodgetInstallationNotificationSessionForSite
Description

Gets the OsidSession associated with the installation notification service for the given site.

Parametersosid.installation.InstallationReceiverinstallationReceiverthe installation receiver
osid.id.IdsiteIdthe Id of the site
osid.proxy.Proxyproxya proxy
Returnosid.installation.InstallationNotificationSession an InstallationNotificationSession
ErrorsNOT_FOUND siteId not found
NULL_ARGUMENT installationReceiver, siteId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsInstallationNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsInstallationNotification() and supportsVisibleFederation() are true.
MethodgetSiteLookupSession
Description

Gets the OsidSession associated with the site lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.SiteLookupSessiona SiteLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsSiteLookup() is false
ComplianceoptionalThis method must be implemented if supportsSiteLookup() is true.
MethodgetPackageLookupSession
Description

Gets the OsidSession associated with the package lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.PackageLookupSessiona PackageLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageLookup() is false
ComplianceoptionalThis method must be implemented if supportsPackageLookup() is true.
MethodgetPackageLookupSessionForDepot
Description

Gets the OsidSession associated with the package lookup service for the given depot.

Parametersosid.id.IddepotIdthe Id of the depot
osid.proxy.Proxyproxya proxy
Returnosid.installation.PackageLookupSession a PackageLookupSession
ErrorsNOT_FOUND depotId not found
NULL_ARGUMENT depotId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsPackageLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsPackageLookup() and supportsVisibleFederation() are true.
MethodgetPackageQuerySession
Description

Gets the OsidSession associated with the package query service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.PackageQuerySessiona PackageQuerySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageQuery() is false
ComplianceoptionalThis method must be implemented if supportsPackageQuery() is true.
MethodgetPackageQuerySessionForDepot
Description

Gets the OsidSession associated with the package query service for the given depot.

Parametersosid.id.IddepotIdthe Id of the Depot
osid.proxy.Proxyproxya proxy
Returnosid.installation.PackageQuerySessiona PackageQuerySession
ErrorsNOT_FOUNDno Depot found by the given Id
NULL_ARGUMENT depotId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsPackageQuery() and supportsVisibleFederation() are true
MethodgetPackageSearchSession
Description

Gets the OsidSession associated with the package search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.PackageSearchSessiona PackageSearchSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageSearch() is false
ComplianceoptionalThis method must be implemented if supportsPackageSearch() is true.
MethodgetPackageSearchSessionForDepot
Description

Gets the OsidSession associated with the package search service for the given depot.

Parametersosid.id.IddepotIdthe Id of the depot
osid.proxy.Proxyproxya proxy
Returnosid.installation.PackageSearchSession a PackageSearchSession
ErrorsNOT_FOUND depotId not found
NULL_ARGUMENT depotId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsPackageSearch() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsPackageSearch() and supportsVisibleFederation() are true.
MethodgetPackageAdminSession
Description

Gets the OsidSession associated with the package administration service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.PackageAdminSessiona PackageAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageAdmin() is false
ComplianceoptionalThis method must be implemented if supportsPackageAdmin() is true.
MethodgetPackageAdminSessionForDepot
Description

Gets the OsidSession associated with the package admin service for the given depot.

Parametersosid.id.IddepotIdthe Id of the depot
osid.proxy.Proxyproxya proxy
Returnosid.installation.PackageAdminSession a PackageAdminSession
ErrorsNOT_FOUND depotId not found
NULL_ARGUMENT depotId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsPackageAdmin() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsPackageAdmin() and supportsVisibleFederation() are true.
MethodgetPackageNotificationSession
Description

Gets the notification session for notifications pertaining to package changes.

Parametersosid.installation.PackageReceiverpackageReceiverthe package receiver
osid.proxy.Proxyproxya proxy
Returnosid.installation.PackageNotificationSessiona PackageNotificationSession
ErrorsNULL_ARGUMENT packageReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageNotification() is false
ComplianceoptionalThis method must be implemented if supportsPackageNotification() is true.
MethodgetPackageNotificationSessionForDepot
Description

Gets the OsidSession associated with the package notification service for the given depot.

Parametersosid.installation.PackageReceiverpackageReceiverthe package receiver
osid.id.IddepotIdthe Id of the depot
osid.proxy.Proxyproxya proxy
Returnosid.installation.PackageNotificationSession a PackageNotificationSession
ErrorsNOT_FOUND depotId not found
NULL_ARGUMENT packageReceiver, depotId or proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsPackageNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsPackageNotification() and supportsVisibleFederation() are true.
MethodgetPackageDepotSession
Description

Gets the session for retrieving package to depot mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.PackageDepotSessiona PackageDepotSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageDepot() is false
ComplianceoptionalThis method must be implemented if supportsPackageDepot() is true.
MethodgetPackageDepotAssignmentSession
Description

Gets the session for assigning package to depot mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.PackageDepotSessiona PackageDepotAssignmentSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageDepotAssignment() is false
ComplianceoptionalThis method must be implemented if supportsPackageDepotAssignment() is true.
MethodgetPackageSmartDepotSession
Description

Gets the session for managing dynamic package depot.

Parametersosid.id.IddepotIdthe Id of the depot
osid.proxy.Proxyproxya proxy
Returnosid.installation.PackageSmartDepotSessiona PackageSmartDepotSession
ErrorsNOT_FOUND depotId not found
NULL_ARGUMENT depotId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsPackageSmartDepot() is false
ComplianceoptionalThis method must be implemented if supportsPackageSmartDepot() is true.
MethodgetDepotLookupSession
Description

Gets the OsidSession associated with the depot lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.DepotLookupSessiona DepotLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDepotLookup() is false
ComplianceoptionalThis method must be implemented if supportsDepotLookup() is true.
MethodgetDepotQuerySession
Description

Gets the depot query session.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.DepotQuerySessiona DepotQuerySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDepotQuery() is false
ComplianceoptionalThis method must be implemented if supportsDepotQuery() is true.
MethodgetDepotSearchSession
Description

Gets the OsidSession associated with the depot search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.DepotSearchSessiona DepotSearchSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDepotSearch() is false
ComplianceoptionalThis method must be implemented if supportsDepotSearch() is true.
MethodgetDepotAdminSession
Description

Gets the OsidSession associated with the depot administration service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.DepotAdminSessiona DepotAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDepotAdmin() is false
ComplianceoptionalThis method must be implemented if supportsDepotAdmin() is true.
MethodgetDepotNotificationSession
Description

Gets the notification session for notifications pertaining to depot service changes.

Parametersosid.installation.DepotReceiverdepotReceiverthe depot receiver
osid.proxy.Proxyproxya proxy
Returnosid.installation.DepotNotificationSessiona DepotNotificationSession
ErrorsNULL_ARGUMENT depotReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDepotNotification() is false
ComplianceoptionalThis method must be implemented if supportsDepotNotification() is true.
MethodgetDepotHierarchySession
Description

Gets the session traversing depot hierarchies.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.DepotHierarchySessiona DepotHierarchySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDepotHierarchy() is false
ComplianceoptionalThis method must be implemented if supportsDepotHierarchy() is true.
MethodgetDepotHierarchyDesignSession
Description

Gets the session designing depot hierarchies.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.installation.DepotHierarchyDesignSessiona DepotHierarchyDesignSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDepotHierarchyDesign() is false
ComplianceoptionalThis method must be implemented if supportsDepotHierarchyDesign() is true.
MethodgetInstallationBatchProxyManager
Description

Gets an InstallationBatchProxyManager.

Returnosid.installation.batch.InstallationBatchProxyManageran InstallationBatchProxyManager
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsInstallationBatch() is false
ComplianceoptionalThis method must be implemented if supportsInstallationBatch() is true.