D.3 Image-Safe Data Viewer and Editor (zisview and zisedit)

After booting a device from an imaging boot media (PXE, CD, DVD, or ZENworks partition), you can enter zisedit and zisview at the Linux bash prompt to edit and view the image-safe data for that device.

The following sections contain additional information:

D.3.1 Information Displayed by the Image-Safe Data Viewer

After booting a device from an imaging boot media, enter zisview at the Linux bash prompt to view the image-safe data for that device.

The image-safe data viewer (zisview) displays the following information about the device:

Table D-1 zisview Information

Category

Information

Image-safe Data

  • Version: The version number of the Novell ZENworks Linux Management Imaging Agent (novell-zislnx).

  • Just Imaged Flag: If this is set to False, the Imaging Agent reads data from Linux and writes it to the image-safe data store. If this is set to True, the Imaging Agent reads data from the image-safe data store and writes it to Linux.

  • Scripted Image Flag: If this option is set to True, the last imaging operation was a scripted image. If this option is set to False, the last imaging operation was not a scripted image.

  • Last Base Image: The last base image that was restored to the device.

  • Last Base Image Time: The time stamp of the last base image that was restored to the device.

  • Last Base Image Size: The size of the last base image that was restored to the device.

  • Last Base Image Address: The IP address of the last base image that was restored to the device.

  • Script Checksum: Displays the checksum value representing the last script run. The ZENworks Imaging Engine uses the checksum to prevent the same script from re-running on the device unless you specify in the ZENworks Control Center that you want to rerun the same script.

Device Identity Information

  • Zone GUID: The ZENworks Management Zone that contains the device, if it has been imported.

  • Device GUID: The Globally Unique Identifier of this computer’s device.

  • Device Index: The device identification number.

  • Win 9x Computer Name: The computer name for the device. 1

  • Windows Workgroup: The Microsoft network workgroup of the device. 1

  • Windows SID: The Windows Security ID of the device, a unique number that identifies this device in Windows. 1

Network Information

  • DHCP: Displays whether this device uses DHCP to obtain its IP address.

  • IP Address: Displays the static IP address that this device uses.

  • Gateway: Displays the gateway that this device uses.

  • Subnet Mask: Displays the subnet mask that this device uses.

  • DNS Servers: The number of DNS nameservers used for DNS name resolution.

  • DNS Server [0]: The IP address of the DNS server. This line is repeated, numbering from 0, 1, 2, 3, and so on for each DNS name server. For example, if the DNS Servers number is 3, there will be three of these lines, numbered from 0 through 2.

  • DNS Suffix: The DNS context of the device.

  • DNS Hostname: The DNS local hostname of the device. Use this field to change the computer name of Linux devices.

1 The Win 9x Computer Name, Windows Workgroup, and Windows SID device identity information fields are present for imaging compatibility with ZENworks Desktop Management. These fields are not relevant to Linux devices.

D.3.2 Using the Image-Safe Data Viewer

To use zisview, enter any of the following commands at the Linux bash prompt:

Table D-2 Data Viewer Commands

Command

Explanation

zisview

Displays all image-safe data.

zisview -z field

Displays information about a specific field or fields. field is one or more field names separated by a space. field is not case-sensitive.

All of the following are valid field names (the corresponding minimum names that can also be entered on the command line follow each field name in parenthesis):

  • JustImaged (J)
  • ScriptedImage (SC)
  • LastBaseImage (L)
  • Zone GUID (T)
  • Device GUID (ObjectDN)
  • Device Index (N)
  • Windows WorkGroup (WorkG)
  • Windows SID (SI)
  • WorkstationID (Works)
  • DHCP (DH)
  • IP (I)
  • Gateway (Gateway)
  • Mask (M)
  • DNSServerCount (DNSServerC)
  • DNSServer (DNSServer)
  • DNSSuffix (DNSSu)
  • DNSHostName (DNSH)

zisview -s

Creates a script that can be used to generate environment variables that contain all of the image-safe data fields.

zisview -h

Displays help for zisview.

D.3.3 Using the Image-Safe Data Editor

After booting a device from an imaging boot media, you can enter zisedit at the Linux bash prompt to change, clear, or remove information the image-safe data for that device.

To use zisedit, enter any of the following commands at the Linux bash prompt:

Table D-3 zisedit Commands

Command

Explanation

zisedit

Displays a screen showing all of the image-safe data fields. You can add or change any of the information in the fields.

zisedit field=new_information

You can change the information for one field using this syntax, where field is any valid field name and new_information is the information you want this field to contain. field is not case sensitive.

For example, enter zisedit Mask=255.255.252.0 to enter this information in the subnet mask field.

All of the following are valid field names (the corresponding minimum names that can also be entered on the command line are shown in parenthesis after each field name):

  • JustImaged (J)
  • ScriptedImage (SC)
  • LastBaseImage (L)
  • Zone GUID (T)
  • Device GUID (ObjectDN)
  • Device Index (N)
  • Windows WorkGroup (WorkG)
  • Windows SID (SI)
  • WorkstationID (Works)
  • DHCP (DH)
  • IP (I)
  • Gateway (Gateway)
  • Mask (M)
  • DNSServerCount (DNSServerC)
  • DNSServer1 (DNSServer1)
  • DNSSuffix (DNSSu)
  • DNSHostName (DNSH)
  • PXEWorkRevision (PXEWorkR)
  • PXEWorkObject (PXEWorkO)
  • PXETaskID (PXETaskI)
  • PXETaskState (PXETaskS)
  • PXETaskRetCode (PXETaskR)

zisedit -c

Clears all image-safe data fields.

zisedit -r

Removes the image-safe data store.

zisedit -h

Displays help for zisedit.