Migrate Server Tools - Release Notes

Migrate Server Tools are a set of scripts and other tools to assist in automating the migration of print
queues from an old server to a new server or to upgrade the print queues on a server.
Disclaimer
20! "op#right $ewlett-%ac&ard 'evelopment "ompan#( ).%.
Reproduction( adaptation( or translation without prior written permission is prohi*ited( e+cept as allowed
under the cop#right laws. The information contained herein is su*,ect to change without notice. The onl#
warranties for $% products and services are set forth in the e+press warrant# statements accompan#ing
such products and services. Nothing herein should *e construed as constituting an additional warrant#.
$% shall not *e lia*le for technical or editorial errors or omissions contained herein.
Disclaimer of Warranty and Support
T$- S./T01R- 1N' 1N2 R-)1T-' '."3M-NT1T4.N 1R- %R.54'-' 61S 4S6( 04T$.3T
01RR1NT2 .R S3%%.RT ./ 1N2 74N'. T$- -NT4R- R4S7 1S T. T$- 3S-( R-S3)TS 1N'
%-R/.RM1N"- ./ T$- S./T01R- 1N' '."3M-NT1T4.N 1R- 1SS3M-' 82 2.3 1N' T$.S-
T. 0$.M 2.3 %R.54'- T$- S./T01R- 1N' '."3M-NT1T4.N. $-0)-TT-%1"71R'
".M%1N2( $-0)-TT-%1"71R' '-5-).%M-NT ".M%1N2( 1N' T$-4R 1//4)41T-S 1N'
S38S4'41R41R4-S $-R-82 S%-"4/4"1))2 '4S")14M 1N2 1N' 1)) 01RR1NT4-S( -9%R-SS(
4M%)4-' .R ST1T3T.R2( 4N")3'4N: 83T N.T )4M4T-' T. T$- 4M%)4-' 01RR1NT4-S ./
M-R"$1NT184)4T2( /4TN-SS /.R 1 %1RT4"3)1R %3R%.S-( T4T)- 1N' N.N4N/R4N:-M-NT.
Limitation of Liability
4N N. -5-NT S$1)) $-0)-TT-%1"71R' ".M%1N2( $-0)-TT-%1"71R' '-5-).%M-NT
".M%1N2 .R T$-4R 1//4)41T-S 1N' S38S4'41R41R4-S 8- )418)- /.R 1N2 ")14M( '1M1:-S
;'4R-"T( 4N'4R-"T( 4N"4'-NT1)( %3N4T45-( S%-"41) .R .T$-R '1M1:-S( 4N")3'4N:
04T$.3T )4M4T1T4.N( '1M1:-S /.R ).SS ./ 83S4N-SS %R./4TS( 83S4N-SS 4NT-RR3%T4.N(
).SS ./ 83S4N-SS 4N/.RM1T4.N( .R .T$-R %-"3N41R2 ).SS 1N' T$- )47-< .R .T$-R
)4184)4T2 0$1TS.-5-R( 0$-T$-R 4N 1N 1"T4.N ./ ".NTR1"T( T.RT .R .T$-R04S-(
1R4S4N: /R.M( .3T ./ .R 4N ".NN-"T4.N 04T$ T$- S./T01R- .R '."3M-NT1T4.N( -5-N
4/ 1'54S-' ./ T$- %.SS484)4T2 ./ S3"$ ")14M( '1M1:-S .R .T$-R )4184)4T2.
Acknowledgements
Microsoft( 0indows( 0indows 9%( 0indows 5ista( 0indows=( 0indows >( 0indows Server 200?(
0indows Sever 200?R2( 0indows Server 200>( 0indows Server 200>R2( 0indows Server 202 and
0indows Server 202R2 are 3.S. registered trademar&s of Microsoft "orporation in the 3nited States
and@or other countries.
Version
Migrate Server Tools version 2.0.0!.
1
Release Notes version !( Aul# 20!
Supersedes
5ersion $istor# of Migrate Server Tools
UpdateNow
Version
Release
Date
New Features Reuired
U!D "ersions
2.0.0!. Aul#
20!
3pdated driver mapping to include latest 3%'
releases
2.0=.=.= Aul#
202
4mproved $andling of -uropean "haracters
2.0B.. Ma#
202
1dded saving and restoring 'iscretionar# 1ccess
"ontrol )ists ;'1")s<
1dded a*ilit# to configure color and duple+
settings
1dded output of duple+ hardware availa*le
1dded support for failover cluster virtual nodes
Support for ?2 and C! *it source and target
servers
..02. Nov
20
4nitial Release
Description
Migrate Server Tools are a set of scripts and other tools to assist in automating the migration of print
queues from an old server to a new server or to upgrade the print queues on a server. This utilit# will
create onl# 3%' traditional mode queues.
Support !olicy
This tool is not eligi*le for $% Support. 8efore using this tool( please review the sections 6'isclaimer of
0arrant# and Support6 and 6)imitation of )ia*ilit#6 in this document. /eed*ac& a*out the tool
;enhancement requests and *ug reports< can *e sent via email to updDpar&Ehp.com.
Update recommendation
Recommended#Ad"ised F 4ncludes new enhancements( features( and@or minor *ug fi+es. $%
recommends all customers to update.
2
!roduct $odels
Migrate Server Tools are compati*le with the $% 3niversal %rint 'river ;3%'< and $% model-specific
printer drivers.
De"ices Supported
Refer to the specifications ta* at www.hp.com@go@upd for a list of devices which are supported *# the $%
3%'.
%perating Systems
Microsoft 0indows 9% S%?GG
Microsoft 0indows 5istaG
Microsoft 0indows =
Microsoft 0indows > @ >.
Microsoft 0indows Server 200? S%2 @ 200?R2 S%2G
Microsoft 0indows Server 200> @ 200>R2
Microsoft 0indows Server 202 @ 202R2
GMicrosoft has ended mainstream support for this operating s#stem.
GGMicrosoft has ended e+tended support for this operating s#stem.
Languages
-nglish ;4nternational<
&n'ancements#Features
4mproved $andling of -uropean "haracters
Fi(es#Fi(es )istory
See the Supersedes section of this document.
*nstallation
"op# the pac&age files to the server local hard drive.
N.T-H 'o not tr# to run Migrate-Server.*at directl# from the shared folder( e.g. IIJserverKIJshare-
nameKLIMigrate-Server.*at. This will generate file not found errors.
'ownload the Microsoft setprinter.e+e utilit# separatel#( and cop# to the folder that contains the Migrate
Server tool set. This utilit# is part of the Microsoft Server Resource 7it tools( and can *e downloaded atH
httpH@@www.microsoft.com@download@en@details.asp+MidN=CB=.
3
+urrent Limitations
This release has certain limitations that ma# *e addressed in future releases.
No support for printer pooling
'oes not handle creating printers using in-*o+ drivers
0ill onl# create T"%@4% ports. )%R ports and printers pointing to )%T or ".M ports will not *e
created.
Usage
4n a t#pical migration( there will *e two serversH The old or source server( and the new or target server. 4n
the case of an upgrade( the source and target server can *e the same server.
There will also need to *e an editing wor&station which has Microsoft -+cel or equivalent installed for
editing the .csv files that are created. The editing wor&station can *e a standalone wor&station or the
source or target server.
3sing the tool from a shared networ& drive
!reparing t'e Dri"er Store
Ma&e a list of all the drivers currentl# in use.
o 3se the Microsoft %rint Management console
'etermine if those drivers are supported *# the target s#stem operating s#stem ;refer to
manufacturerOs we* site<
'etermine if these drivers are availa*le in *oth ?2 and C! *it versions.
'ownload and catalog the new drivers that are needed.
o 'river name
o %ath to inf file
o ?2 or C! *it
'ecide what new driver;s< will replace the currentl# used driver;s<
Save this information as a comma separated value ;"S5< file named DriverMapping.csv that
has the following informationH
o .ld 'river Name
o New 'river Name
4
o %ath to new driver C! *it .inf file
o %ath to new driver ?2 *it .inf file
Refer to 1ppendi+ 1 for information a*out the required format for the driver store file.
Using t'e $igrate Ser"er ,oolset
Step -. /optional0 Set Failo"er +luster "irtual node name1
The default source and target server is ph#sical node. 0hen the source and@or target server is a failover
cluster virtual node( this option must *e used to specif# the name of the virtual node *efore performing the
following steps
Step 2. 3et t'e print ueue information from t'e source 4old5 ser"er
)og on to the source ;old< server.
"op# the tools set to the source server( or map the shared folder that contains the tools as a
networ& drive.
N.T-H 'o not tr# to run Migrate-Server.bat directl# from the shared folder( e.g.
\\<server>\<share-name>$\Migrate-Server.bat. This will generate file not found errors.
'ou*le-clic& the file Migrate-Server.bat
Select optionH Gather information from source (old server.
This operation will enumerate all the printers on the server( and save information a*out those
printers into a file named <computer name>.csv.
"op# all the files in the I1rchive folder on the source server to the folder on the Target server
that contains the migrate-server tools files.
Step 6. Validate t'e dri"er store1
)og on to the target server as an administrator.
"op# the tools set to the source server( or map the shared folder that contains the tools as a
networ& drive.
5
4f necessar#( cop# the driver store information file( DriverMapping.csv to the target server.
'ou*le-clic& the file Migrate-Server.bat
Select optionH !alidate Driver Store. The tool will perform the following *asic chec&sH
o 5erif# that the inf files listed in columns " and ' e+ist.
o 5erif# that the driver name listed in column 8 e+ists in the .inf file.
N.T-H The tool does not verif# that the driver is compati*le with the target operating s#stem.
Step 7. Load dri"er mappings from dri"er store
Select optionH "oad driver mappings from driver store.
This step will automaticall# load the new driver mapping choices into the <computer
name>.csv file. Refer to 1ppendi+ 1 for information a*out the required format for the driver
store file.
Step 8. View printer build information
This step is optional. This step is used to verif# that the new driver information has *een filled in correctl#.
Select optionH !ie# printer build information
5erif# that the new driver information has *een filled in correctl#.
Step 8a /optional0. &diting t'e printer build information
4f it is necessar# to add@delete printers or change the configuration of the printers to *e created( cop# the
Jserver nameK.csv file to a s#stem that has Microsoft -+cel ;or another .csv editor< installed.
Refer to Appendi( 9 for information a*out how to edit this file( and the meaning of the columns.
8e aware of the following when adding( sorting or deleting rows in the .csv fileH
'o not add or delete columns.
'o not delete the header row.
'o not change the order of the columns.
N.T-H Missing or reordered columns will cause the *uild process script to fail.
3se the following sorting guidelines when editing the .csv file
Sort the rows *# %rinter Name to ma&e the following steps easier.
o 'elete the rows for printers that no longer e+ist.
o 'elete the rows for printers that are out of scope for the migration.
Sort the rows *# "urrent 'river to ma&e the following steps easier.
o 'elete the rows for printers that do not have a supported driver availa*le.
o 1dd in the name and inf path information for an# additional new drivers into the New
'river and .ptions columns.
Sort the rows *# Source Name.
o /ind ever# printer that is N.T using the $% 3%' and is using a paper source other
than the default paper source. These printers need to *e manuall# configured after
the *uild process.
Sort the rows *# /orm Name.
o /ind ever# printer that is N.T using the $% 3%' and is using a form name other than
the region default of letter or 1!. These printers need to *e manuall# configured after
the *uild process.
Sort the rows *# Media Name.
6
o /ind ever# printer that is N.T using the $% 3%'( and is using a media name other
than the unspecified or 1uto. These printers need to *e manuall# configured after the
*uild process.
/or more information a*out the columns and their meanings( refer to 1ppendi+ 1.
Step :. ,est t'e setup to "erify e"eryt'ing is setup correctly
Select optionH $est setup
This operation willH
o Ma&e sure that the path to the .inf file is correct.
o Ma&e sure that the driver name e+ists in the .inf
Select optionH !ie# test or build result
Search for the phrase P-RR.RQ
/i+ the errors( and re-run optionH $est setup.
Step ;. !reload dri"ers and create test printers
This step is optional( *ut is recommended to verif# that printers can *e created correctl#. 4n some cases it
the creation of printers will *e faster if all the necessar# drivers are pre-installed.
!re<configuring U!D wit' t'e Dri"er +onfiguration Utility 4D+U5
4f it is desired to pre-configure the 3%' printers on the target server using '"3( follow these steps *efore
running the option to preload drivers and create test printers.
"reate a .cfm file with the desired settings using the 'river "onfiguration 3tilit# ;'"3<(
following the instructions in the 3%' S#stem 1dministratorOs guide.
Manuall# create test printers using the .cfm file ,ust created( following the instructions in the
3%' S#stem 1dministratorOs :uide.
5erif# that the pre-configured settings are correct.
*nstalling dri"ers wit' default settings
Select optionH %reload drivers and create test printers. This step will create a list of all the
unique drivers referenced in the <computer name>.csv file.
4f desired( #ou can edit the information for the test printers. This file is named <source
name>-test-printrs.csv. 2ou ma# want to change the port information to a device that is
ph#sicall# closer to the *uild location.
-nter 2 to continue to *uild the test printers( or an# other &e# to cancel. This step will not
over-write an# previousl# installed and pre-configured drivers.
0hen the previous step is complete( select optionH !ie# test or build results
Search for the phrase P-RR.RQ
%rint a test page to verif# *asic operation.
.nce the testing is done( #ou can delete the test printers if desired. 'o N.T delete the
drivers.
Step =. *nstall t'e additional 76 or ;8 bit dri"ers
Select optionH &nstall additional '( or )* bit drivers. This step will create a list of all the unique
drivers referenced in the <source server>.csv file.
-nter 2 to continue to install the drivers( or an# other &e# to cancel.
0hen the previous step is complete( select optionH !ie# test or build results
Search for the phrase P-RR.RQ
7
Step >. +reate printers on target
Select optionH +reate printers on target server
Step ?. Verify t'e print ueue building 'as succeeded
Select optionH !ie# test or build results
Search the log file for the word P-RR.RQ
/i+ the errors( and re-run option to +reate printers on target server.
o %rinters that alread# e+ist will *e s&ipped.
Step 2-. Verify t'at t'e printer configuration is correct@ and auto configure 'as succeeded for all
printers
Select optionH 5iew target server configuration
4f desired #ou can cop# the file <target name>-target.csv to a s#stem that has Microsoft -+cel
installed in order to open it( to sort the entries( search( etc.
/or each printer( verif# that the specified options such as %aper Source and Media T#pe are
as specified in the <computer name>.csv file.
5erif# that there is a model name displa#ed for ever# printer that is has 3%' listed as the
+urrent Driver. 4f the model name is not thereH
o 3se the ping command to verif# that the printer is turned on and connected to the
networ&.
o 5erif# that SNM% v2 :-T traffic is ena*led on the networ& and the device.
*nformation and &rror $essages
$igrateASer"er1bat messages
,--.-/ %rinter information file 011110 is missing
Most li&el# cause is that either step was not run( or the file generated *# step was not copied
over to the editing computer( or not t#ped in correctl#
,--.-/ 2ile 01111.vbs0 is missing
,--.-/ 2ile 01111.e3e0 is missing
Necessar# components of the tool pac&age are missing. 5erif# that the tool pac&age was
e+tracted and copied correctl#.
ValidateDri"erStore1"bs messages
,--.-/ .pen file failed4 1111
/ailed to open the driver store file( DriverMapping.csv( or the .inf file referenced in the
DriverMapping.vbs file.
,--.-/ )* bit inf file/ 011110 is missing 0
,--.-/ '( bit inf file/ 011110 is missing 0
The .inf file specified in columns " or ' in the 'riverMapping.csv file is missing
,--.-/ 511110 does not contain driver name 011116
The .inf file specified in columns " and@or ' in the 'riverMapping.csv file does not contain the
driver name specified in column 8. %erhaps the .inf file is not the correct one for this printer.
8
LoadFromDri"erStore1"bs messages
,--.-/ .pen file failed4 1111
,--.-/ 07nable to open file 011110
/ailed to open either the driver store file( DriverMapping.csv( or one of the .inf file referenced in
the DriverMapping.vbs file.
+reate,est!rinters1"bs messages
,--.-/ .pen file failed4 1111
/ailed to open the printer list file( <server name>.csv.
*nstallFrom+SV1"bs messages
,--.-/ ,rror creating log file <log file name>
5erif# that the user has write access to the folder containing tools.
,--.-/ <printer list>.csv -o#/ 11 %rinter/ 1111 - %rinter name and &% address are re8uired
parameters
5erif# that the cells for %rinter Name and 4% address are filled in for ever# row in the Jprinter
listK.csv file
%rinter 1111 alread9 e3ists
4nformation message. .nce a printer is created( a cop# will not *e created.
,--.-/ <printer list>.csv -o#/ 11 Driver name and inf path are re8uired parameters0
,--.-/ <printer list>.csv -o#/ 11 %rinter/ 1111 - Driver name and inf path are re8uired
parameters0
5erif# that the cells for %rinter Name and 4% address are filled in for ever# row in the Jprinter
listK.csv file
-RR.RH 4nf file path is incorrect( or file is missing DDDD
-RR.RH 4nf file does not contain driver nameH DDDD
5erif# that the .inf file specified does e+ist( and that it is the correct .inf file for the driver name
specified.
,--.-/ +annot open document <printer list>.csv
5erif# that the Jprinter listK.csv file specified is correct( and that the file e+ists.
,--.-/ 2ile ,num%rinters'.e3e is missing
Tr#ing to run the migrate-server.*at file from a networ& folder. 2ou need to either cop# the files to
the local dis&( or share the remote folder and map it as a local drive.
Necessar# components of the tool pac&age are missing. 5erif# that the tool pac&age was
e+tracted and copied correctl#.
,--.-/ :dd +omments %rinter/ 1111 2ailed.
,--.-/ Share %rinter/ 1111 2ailed.
,--.-/ %ublish %rinter/ 1111 2ailed.
The printui.dll commands used to perform these operations did not complete successfull#.
o Run option !( test mode.
o "op# the printui.dll commands from the log file.
9
o .pen a command prompt window with 1dministrator privileges
o %aste these commands into the command prompt window to see if the# will e+ecute
outside the conte+t of the script.
o 5erif# that the printui.dll command s#nta+ is correct.
o Ma&e the changes manuall#.
,--.-/ Setprinter.e3e is missing4 +onfigureDevMode failed0
The file setprinter.e+e is part of the Microsoft 200? resource &it( and must *e downloaded
separatel#.
,--.-/ +reate port/ 1111 failed
)i&el# causes are the account *eing used does not have the permissions to create T"%@4% ports(
or the hostname or 4% address specified is invalid.
,--.-/ +reate %rinter/ 1111 2ailed.
,--.-/ +reate%rinter,3 2ailed/ 1111
)i&el# causes are the information such as printer name( location( comments( etc is invalid( or the
driver specified is incorrect or corrupt.
,--.-/ +reate.b;ect #script.shell 2ailed/
,--.-/< 7nable to create file s9stem ob;ect
,--.-/( 7nable to create file s9stem ob;ect
4nternal script errors
Bnown *ssues
Spaces are not allowed in file names or computer names.
The &nstall additional '( and )* bit drivers step does not chec& to see if the driver is installed
*efore performing the installation.
Freuently Asked Cuestions
Test printers are not being created and/or alternate drivers are not being installed
The most li&el# cause is that the new driver and inf information fields in the JservernameK.csv files are
empt#. Tr# running option 2 again.
I am getting errors like 0x6ba or 0x5 when I run EnumPrinters3 or when tr!ing to create ports"
These are error codes that are returned *# the various Microsoft s#stem calls used in the tool. /or a
complete listing of s#stem error codes( please refer to the following Microsoft article.
httpH@@msdn.microsoft.com@en-us@li*rar#@msC>?>;vNvs.>B<.asp+
Some of the more common errors areH
-rror BH 1ccess is denied. This ma# mean that the login account that #ou are using on the client
does not have access rights on the server. This t#picall# occurs when either #ou have logged in
on the client as a non-admin( or the client or server are not on the same domain.
10
-rror 0+C*aH The R%" server is unavaila*le. Machine to machine communications are done via
Remote %rocedure "alls ;R%"<. There is a service on the target s#stem that receives these calls
from the networ& and processes them. 4f the server is *us#( R%" calls ma# fail. This error ma#
also occur if the networ& is *us#.
I am getting #The publisher could not be veri$ied" %re !ou sure !ou want to run this so$tware&'
This error t#picall# occurs when running the tools from a shared networ& drive( and is due to a securit#
polic# that does not allow an .e+e to *e run from a networ& drive. The solution is to cop# the tool files to a
local dis&.
11
Appendi( A. Dri"er store +SV file format
The driver store file is a "S5 ;comma separated value< format file that is used to tell the tool what driver
what new driver #ou want to use to replace a current old driver.
4f the old and new driver names are the same ;upgrade<( then cop# the name of the driver
from column 1 to column 8.
The path to the .inf file must *e the full path starting with the drive letter.
The inf file specified must *e the correct inf file for the server architecture.
"olumn 'ata Notes
1 .ld driver name 1ll entries must *e unique. 'uplicates will *e ignored
8 New driver name 4nf files t#picall# contain multiple driver names or device
models. This is the e3act name of the driver or model
as copied from the .inf file.
" %ath to C! *it driver .inf file This is an a*solute path
' %ath to ?2 *it driver .inf file This is an a*solute path
-+ample 'riverMapping.csv file for upgrading previous versions of 3%' to 3%' B.?.
The e+ample file 'riverMapping.csv( which is provided in the pac&age( contains mapping for various
versions of 3%' to 3%' B.R.0. The data in this e+ample file assumes that 3%' B.R.0 was e+tracted to
the default locations on "HI$% 3niversal %rint 'river. 4f 3%' was e+tracted to another location( the
'riverMapping.csv file will need to *e edited to reflect the current location.
12
Appendi( 9. !rinter information file format and editing instructions
-num%rinters? lists out the following information for each printer on the computer( if the information is
availa*leH
"olumn Notes
"urrent 'river 'river currentl# used with this print queue
5ersion 5ersion num*er( or 0.0.0.0 if no version information is availa*le
New 'river Name /or driver upgrades( specifies the name of the upgrade driver
4nf@.ptions 'river inf file path and name( or install.e+e command line options
%rinter Name The name of the print queue
'evice Model 'ispla#s the actual device model information if availa*le
4% 1ddress 4% address or hostname of the device( or PpooledQ if printer pooling is
ena*led.
%ort Name
)ocation
"omment
Share Name
8uild S /uture e+tensi*ilit#
%rint %rocessor
1ttri*utes 1ll attri*utes in he+adecimal format. See chart *elow for e+planation
Shared %rinter is shared
%u*lished %rinter is pu*lished in 1ctive 'irector#
8i-'i Spooler *idi support is ena*led
"olor 0 N un&nown( N monochrome( 2 N color
"opies
'efault Source See 0in:'4.h for details. 5alues over 2BC are driver specific
Source Name 'river@vendor specific paper source name.
'uple+ 0 N un&nown( N simple+( 2 N duple+
%aper SiTe
/orm Name
Media T#pe See 0in:'4.rtf for details. 5alues over 2BC are driver specific
Media Name 'river@vendor specific media t#pe name.
'uple+ $0 3n&nown;2<(
'uple+ $ardware;? or !<(
Simple+;B<
Manual duple+( or no duple+;C!00<
.rientation N portrait( 2 N landscape
Uualit# %rint qualit# in '%4
Spare ( 2 /uture e+tensi*ilit#
Securit# 'escriptor 'iscretionar# 1ccess "ontrol )ist ;securit#< information
Serial S /uture e+tensi*ilit#
13
1ttri*ute 5alue $e+ Meaning
U3-3-' 000 4f set( the printer spools and starts printing after the last page is
spooled. 4f not set and %R4NT-RD1TTR483T-D'4R-"T is not
set( the printer spools and prints while spooling.
'4R-"T 0002 Ao* is sent directl# to the printer ;it is not spooled<.
'-/13)T 000! 'efault printer
S$1R-' 000> %rinter is shared.
N-T0.R7 000 %rinter is a networ& printer connection.
$4''-N 0020 Reserved.
)."1) 00!0 %rinter is a local printer.
'-5U 00>0 4f set( 'evUuer#%rint is called. 'evUuer#%rint ma# fail if the
document and printer setups do not match. Setting this flag
causes mismatched documents to *e held in the queue.
7--% %R4NT-'
A.8S
000 4f set( ,o*s are &ept after the# are printed. 4f unset( ,o*s are
deleted.
'. ".M%)-T-
/4RST
0200 4f set and printer is set for print-while-spooling( an# ,o*s that
have completed spooling are scheduled to print *efore ,o*s that
have not completed spooling.
0.R7 .//)4N- 0!00 4ndicates whether the printer is currentl# connected. 4f the
printer is not currentl# connected( print ,o*s will continue to
spool.
-N18)- 84'4 0>00 4ndicates whether *idirectional communications are ena*led for
the printer.
R10 .N)2 000 4ndicates that onl# raw data t#pe print ,o*s can *e spooled.
%38)4S$-' 2000 4ndicates whether the printer is pu*lished in the director#
service.
/19 !000 printer is a fa+ printer.
T-RM4N1)
S-R54"-S
>000 4ndicates the printer is currentl# connected through a terminal
server.
%3S$-' 3S-R 20000 The printer was installed *# using the %ush %rinter "onnections
user polic#.
%3S$-' M1"$4N- !0000 The printer was installed *# using the %ush %rinter "onnections
computer polic#.
M1"$4N- >0000 %rinter is a per-machine connection.
/R4-N')2 N1M- 00000 1 computer has connected to this printer and given it a friendl#
name.
&(amples.
0+21!> F 2000H %u*lished V >00H -na*le *idi V 200H do complete first V !0H local V >H shared
0+22!> F 2000H %u*lished V 200H do complete first V !0H local V >H shared
0+22> F 2000H %u*lished V 200H do complete first V 0H networ& V >H shared
0+a!> F >00H -na*le *idi V 200H do complete first V !0H local V >H shared
0+a!0 F >00H -na*le *idi V 200H do complete first V !0H local
0+>!0 F >00H -na*le *idi V!0H local
0+2!> F 200H do complete first V !0H local V >H shared
0+2!0 F 200H do complete first V !0H local
0+0!0 F )ocal
Reser"ed +'aracters.
14
There are certain characters that are reserved( *ecause the# will cause pro*lems if the# appear in the 4%
address( location( or comments fields. 0hen these characters appear( -num%rinters will replace the
reserved character with another( non-reserved character. 8elow is a list of the reserved characters and
the su*stitutions.
1 colon WHO is replaced *# semicolon WXO
1 comma W(O is replaced *# an underscore WDO
Multiple lines are com*ined into a single line separated *# an underscore.
&diting t'e printer information
The .ld 'river Name and 5ersion information are provided for the convenience of identif#ing printers( *ut
these fields are not used to create new printers. 'elete the lines for an# printers that #ou do not want to
create on the target server. To add printers that were not on the source server( enter the relevant printer
information. -nsure that the required fields are properl# filled in.
(arning)
'o not add or delete columns. 'o not delete the header row. 'o not change the order of the columns.
Missing or moved columns will cause the *uild process script to fail.
Fields used in creating new U!D and non<U!D printers
/ield Required Notes
New 'river Name 2es Name of the driver( can *e pre-installed( or from the .inf
4nf@.ptions 2es /ull path to the driver .inf file
%rinter Name 2es The name of the print queue
4% 1ddress 2es 4% address or hostname of the device
NoteH %orts are created with the default settings ofH
%rotocolH R10
%ortH R00
SNM% StatusH -na*led
"ommunit# nameH public
SNM% 'evice 4nde+H
%ort Name No 4f not specified( port name is generated automaticall# *#
pre-pending P4%DQ to the 4% address
)ocation No
"omment No
Share Name No 4f not specified( the printer name will *e used as the share
name
"olor ;< No Requires Microsoft setprinter.e+e utilit#
'uple+ ;< No Requires Microsoft setprinter.e+e utilit#
Source Name ;< No Requires Microsoft setprinter.e+e utilit#
See 1ppendi+ " for details
%aper SiTe ;< No Requires Microsoft setprinter.e+e utilit#
See 1ppendi+ " for details
Media Name ;< No Requires Microsoft setprinter.e+e utilit#
See 1ppendi+ " for details
Securit# 'escriptor No Requires Microsoft setprinter.e+e utilit#
Notes.
15
. These settings ta&e precedence over an# settings configured through the 'river "onfiguration
3tilit# ;'"3<
Sa"ing your work
Select /ile-KSave. 4f #ou see the following message(
"lic& 2es. 1n# information that ma# *e lost will not affect the outcome of the migration.
16
Appendi( +. !aper Source@ !aper SiDe and $edia type mapping
N.T-H This feature requires that the Microsoft setprinter.e+e utilit# *e downloaded separatel#( and
copied to the folder that contains the tool set. This utilit# is part of the Microsoft Server Resource 7it
tools( and can *e downloaded from Microsoft atH
httpH@@www.microsoft.com@download@en@details.asp+MidN=CB=
'ifferent drivers use different nomenclature for paper source and media t#pe. The following mappings
are used to convert non-3%' paper source and media t#pe settings to 3%' settings. 4f the driver is not
3%'( the default settings for that driver are used.
The Source Name field and the Media Name field in the .csv file are searched for specific su*strings( and
if the su*string is found( the appropriate matching to a 3%' setting is done. /or e+ample( if a search was
done for the string P1utoQ( Source Name fields contained the string P1utomaticall# SelectQ( Q1uto Tra#
SelectQ( P1utoQ( etc would all match.
!aper source mappings for U!D
Source Name containsH 3%' paper source configured to this or the localiTed equivalentH
PManualQ Manual /eed in Tra#
PTra# Q Tra#
PTra# 2Q Tra# 2
PTra# ?Q Tra# ?
PTra# !Q Tra# !
PTra# BQ Tra# B
PTra# CQ Tra# C
PTra# =Q Tra# =
PTra# >Q Tra# >
P-nvelopeQ -nvelope /eeder
4f no match is found for paper source( the default setting of :utomaticall9 Select is used.
Media Name containsH 3%' media t#pe configured to this or the localiTed equivalentH
P%lainQ %lain
P-nvelopeQ -nvelope
P"ardstoc&Q "ardstoc& =C-220g
P$eav#Q $eav# -?0g
P"olorQ "olored
P8ondQ 8ond
P)a*elQ )a*els
P%repunched+Q %repunched
P)etterheadQ )etterhead
P%reprintedQ %reprinted
4f no match is found for media name( the default setting of 7nspecified is used.
*nstructions for non<&nglis' systems
The tool does the string comparisons in -nglish onl#. 4f the target s#stem is non--nglish( follow these
additional steps.
17
4f the source name cell contains the local equivalent of P1utoQ( these fields can *e ignored.
The 3%' default is automaticall# select.
4f the media t#pe cell contains the local equivalent of P1utoQ or P3nspecifiedQ( these fields can
*e ignored. The 3%' default is unspecified.
/or all other Source Name or Media T#pe cells( su*stitute the -nglish phrase listed in the left
column in the ta*les a*ove. 0hen the printers are created( the source names and media
t#pes will *e configured using the language setting of the local s#stem.
18
Appendi( D. ,ool set files
Files included in t'e tool set
Name %urpose
Release Notes-Migrate-
Server-Tools.doc
This file
M4:R1T--S-R5-R.*at Tool set menu file
-num%rinters?.e+e -numerates the printers
$p%rn%ort.e+e 3tilit# to create T"%@4% ports
"reateTest%rinters.v*s Script to create test printers
"svTo$tml.v*s Script to convert ."S5 file to html for viewing with we* *rowser
4nstall/rom"S5.v*s 4nstalls drivers( creates and configures printers
)oad/rom'riverStore.v*s Merges driver store information into SourceD%rinters.csv
Scan/or-rrors.v*s Script to parse log files for errors
5alidate'riverStore.v*s Script to 5alidate the driver store.
'riverMapping.csv Sample driver mapping file.
%ptional files 4not included in download package5
Name %urpose
Set%rinter.e+e Microsoft utilit# used to configure print queues. Must *e downloaded
directl# from Microsoft atH
httpH@@www.microsoft.com@download@en@details.asp+MidN=CB=
Files created during t'e process
Name %urpose
'riverStore.log "reated *# step 2H Results from the driver store validation
process.
Jsource serverK.csv "reated *# step H 4nformation a*out printers and drivers on
the source ;old< server
Jsource serverK-temp.csv "reated *# step 2H Temporar# printer list file used for
*ac&up prior to merging in the new driver information.
1rchiveIJsource serverK.csv "reated *# step 2H 1rchive cop# of source server printer list
after merging in new driver information.
G.log( 1rchiveIG.log See 1ppendi+ / for list of log files created
Jsource serverK-test-printers.csv "reated *# step =H )ist of test printers that were created on
the target ;new< server.
Jtarget serverK-Target.csv "reated *# step 0H 4nformation a*out printers and drivers
on the target ;new< server.
1rchiveIJtarget serverK-Target.csv "reated *# step 0H 1rchive cop# of information a*out
newl# *uild printers and drivers on the target ;new< server.
Jsource serverK-'rivers.csv Step RH )ist of additional ;?2 or C! *it< drivers that were
installed on the target ;new< server.
Jtarget serverK.html Temporar# html file for displa#ing configuration data
File +leanup
19
The following files can *e deleted after the server *uild process is completeH
Jsource serverKG.G
Jtarget-serverKG.G
20
Appendi( &. 9uild Log File Format
Sample Log File
1. InstallFromCSV.vbs version 12.01.23.1 1/24/2012 10:04:38 AM
2. Readin !rom !ile: "SAA#SV0$M#%V0&.'sv
3. R(nnin s'ri)t: *re+*ro'ess.vbs
4. *re+*ro'ess.vbs ver 12.01.23.4 is r(nnin
,. Server -ame :
.. *rinter -ame: /* 0aser1et *201, *S 2v,.33
&. Co)4in 5.'!m to 660o'al/ost6*rint768.463
8.
9. *re+*ro'ess.vbs ret(rned: 1
10.
11. Server -ame :
12. C(rrent #river : /* "niversal *rintin *S 2v,.43
13. Version : .1.118.1.11&44
14. -e: #river -ame : /* "niversal *rintin *S 2v,.43
1,. I-F )at; : C:6/* "*#6.4+bit "*# *S v,.46;)'(118v.in!
1.. *rinter -ame : /* 0aser1et *201, *S 2v,.33
1&. #evi'e Model : /* 0aser1et *201, Series
18. I* Address : 130.1&,.138.12
19. *ort -ame : 130.1&,.138.12
20. 0o'ation :
21. Comment :
22. Is S;ared : <
23. S;are -ame : /* 0aser1et *201, *S 2v,.33
24. Is *(blis;ed : <
2,. =(ild -(mber :
2.. *rint *ro'essor : ;)'))118
2&. Color : 1
28. Co)ies : 1
29. *a)er So(r'e : 1,
30. So(r'e -ame : A(tomati'all4 Sele't
31. #()le8 : 1
32. *a)er Si>e : 1
33. Form -ame :
34. Media ?4)e : 2,.
3,. Media -ame : "ns)e'i!ied
3.. @rientation : 1
3&. A(alit4 : .00
38. S)are 1 :
39. S)are 2 :
40. Serial -(mber : 000000
41.
42. Creatin )ort: 130.1&,.138.12
43. S(''ess!(ll4 'reated )ort: 130.1&,.138.12
44. Creatin )rinter: /* 0aser1et *201, *S 2v,.33
4,. S(''ess!(ll4 'reated )rinter: /* 0aser1et *201, *S 2v,.33
4.. Con!i(rin )rinter: /* 0aser1et *201, *S 2v,.33
4&. Con!i(rin )rinter settins: /* 0aser1et *201, *S 2v,.33
48. 1/24/2012 10:0,:,& AM
21
Sample Log File &(planation.
)ine H 5ersion of the *uild script( *uild start date and time
)ine 2H Name of the printer *uild information file
)ines ?->H 4nformation returned *# the optional pre-process.v*s script
)ine RH Result returned *# optional pre-process script. 4f this script returns 0( the rest of
the *uild process for this printer is s&ipped.
)ines -!H 4nformation a*out the printer that is a*out to *e *uilt
)ine !2-!?H 4nformation a*out the creation of the T"%@4% port
)ines !!-!BH 4nformation a*out the printer installation
)ine !CH 1dding location( comments information( sharing and pu*lishing
)ine !=H Setting paper source and t#pe( duple+ and color
)ine !>H 'ate and time printer *uild operation was completed
22