The image packaging system client, pkg1, can retrieve content from mirror servers. A mirror provides a complete copy of a repository's catalog of packages. Using a nearby mirror can speed up system updates, distribution construction, zone creation, and other packaging-intensive operations. The following figure gives an overview of the IPS repository mirroring and the IPS certificate servers.

Ensure that you are running the OpenSolaris 2009.06 operating system. Read the section on the depot server, and become familiar with the pkg.depotd(1M) command. Ensure that you have sufficient bandwidth and disk space on the system that will mirror the master repository. Become root. Import the SMF service manifest.# svccfg import /var/svc/manifest/application/pkg-server.xml Prepare a location for your mirror server, by briefly running a packaging depot server in normal mode.The depot server will create the appropriate directory structures. In this example, /export/pkg is such a location.# mkdir /export/pkg # /usr/lib/pkg.depotd -d /export/pkg -p 8009 [wait for startup messages to conclude] Deploy a second instance of the packaging server to run as a read-only mirror. Set pkg/port to a different value if you do not want your mirror to run on port 80.# svccfg -s pkg/server svc:/application/pkg/server> add mirror svc:/application/pkg/server> select mirror svc:/application/pkg/server> addpg pkg application svc:/application/pkg/server> addpg start method svc:/application/pkg/server> setprop start/exec= astring: "/usr/lib/pkg.depotd --mirror -p %{pkg/port} -d %{pkg/inst_root} -t %{pkg/socket_timeout} -s % {pkg/threads} --proxy-base=%{pkg/proxy_base} --log-access=%{pkg/log_access} --log-errors=%{pkg/log_errors}" svc:/application/pkg/server> setprop pkg/inst_root = astring: "/export/pkg" svc:/application/pkg/server> setprop pkg/threads = count: 50 svc:/application/pkg/server> setprop exit Refresh the mirror.# svcadm refresh pkg/server:mirror Enable the mirror.# svcadm enable pkg/server:mirror For system performance, mount the file system that contains your repository with noatime so that file accesses do not cause directory metadata updates. The following command uses ZFS.# zfs set atime=off filesystem_name Add a mirror to the configuration of the repository on your local packaging clients.# pkg set-publisher -m http://my.hostname.sun.com opensolaris.org Ensure that you have set up a mirror. For instructions on setting up a mirror, see Use the following command to add a mirror.$ pfexec pkg set-publisher -m name_of_mirror_to_add publisher This example creates an image, adds a mirror within the image, and installs a package.$ pfexec pkg image-create -a os=http://ipkg.sun.com /tmp/io $ cd /tmp/io $ pfexec pkg set-publisher -m http://ipkg.mirror os $ pfexec pkg install SUNWzsh Ensure that you have set up a mirror and added the mirror to the current publisher associated with your image. For instructions on setting up a mirror, see . Use the following command to remove a mirror.$ pfexec pkg set-publisher -M name_of_mirror_to_remove publisher