Updated May 30 2011

The iR110 Page

This page has been produced to help you with the installation and maintenance of the iR110 environment


1.  I am getting the following KGL error when I try to print to the iR110, what does it mean
2.  How do I check the SPC key to verify the current iR110 configuration?
3.  There are so many ways to shutdown or restart the SPC.  What are they?
4.  Why are commands like "stop a" and "halt" so dangerous?
5.  I'm confused.  My training course and manual tell me to use "Stop a" and "halt" freely
6.  What does the term Gracefull and Un-gracefull shutdown or reboot mean?
7.  I need to get the SPC to an OK prompt, what do I type?
8.  I need help with other # Prompt Commands like hostid and more key_data
9.  I need to adjust the TTYA Bit rate.  I need help.
10.  What are the popular iR110 configurations?
11.   Is an ASPI layer required with the iR110 scanner?
12. When I try to run Netscape (EOS) the performance is very slow.  I am also getting a Netscape Lock file error
13. What is a Lock file, how does it get created and what can I do to fix it?
14.  How do I delete the Netscape lock file?
15.  I need to see the Logs created on the SCS
16.  I want to backup or clone the iR110 Ultra 10 hard disk
17.  I need help installing the CoXist filter on the iR110
18.  I need help using the Tape Backup on the iR110
19.  I need some help with viewing and editing cron
20.  I'd like to trap print jobs on the SPC for troubleshooting purposes.  I need help
21.  I am getting the error /var partition is full.  What can I do?
22.  How can I start Netcape manually?
23.  I cannot boot the SCS, I need help getting the licence key or other files from the iR110 series hard disk before re-installing
24.  I'd like perform a Power On Self  Test (POST) Diagnostics.  Help
25.  My Host ID, Mac address or other NVRAM related thingies are messed up





1.  I am getting the following KGL error when I try to print to the iR110, what does it mean?

>>> KGL Error   : page: 1, image: ), after occurance 0 of 'KDKImageOptions'
>>> KGL Error   :  [11] - no image(s) found
>>> Job ABORTED by KGL Interpretor

We have seen this error in the field.  In our case, the error page printed only when print jobs were sent to the iR110
The problem was the iR110 SPC licence key was for a Duplicator only.  You cannot print to a Duplicator.

Another clue to this type of situation is the iR110 startup page.
A duplicator will not print any connectivity information on the startup page.
TCP/IP and IPX information will not be on the startup page.
 
 

2.  How do I check the SPC licence key to verify the current iR110 configuration?
Right click on the desktop
Right click on programs
Left click on file manager
Browse to /etc directory
Type K or browse to the key_data file
Double click on the key_data file
The file should open up in a simple text editor
In brackets is the key machine configuration.
Confirm you do not have just a Duplicator
 
 

3.  There are so many ways to shutdown or restart the SPC.  What are they?
 
 

Command
Used at what Prompt
Function
Details
stop a
Any
An un-gracefull shutdown to OK prompt (prom level).  Use in emergency situations only.  File corruption is likely.
Init 0 is preferred
boot cdrom -s
OK Prompt
Reboots the machine from the kernel on the installation CD in Super User mode  
boot -s
OK Prompt
Reboots the machine in run level s (Single User) mode  
boot
OK Prompt
Reboots the machine normally  
Halt
# Prompt
Halts all processes. Bypasses the RC0 scripts. We recommended to never use this command.
Other much less dangerous commands are available
Init 0 is preferred

 
Run Level (init x)
Used at what Prompt
Function
Details
0
# Prompt
Gracefull shutdown to OK prompt
Puts machine in PROM monitor level
1
# Prompt
  Administrative state (single-user mode with file systems mounted and user logins disabled)
2
# Prompt
  Multi-user level (with no resource shared)
3
# Prompt
  Multi-user level (with resource shared)
4
# Prompt
Not currently used
Not currently used
5
# Prompt
Gracefull shutdown and power off
Halt (and turn off Sun-4M and Sun-4u architectures)
6
# Prompt
Gracefull shutdown and reboot
Reboot to default run level
s
# Prompt
  Single-user mode with user logins disabled

 

4.  Why are commands like "stop a" and "halt" so dangerous?
The Unix file system uses hard disk(s) and RAM.
Syncronization between RAM and the hard disk is very important.
Using aggressive commands like "stop a" and "halt" will stop this synchronization which can easily lead to a corrupt file system.
 
 

5.  I'm confused.  The trainers, training material and EOS tell me to use "Stop a" and "halt" freely
This information is incorrect.  Sorry.
Any knowledgable Unix person will agree.
These commands should only be used in Emergency situations.
Use gracefull commands instead
 
 

