Learning How to Migrate a Citrix Data Store from Access to SQL Server

Related Products

Latest Carl Webster Articles

Integrating Web Interface 4.6, Citrix Secure Gateway 3.1 and a GoDaddy Wildcard SSL Certificate on a Single Ser er !art 3 of 3 Integrating Web Interface 4.6, Citrix Secure Gateway 3.1 and a GoDaddy Wildcard SSL Certificate on a Single Ser er !art " of 3 Integrating Web Interface 4.6, Citrix Secure Gateway 3.1 and a GoDaddy Wildcard SSL Certificate on a Single Ser er !art 1 of 3

About Carl Webster

Web#ter i# a Sr. $nter%ri#e $ngineer for S&'C()*!C )all #%eciali+ing in Citrix, &cti e Directory and $xc,ange. Web#ter ,a# been wor-ing wit, Citrix %roduct# for o er 1. year# #tarting wit, )ulti/0#er (S*". Web#ter i# a ,ig,ly #-illed #enior tec,nology 1anager wit, a 1ore t,an "2 year# ex%erience leading t,e de#ign, de elo%1ent and i1%le1entation of enter%ri#e %ro3ect# for ,ig, %rofile global cu#to1er#. 4i# #trong tec,nology #-ill# are balanced by t,e %ro en ability to recruit and de elo% ,ig,ly talented tea1# of tec,nology %rofe##ional# and guide t,eir %erfor1ance on #,ort and long range %ro3ect#. &# a Senior $nter%ri#e $ngineer for S&'C(), Web#ter ,a# led co1%lex %ro3ect# for -ey cu#to1er# in 1ulti%le indu#trie#, including 1edical #u%%lier#, direct 1ail %ro ider#, #%ort# 1ar-eting, a 1a3or grocery c,ain, and large regional 1edical facilitie#. Web#ter5# career %re%aration included a #erie# of training# and certification# in -ey tec,nologie#, but ,i# acco1%li#,1ent# o er ti1e ,a e been largely dri en by #trengt,# in relation#,i% 1anage1ent, #trategic %lanning, and o%erational ex%erti#e acro## t,e full #co%e of bu#ine## and client 1anage1ent. Contact Web#ter6CarlWeb#ter.co1

!irtuali"ation Podcasts
De#-to% 7irtuali+ation Connection 8ro-er !odca#t wit, )i-e !alin and $ric 4an#el1an fro1 Leo#trea1 / &%ril "3, "229 / $%i#ode :9

DA#CC$%! !ideos
triCerat Si1%lify Suite; De#-to% 7irtuali+ation 0#er )anage1ent 7ideo !odca#t / $%i#ode 16

W,en a Citrix <ar1 i# created, by default, t,e data #tore i# created on t,e fir#t #er er of t,e <ar1 u#ing an &cce## databa#e. =,i# article will teac, you ,ow to bac-u% an &cce## data #tore and 1igrate t,at data #tore fro1 &cce## to S>L Ser er.

=,ere are a cou%le of ad antage# to u#ing &cce## for t,e data #tore;
Easy to setup during XenApp installation No complicated ODBC DSN file to create or configure

=,e di#ad antage# to u#ing &cce## for t,e data #tore;

If the XenApp server hosting the data store goes down or is restarted !arm functionality is severely crippled Only recommended for very small !arms "ecause of performance reasons No #igh Availa"ility options

 $arely included in "ac%up or disaster recovery planning

=,e ad antage# to u#ing S>L Ser er for t,e data #tore;

Is not run on a XenApp server Can "e used for any si&e !arm #igh Availa"ility options 'sually included in "ac%up and disaster recovery planning

<or t,i# article, 7)ware Wor-#tation 6.?.1/1"6132 will be u#ed wit, Window# Ser er "22. Standard @x.6A and Citrix Ben&%% for Window# Ser er "22. !latinu1 @x.6A. =,e following 7irtual )ac,ine# @7)A will be u#ed;
Domain Controller( Citri)DC o *he +, will "e assigned one processor -.B of $A, and -/.B of #ard Drive space o Domain Controller for the 0e"sters1a"2com Active Directory domain o *erminal Server 1icense server and Citri) 1icensing server o Static I3 Address -452-/62-2-77 S81 Server( Citri)S81o *he +, will "e assigned one processor 5.B of $A, and -/.B of #ard Drive space o *his +, will host the new migrated to S81 Server data store o *his +, will use S81 Server 5779 S3: o Static I3 Address -452-/62-2-7 XenApp 9 ;-( Citri)XAo *he +, will "e assigned one processor 5.B of $A, and -/.B of #ard Drive space o *his +, will host the original Access data store o Static I3 Address -452-/62-2-75 XenApp 9 ;5( Citri)XA5 o *he +, will "e assigned one processor 5.B of $A, and -/.B of #ard Drive space o *his +, is used to show how to change additional XenApp servers to use the new S81 Server
data store

