archive_location Keyword (Solaris 8 Installation Supplement)

Solaris 8 Installation Supplement

`archive_location` Keyword

When you use the custom JumpStart installation method to install a Web Start Flash archive, you must include a new custom JumpStart keyword in the profile file. The new keyword is archive_location and the syntax for the keyword is:

archive_location retrieval_type location

The values of retrieval_type and location depend on where the Web Start Flash archive is stored.

NFS Server

If the archive is stored on an NFS server, use the following syntax for the archive_location keyword.

archive_location nfs server_name:/path/filename

In this command line:

server_name is the name of the server where you stored the archive.
path is the location of the archive to be retrieved from the specified server. If the path contains $HOST, the Web Start Flash installation utilities replace $HOST with the name of the clone system that you are installing.
filename is the name of the Web Start Flash archive file.

Examples:

archive_location nfs golden:/archives/usrarchive

archive_location nfs://golden/archives/usrarchive

HTTP Server

If the archive is stored on an HTTP server, use the following syntax for the archive_location keyword.

archive_location http server_name:port path/filename optional_keywords

In this command line:

server_name is the name of the server where you stored the archive. server_name can be a port number or the name of a TCP service that has a port number that is determined at runtime.
port is an optional port. If you do not specify a port, the Web Start Flash installation utilities use the default HTTP port number, 80.
path is the location of the archive to be retrieved from the specified server. If the path contains $HOST, the Web Start Flash installation utilities replace $HOST with the name of the clone system that you are installing.
filename is the name of the Web Start Flash archive file.

When you are retrieving a Web Start Flash archive from an HTTP server, you can use several optional keywords.

Table 8–1 Optional Keywords to Use With retrieval_type HTTP


Keywords	Value Definitions
`auth basic` `username password`	If the archive is located on an HTTP server that is password protected, you must include the username and password that you need to access the HTTP server in the `profile` file. Note – The use of this authentication method in a profile that is intended for use with custom JumpStart is risky, as unauthorized users might have access to the `profile` file that contains the password.
`timeout` `min`	The `timeout` keyword enables you to specify, in minutes, the maximum length of time that is allowed to pass without receipt of data from the HTTP server before the connection is closed, reopened, and resumed from the point where the timeout occurred. If you specify a `timeout` value of 0 (zero), the connection is not reopened because of inactivity. If a time-out reconnection occurs, the Web Start Flash installation utilities attempt to resume at the last known position in the archive. If the Web Start Flash installation utilities cannot resume at the last known position, the retrieval restarts from the beginning of the archive and the data retrieved prior to the timeout is discarded.
`proxy` `host:port`	The `proxy` keyword allows you to specify a proxy host and proxy port. You can use a proxy host to retrieve a Web Start Flash archive from the other side of a firewall. You must supply a proxy port when you specify the `proxy` keyword.

Examples:

archive_location http silver /archives/usrarchive auth basic user1 secret timeout 5

Or:

archive_location http://user1:secret@silver/archives/usrarchive timeout 5

Local Tape

If the archive is stored on a tape, use the following syntax for the archive_location keyword.

archive_location local_tape device  position

In this command line:

device is the name of the tape drive where you stored the Web Start Flash archive. If the device name is a canonical path, the Web Start Flash installation utilities retrieve the archive from the path to the device node. If you supply a device name that is not a canonical path, the Web Start Flash installation utilities add /dev/rmt/ to the path.
position designates the place on the tape drive where you saved the archive. If you do not supply a position, the Web Start Flash installation utilities retrieve the archive from the current position on the tape drive. By specifying a position, you can place a begin script or a sysidcfg file on the tape drive before the archive.

Examples:

archive_location local_tape /dev/rmt/0n 5

Or:

archive_location local_tape 0n 5

Local Device

You can retrieve a Web Start Flash archive from a local device if you stored the Web Start Flash archive on a file system-oriented, random-access device, such as a diskette or a CD-ROM. Use the following syntax for the archive_location keyword.

Note –

You can retrieve an archive from stream-oriented devices, such as tape, by using the syntax for local tape.

archive_location local_device device path/filename file_system_type

In this command line:

device is the name of the drive where you stored the Web Start Flash archive. If the device name is a canonical path, it is mounted directly. If you supply a device name that is not a canonical path, the Web Start Flash installation utilities add /dev/dsk/ to the path
path is the path to the Web Start Flash archive, relative to the root of the file system on the device you specified. If the path contains $HOST, the Web Start Flash installation utilities replace $HOST with the name of the clone system that you are installing.
filename is the name of the Web Start Flash archive file.
file_system_type specifies the type of file system on the device. If you do not supply a file system type, the Web Start Flash installation utilities attempt to mount a UFS file. If the UFS mount fails, the Web Start Flash installation utilities attempt to mount an HSFS file system.

Examples:

To retrieve an archive from a local hard drive that is formatted as a UFS file system:

archive_location local_device c0t0d0so /archives/$HOST

To retrieve an archive from a local CD-ROM that has an HSFS file system:

archive_location local_device c0t0d0so /archives/usrarchive

Local File

You can retrieve an archive that you stored in the miniroot from which you booted the clone system as a local file. When you perform a custom Jumpstart installation, you boot the system from a CD-ROM or NFS-based miniroot. The installation software is loaded and run from this miniroot. Therefore, a Web Start Flash archive that you stored in the CD-ROM or NFS-based miniroot is accessible as a local file. Use the following syntax for the archive_location keyword.

archive_location local_file path/filename

In this command line:

path is the location of the archive. The path must be accessible to the system as a local file while the system is booted from the Solaris 8 Installation CD. The system cannot access /net when it is booted from the Solaris 8 Installation CD.
filename is the name of the Web Start Flash archive file.

Examples:

archive_location local_file /archives/usrarchive

Or:

archive_location local_file:/archives/usrarchive