6.  What does the term Gracefull and Un-gracefull shutdown or reboot mean?
When a machine or application is shut down or rebooted properly, it has the chance to clean up after itself.  This is considered a Gracefull shutdown or reboot
An aggressive shutdown or reboot of a machine or application does not allow it to clean up.  This is considered an Un-gracefull shutdown or reboot.

Commands like Init 0, Init 5, Init 6 are considered to be gracefull since they allow the operating system time to properly shutdown.
Commands like "Stop A", and "Halt" are considered un-gracefull for they do not care about the proper shutdown.
 
 

7.  I need to get the SPC to an OK prompt, what do I type?
 

My SPC is running the OCI interface and I can start a new terminal window.
Right click desktop
Right click programs
Left click command tool
Type su - and hit enter
Type the root password
Type init 0
My SPC is not running the OCI interface and I can start a new terminal window.
Right click desktop
Right click programs
Left click command tool
Type su - and hit enter
Type the root password
Type init 0
My SPC is not running the OCI interface and I cannot start a new terminal window.
This is a dangerous situation.  Your only hope may be 'STOP a'
Keep in mind that the Unix file system can be potentially corrupted
On the SPC keyboard, hold the keys "Stop" and "a" together
You should be at an ok prompt

 

8.  I need help with  # Prompt Commands like hostid and more key_data
 

# Prompt Commands
Function
hostid
Show the HOST ID from the host identification chip
more hosts
Displays the IP Address (Located in /etc)
more key_data
Displays the current SPC licence key (Located in /etc)
scskey
Use to enter a valid SPC licence key (located in /etc)
smshutdown
Stop the Service Manager for EOS hangs
smstartup
Starts Service Manager and restarts EOS

 

9.  I need to adjust the TTYA Bit rate.  I need help.
Use Init 0 to get a gracefull OK prompt
Type obdiag
Type printenv to see current TTYA settings.
Type setenv ttya-mode 38400,8,n,1,-
Type printenv to confirm if changes took place
 
 

10.  What are the popular iR110 configurations?
 

Configuration
Features
Duplicator
Scanner and Print engine only.  Does not accept network print jobs  Upgradable to the Duplicator-Printer and Deluxe Duplicator Printer through software upgrades
Printer
Print engine only.  Accepts PS3, PCL5, PDF and LP print jobs
Duplicator-Printer
Combines Duplicator and Printer options together
Deluxe Duplicator-Printer
Duplicator-Printer with enhanced capabilities

Update
Newer versions of System Software have these 2 configurations
System with printing functionality.
System with scanning and printing functionality.

11.  Is an ASPI layer required with the iR110 scanner?
Yes, ASPI32.exe must be installed.   Click here for more ASPI information
 
 

12.  When I try to run Netscape (EOS) the performance is very slow.  I am also getting a Netscape Lock file error.

You are probably getting an error similar to this one

Netscape has detected a /xx/xx/xx .netscape/lock file
This may indicate that another user is running netscape using your /xx/xx/xx .netscape files.
It appears to be running on xx under process-ID xxx
You may continue to use Netscape, but you will be unable to use the disk cache, global history or your personal certificates
Otherwise, you may choose cancel, make sure that you are not running another netscape navigator, delete the /xx/xx/xx .netscape/lock file and restart Netscape
This error is quite common and it is a perfect example of the misuse of the "Stop A" or "Halt" command
You must take note of the process ID (PID) and use it to delete what is called a lock file
 
 

13.  What is a Netscape Lock file and how does it get created?
Lets say a user named ISGSP starts Netscape to use EOS
Netscape spawns a process which is assigned a process ID (PID)
This (as well as all other processes) require resources.
Netscape requires access to the file system for caching, history...
It will create a lock file stored in the home/.netscape directory of the user ISGSP
The Lock file is identified by an IP address and the Process ID (PID)
The lock file identifies what part of the file system is locked and inaccessable for future instances of the process
If for example ISGSP starts a second Netscape process, a warning indicating caching, history will not be available.
The warning error will actually point to the location of the lock file.  Write it down!!!!
You can still run this second instance of Netscape but without access to caching and history it will run very slowly.

Normally, if Netscape is shut down gracefully, the lock file is also deleted.
The lock file will however remain in non-gracefull shutdowns  (Halt, Stop A, Power off...)

If a lock file error occurs, it is necessary to find and delete the lock file
 
 

14.  How do I delete the Netscape lock file?
Close all instances of Netscape.
Start a new terminal Window (Right click desktop, Right click programs, Left click command tool)
Do not use SU to switch user.  Service is the owner of the Netscape lock.  You should still be logged in as "service".  You can type "who" to confirm
Type the following;
rm $HOME/.netscape/lock
This command deletes any lock file located in the home/.netscape directory of the current user.
 
 