o Static I3 Address -452-/62-2-7:

CitrixDC ,a# a file #,are na1ed CTXBACKUP t,at I will u#e to #tore t,e data #tore bac-u%. Ben&%% ? for Window# Ser er "22. wa# in#talled on CitrixB&1 and a new <ar1 na1ed Webster wa# created during t,e in#tallation. &fter re#tarting t,e 7), Ben&%% ? for Window#

Ser er "22. wa# in#talled on CitrixB&" and t,en t,i# in#tance wa# 3oined to t,e Webster <ar1. =wo a%%lication# were %ubli#,ed on t,e <ar1; Cote%ad and !aint. 8ot, a%%lication# are configured to run fro1 bot, Ben&%% #er er#.

It i# a 8e#t !ractice to alway# bac-u% t,e data #tore before %erfor1ing t,e 1igration. =,e &cce## ba#ed data #tore, by default, i# located in C:\Program Files\Citrix\Independent Management Arc itect!re and i# na1ed MF"#$mdb. <ro1 a co11and %ro1%t on CitrixB&1, t,e following co11and wa# run to generate a bac-u%; dsmaint bac&u' ((CitrixDC(C%)#ac&u' =,e co11and Dd#1aint bac-u%D 1a-e# a co%y of t,e )<"2.1db &cce## data #tore to t,e location #%ecified. Dd#1aint bac-u%D i# u#ed only to bac-u% an &cce## data #tore and 1u#t be run on t,e Ben&%% #er er ,o#ting t,e &cce## data #tore. It cannot be u#ed to bac-u% a data #tore w,ic, i# u#ing )SD$, S>L Ser er "22? $x%re##, S>L Ser er, (racle or D8". =,i# article i# u#ing t,e conce%t# fro1 Citrix #u%%ort article C=B6::?4". <or S>L Ser er Databa#e #%ecific infor1ation, %lea#e #ee %age 1.3 of t,e Ben&%% In#tallation Guide. #*+,R* -,. S%AR%%H* M/0RA%/,12 ma&e sure t3e account being used for t3is 'rocedure is a +ull +arm Administrator4 Cote; If you ,a e a )icro#oft S>L Ser er D8& a ailable, %lea#e reference t,e Citrix Su%%ort article Citrix Presentation %er&er and Microso't %() "##* Con'ig!ration. =o create t,e S>L Ser er data #tore databa#e, o%en S>L Ser er )anage1ent Studio. Clic%tart +, All Programs +, Microso't %() %er&er "##* +, %() %er&er Management %t!dio.

$x%and -atabases in t,e left colu1n.

'ig,t/clic- -atabases and #elect .e/ -atabase.

It i# reco11ended to %ut t,e <ar1 na1e in t,e databa#e na1e.

Clic- 0ptions and 1a-e #ure 1eco&er2 Model i# #et to F!ll and Compatibilit2 )e&el i# #et to %() %er&er "##* 34#5. Clic- 0K.

=,e new data #tore databa#e i# ready for u#e.

