Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Mail Systems
Eclipse Documentation

How To Guides
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Problem Solutions
Privacy Policy




OpenSolaris 2008.11 Image Packaging System Guide
Previous Next

Overview of the Depot Server pkg.depotd

The pkg(1) command makes requests of the repository, also called the depot server, for catalogs and packages. The pkgsend(1) command sends new versions of packages to the depot server. The depot server is typically run as a service on the system. Package and software developers can run private copies for various testing purposes. The pkg.depotd service is managed by the service management facility, smf(5), under the service identifier: svc:/application/pkg/server. Because the depot server expects to be run by a smf(5) restarter, it does not run daemon processes. Error messages are generally sent to standard output, or to the syslogd(1M) system.

The pkg.depotd(1) command is also used with the SMF commands to set up a mirror repository. See the How to Set Up A Mirror for an example of the pkg.depotd(1) options and its usage with the SMF commands.

The pkg.depotd server is usually configured through the smf(5) properties associated with its service instance. The following properties are recognized.

Table 3-6 pkg.depotd(1M) Properties




The file system path where this instance of the depot server should look for its repository data. The default value is /var/pkg/repo.


The port number on which this instance of the depot server should listen to for incoming package requests. The default value is 80.


This property is used to change the base URL for the depot server. This is useful when the depot server is running behind a webserver in a reverse proxy configuration.


The maximum number of seconds the server should wait for a response from a client before closing a connection.


The number of threads that will be started by the depot server to serve requests from the client. The default value is 10.


The destination for any access related information logged by the depot server. The destination could be one of the following :

  • stdout

  • stderr

  • No destination. This is the default value.

  • An absolute pathname.


The destination for any errors or other related information logged by the depot server. The destination could be one of the following :

  • stdout

  • stderr. This is the default value.

  • No destination

  • An absolute pathname.

pkg/mirror (boolean)

This property indicates whether package mirror mode is used. When true, publishing and metadata operations are disabled and only a limited browser user interface is provided. This property may not be true when pkg/readonly is true . The default value is false.

The pkg.depotd(1M) command has the following options to alter the default settings from the service instance.

Table 3-7 pkg.depotd(1M) Options



-d repo_dir

Specify a different repository directory. Overrides pkg/inst_root with the value given by repo_dir.

-p port

Specify a different port number. Overrides pkg/port with the value given by port.

-t socket_timeout

Overrides pkg/threads with the value given by socket_timeput.

--log-access destination

Overrides pkg/log_access with the value given by destination.

--log-errors destination

Overrides pkg/log_errors with the value given by destination.


Modifying operations, such as those initiated by pkgsend(1M) are disabled. Retrieval operations are still available.


Any existing repository catalog will be destroyed and then recreated on startup.

--proxy-base url

Overrides pkg/proxy_base with the value given by url.


Overrides pkg/mirror and sets the value to True.

For further information, see the pkg.depotd(1M) man page.

Example 3-1 Enabling the Depot Server

Type the following command as root user to enable the depot server. In this example, application/pkg/server is the depot server.

# svcadm enable application/pkg/server
Example 3-2 Changing the Listening Port of The Depot Server

Type the following sequence of commands as root user to change the listening port of the depot server. This example sets the listening port of the depot server to 9999.

# svccfg -s application/pkg/server set pkg/port = 9999
# svcadm refresh application/pkg/server
# svcadm restart application/pkg/server
Previous Next

  Published under the terms fo the Public Documentation License Version 1.01. Design by Interspire