15.  I need to see the Logs created on the SCS
A utility called capture_logs is available to create a tar.z compressed file of many logs on the SCS
The only file you need to obtain is loginfo.tar.Z
Once created, you can connect your laptop and use an internet browser to get the file

Here is a quick Log file creation and transfer method

Creating the Log file
1.  On the SCS, open a command or shell tool
2.  Type su - and type the root password
3.  Type  capture_logs
4.  You will be prompted for a directory name.  Use logfile for simplicity
5.  After about 15 seconds, the log file will be ready.  It is normal for several errors as it processes

Transferring the Log file
1.  Connect your laptop to the iR110 so you can ping the SCS.
2.  Start an internet browser
3.  Type ftp://root@xx.xx.xx.xx         xx.xx.xx.xx is the IP of the SCS
4.  You will be prompted to enter the root password
5.  Browse for the folder /var/logfile
6.  Double click on loginfo.tar.Z and save the file on your computer (2.5MB)

Opening and reading the Log file
1.  Use Winzip or equivalent to decompress the file
2.  Use Notepad or equivalent to read the file
 
 

<>16.  I want to backup or clone the iR110 Series Ultra 10 hard Disk
Click here for information on how to backup using an identical hard disk
<>Click here for information on how to to backup using DD over NFS
Click here for information on how to backup using UFSDUMP/UFSRESTORE over NFS 
 

17.  I need help installing the CoXist filter on the iR110
(This is currently a rough collection of my notes.  I hope to clean it up soon)

1.  Obtain the correct version of coXist filter and documentation.
2.  Copy *.tar.z downloadables to floppy and use SCS file manager to mount floppy, copy files to /tmp, uncompress and extract install.cus
3.  Install.cus instructions are provided in coXist 3.0 PDF.  Main undocumented issue is licencing the filter.  Program is filter.xrx.v1 enter correct password for host ID
4.  Vi commands are diffuculy for any newcomer.  Recommend using setenv EDITOR textedit and much simpler editing tool.
5.  Run launcher.prt
6.  Creat print queue xrx_jobs, Total job size bytes checked, Accepting Releasing.  No entries to Printer type, Printer were done.  Normal executable
7.  Create another queue Name is coXist  Process Q  Change path to executable to /opt/HDcustom/7025/bin/filter.xrx
8.  Three filters after completion

coXist  with filter
XRX_jobs with our default filter
default_IR110 (native)
Jobs leave digipath box, hit first queue, xrx jobs are filtered and sent to XRX_JOBS for printing to our queue  Other wise non Xerox jobs are sent to normal queue for printing
(/usr/tmp  xrx.log can be used to check for errors)
 
 

18.  I need help using the Tape Backup on the iR110
Click here for help with the iR110 Tape Backup


19.  I need some help with viewing and editing cron
"cron
executes commands at specified dates and times. Regularly scheduled commands can be specified according to instructions found in crontab files in the directory /var/spool/cron/crontabs. Users can submit their own crontab file via the crontab(1) command. Commands that are to be executed only once can be submitted using the at(1) command."

Here is a quick way to view/edit the root crontab entry
su to root
#sh
#EDITOR=vi   (If vi scares you try EDITOR=textedit)
#export EDITOR
#crontab -e
Do your edits and save
File is saved (you cannot edit it directly) to /var/spool/cron/crontabs/root


20.  I'd like to trap print jobs on the SPC for troubleshooting purposes.  I need help
Trapping a print job is pretty easy.  All you have to do is toggle the Queue releasing state to non-releasing and browse the SCS for a particular file
If you have more than one Queue, you should start at the top Queue first
A print job waiting in a Queue will have 3 files.
These files start with the letters cf, pf and df
They reside in /var/spool/kodak_print/Kdefault_iR110
The df file is linked to a hch or kgl file
Here is a ls of the
/var/spool/kodak_print/Kdefault_iR110 directory

BenCourt# ls -la
total 18
drwxrwsrwx    2 daemon   daemon       512 Aug 29 10:22 ./
drwxrws---    3 daemon   daemon       512 Jul 19 09:57 ../
-rw-rw---x    1 root     daemon         5 Aug 29 10:22 .seq*
-rw-rw----    1 daemon   daemon       202 Aug 29 10:22 cfA0013BenCourt
lrwxrwxrwx    1 root     daemon        51 Aug 29 10:22 dfA0013BenCourt -> /var/spool/kodak_resources/rsrc_data/hch.4701.22544
-rw-rw-r--    1 root     daemon       897 Aug 29 10:16 ipslog
-rwxrw----    1 root     daemon        21 Aug 29 10:16 lock*
-rwxrwxrwx    1 root     daemon       749 Aug 29 10:22 pfA0013BenCourt*
-rw-rw-r--    1 root     daemon        37 Aug 29 10:16 status