(n t,e Ben&%% #er er ,o#ting t,e &cce## data #tore, a new Data Source Ca1e @DSCA need# to be created for t,e S>L databa#e. Clic- %tart /E Administrati&e Tools /E -ata %o!rces 30-BC5. Cote; W,at i# (D8CF =,i# i# ta-en fro1 ,tt%;**#u%%ort.1icro#oft.co1*-b*112293 D(%en Databa#e Connecti ity @(D8CA i# )icro#oftG# #trategic interface for acce##ing data in a ,eterogeneou# en iron1ent of relational and non/ relational databa#e 1anage1ent #y#te1#. 8a#ed on t,e Call Le el Interface #%ecification of t,e S>L &cce## Grou%, (D8C %ro ide# an o%en, endor/ neutral way of acce##ing data #tored in a ariety of %ro%rietary %er#onal co1%uter, 1inico1%uter, and 1ainfra1e databa#e#. (D8C alle iate# t,e need for inde%endent #oftware endor# and cor%orate de elo%er# to learn 1ulti%le a%%lication %rogra11ing interface#. (D8C now %ro ide# a uni er#al data acce## interface. Wit, (D8C, a%%lication de elo%er# can allow an a%%lication to concurrently acce##, iew, and 1odify data fro1 1ulti%le, di er#e databa#e#.D

Clic- t,e File -%. =ab. Cote; W,at i# t,e difference between D0#er DSCD, DSy#te1 DSCD and D<ile DSCDF =,i# i# ta-en fro1 ,tt%;**#u%%ort.1icro#oft.co1*-b*"13::". .ser DS1; =,e 0#er DSC i# a data #ource t,at i# u#er/#%ecific. & 0#er DSC i# #tored locally but i# a ailable only to t,e u#er w,o create# it.

S5stem DS1; 0nli-e a 0#er DSC, a Sy#te1 DSC i# not u#er/#%ecific. & Sy#te1 DSC i# #tored locally and i# not dedicated to a %articular u#er. &ny u#er w,o log# on to a co1%uter t,at ,a# %er1i##ion to acce## t,e data #ource can u#e a Sy#te1 DSC. So1e %rogra1#, #uc, a# )icro#oft S>L Ser er or )icro#oft Internet Infor1ation Ser er @IISA, reHuire a Sy#te1 DSC. =,i# DSC 1u#t be created on t,e #er er w,ere t,e %rogra1 i# located. Sy#te1 DSC# are #tored in t,e Window# regi#try under t,e following -ey; 4I$JKL(C&LK)&C4IC$LSoftwareL(dbcL(dbc.iniL(dbc Data #ource#

+ile DS1; =,e <ile DSC i# created locally and can be #,ared wit, ot,er u#er#. =,e <ile DSC i# file/ba#ed, w,ic, 1ean# t,at t,e .d#n file contain# all t,e infor1ation reHuired to connect to t,e data #ource. Cote t,at you 1u#t in#tall t,e (D8C dri er locally to u#e a <ile DSC. <ile DSC#

are not #tored in t,e Window# regi#try. =,e .d#n file i# a text file t,at you can iew in any text editor, #uc, a# )icro#oft Cote%ad.

C,ange t,e )oo6 in to C:\Program Files\Citrix\Independent Management Arc itect!re. =,e new DSC 1u#t be %laced in t,i# folder. =,e IMA%718IC7 #er ice i# %rogra11ed to loo- in only t,i# folder.

Clic- t,e Add button.

Clic- on %() %er&er and clic- .ext.

=y%e in C (Program +iles(Citrix(/nde'endent Management Arc3itecture(Webster+armDSM+674dsn and clic- .ext. Cote; =,e DSC can be na1ed anyt,ing a# long a# it ,a# a .d#n file exten#ion. It doe# not need to contain D)<"2D anyw,ere in t,e na1e.

Clic- Finis .

$nter a -escription and ty%e in t,e na1e of t,e S>L Ser er and clic- .ext.

If a successful connection to the S81 Server is made clic% Next2 A common pro"lem is the 0indows !irewall is not configured to allow S81 traffic <*C3 3ort -=::>2 *o configure an instance of S81 Server 5779 to use a static port follow the steps descri"ed in the ?#ow to( Configure a Server to 1isten on a Specific *C3 3ort <S81 Server Configuration ,anager>? topic in S81 Server 5779 Boo%s Online2

Note( If S81 Server is set to use a static port clic% Client Configuration then unchec% Dynamically determine port and enter the value for the static port num"er2

If t,e account li#ted in t,e grayed out )ogin I- aut,enticate# #ucce##fully to t,e S>L Ser er, C ange t e de'a!lt database to t,e new S>L Ser er data #tore and clic- .ext. (ne %roble1 could be t,e )ogin I- account i# not #etu% to acce## t,e S>L Ser er.

Clic- Finis .

Clic- Test -ata %o!rce.

If t,e 1e##age =$S=S C()!L$=$D S0CC$SS<0LLJ i# #,own, clic- 0K. (t,erwi#e, you will need to trouble#,oot t,e (D8C connection to t,e S>L Ser er.

Clic- 0K.

Jour new DSC i# created. Clic- 0K.

Clic- %tart, rig,t/clic- Command Prompt and #elect 1!n as administrator.

=y%e in DSMA/1% M/0RA%* 8srcdsn 9C (Program +iles(Citrix(/nde'endent Management Arc3itecture(M+674dsn9 8srcuser citrix 8src'wd citrix 8dstdsn 9C (Program +iles(Citrix(/nde'endent Management Arc3itecture(Webster+armDSM+674dsn9 8dstuser websterslab(administrator 8dst'wd 'assword and %re## 7nter. 8srcdsn i# t,e &cce## )<"2.d#n t,at wa# created w,en t,e <ar1 wa# created 8srcuser and 8src'wd are bot,, by default, DcitrixD 8dstdsn i# t,e new DSC file 8dstuser and 8dst'wd are t,e u#erna1e and %a##word of t,e account t,at ,a# rig,t# to t,e new data #tore S>L databa#e Clic- 9es on t,e -smaint confir1ation %o%u%.

=,e 1igration #tart#. If t,e following error i# recei ed; D'e#ult; Dan un-nown error occurred w,ile 1igrating t,e table, %lea#e erify t,e de#tination data#ource i# clean. M)icro#oftNM(D8C S>L #er er Dri erNMS>L #er erN iolation of %ri1ary -ey con#traint GCLG. Cannot in#ert du%licate -ey in ob3ect D-eytableD. Indexe# ,a e been #ucce##fully %atc,ed.D =,i# i# u#ually cau#ed by t,e default databa#e being #et to )a#ter. =,at i# a ,uge 1i#ta-e. )a-e #ure t,e default databa#e for t,e DSC file i# #et to t,e new data #tore databa#e.

W,en t,e 1igration co1%lete#, an#wer 9es to t,e -smaint co1%ari#on %o%u%.

=,e co1%ari#on run# and co1%lete#.

Cext DS)&IC= C(C<IG need# to be run. =,e 8'wd o%tion need# to be u#ed and according to t,e Ben&%% &d1ini#tratorG# Guide; DJou 1u#t #to% t,e Citrix Inde%endent )anage1ent &rc,itecture #er ice before u#ing config wit, t,e 8'wd o%tion.D In t,e co11and %ro1%t window, ty%e 1*% S%,P /MAS*R!/C* and %re## 7nter.

=y%e in DSMA/1% C,1+/0 8user websterslab(administrator 8'wd 'assword 8dsn 9C (Program +iles(Citrix(/nde'endent Management Arc3itecture(Webster+armDSM+674dsn9 and %re## 7nter.

=y%e in 1*% S%AR% /MAS*R!/C* and %re## 7nter. (ne cau#e of t,e I)&S$'7IC$ not re#tarting i# t,e currently logged in account i# not a <ull <ar1 &d1ini#trator.

=y%e in CD 9C (Program +iles(Citrix(/nde'endent Management Arc3itecture9 and %re## 7nter. Co%y t,e new DSC file to t,e re1aining Ben&%% #er erG# C:\Program Files\Citrix\Independent Management Arc itect!re folder.

$dit t,e co%ied DSC file and c,ange t,e WSID line to reflect t,e na1e of t,at Ben&%% #er er.

(n eac, re1aining Ben&%% #er er, ty%e in DSMA/1% C,1+/0 8user websterslab(administrator 8'wd 'assword 8dsn 9C (Program +iles(Citrix(/nde'endent Management Arc3itecture(Webster+armDSM+674dsn9 and %re## 7nter. =,en ty%e in 1*% S%,P /MAS*R!/C* :: 1*% S%AR% /MAS*R!/C* and %re## 7nter. (n any of t,e Ben&%% #er er#, #tart t,e Access Management Console @&)CA.

=,e &)C co11unicate# wit, t,e data #tore to retrie e t,e <ar1 infor1ation. If any error# are recei ed, go to ,tt%;**#u%%ort.citrix.co1 and #earc, for t,e error nu1ber. &n alternate way to te#t connecti ity to t,e data #tore i# fro1 a co11and %ro1%t ty%e in Q+ARM and %re## enter. Jou learned ,ow to;
"ac%up an Access data store Create a new !ile DSN for a S81 Server data store ,igrate to the new data store Configure all XenApp servers to communicate with the new data store Stop and restart the I,A service on a XenApp server 'sing the Access ,anagement Console verify communication with the new data store