You may have to use the date of the file to determine which is the one that you want
You can use FTP to transfer the file you require to your laptop.


21.  I am getting the error /var partition is full.  What can I do?
Files may sometimes be "orphaned" in /var/spool/kodak_resources/rsrc_data and/or /var/spool/kodak_resources/rip_data.
This can occur
if there is a failure or reset sometime during the spooling/printing process.
These may be complete or partiial files.

Files that have been"orphaned" in rip_data, should be removed automatically after they have been there more than 5 days (Rel 4.x)

Release 5.x will provide cleanup of invalid files in rsrc_data.

Keep in mind that whenever there are jobs in the server queues (including "hold" queue) there will be valid files in rsrc_data that are the actual data files.
When manually removing files from rsrc_data, if data files for queued jobs are deleted, those jobs will not be able to print.

I was recently told to try this to provide some clean up
Reboot the SCS 2 times
The first reboot will automatically move up any temp files from /var to a simgle temporary file
The second reboot will repeat this same process and thus overwrite the temporary file
I have not yet had the chance to verify the theory of this information to make it more accurate
I did find this though
"Note that `/tmp' directory is always cleared by a "reboot" and is automatically cleaned of day-old files. `/var/tmp' is automatically cleaned of week-old files."
I  borrowed it from http://www.umanitoba.ca/campus/acn/support/disk.html


22.  How can I start Netcape manually on the SCS to connect to EOS?
CD to /opt/netscape405 or maybe /opt/netscape
Start Netscape with ./netscape
Click your way through the required plugins and type 192.168.1.2 (or equivalent) in the URL window


23.  I cannot boot the SCS, I need help getting the licence key or other files from the iR110 series hard disk before re-installing

Perhaps the power went out, someone unplugged the SCS or your dog ate the cable.
Whatever the case, if you cannot boot the SCS from the hard disk the chances are good that the licence key is still on the hard disk
Here's a step by step procedure to mount the hard disk and get the licence key before resorting to a re-install
This assumes of course that the hard disk controller and hard disk are still in good shape.
Get your iR110/150 OS CDROM or Sun Solaris for Spark 8/9/10 CDROM 1 ready
init 0    (If necessary to get the machine to the ok prompt)
Pop the CDROM into the drive
boot cdrom -s      (Wait to 2-5 minutes until the # prompt)
#mount -r /dev/dsk/c0t0d0s0 /mnt      (Mounts the iR110's hard disk's root partition read only under /mnt.    BTW the V240 is /dev/dsk/c1t0d0s0)
#cat /mnt/etc/key_data                        (This outputs the file /mnt/etc/key_data to screen)

If you need to get other files on the root partition simply cd /mnt
Do an ls and you will see the root partition.  Poke around as required

When you are finished, do this to unmount the hard disk
#cd /
#umount /mnt                                      ( Unmounts the /dev/dsk/c0t0d0s0 from /mnt)
#init 6                                                 (Reboots the SCS) 

If you need to see the var or document library partitions use these
mount -r /dev/dsk/c0t0d0s3 /mnt      (Mounts the var partition under /mnt)
mount -r /dev/dsk/c0t0d0s4 /mnt      (Mounts Document Library partition under /mnt)

If you want to mount more than one partition at the same time, you will need to make seperate mount points
Lets make three mount points and mount all three partitions
#cd /mnt
#mkdir root
#mkdir var
#mkdir doclib

Now lets mount all three
#mount -r /dev/dsk/c0t0d0s0 /mnt/root
#mount -r /dev/dsk/c0t0d0s3 /mnt/var
#mount -r /dev/dsk/c0t0d0s4 /mnt/doclib

Now just CD to whichever mount point you want and have fun
Dont forget to umount once you are done


24.  I'd like perform a Power On Self  Test (POST) Diagnostics.  Help
You may want to do this to perform advanced on board diagnostics
The diagnostic information will only output to the serial port  :-(
I connected as follows
Windows Box
Putty or Hyperterminal - Com 1 N,8,1 Flow control did not matter
I used a null modem cable with a few gender changers to the Serial Port A (DB 25) on the Ultra 10.  Serial Port B did not work by default
The simplest way to start the POST is to boot the machine holding Stop and D
The screen will be blank whilst the test is underway
Your Terminal session should fill with the test details
Read the Service Manual for further detail
http://docs.sun.com/app/docs/doc/805-7764-12


25.  My Host ID, Mac address or other NVRAM related thingies are messed up
Try this out http://www.squirrel.com/squirrel/sun-nvram-hostid.faq.html


Dont forget ... having fun is mandatory


Home    Back

If you find an error or wish to comment please let me know.