IBM E02HMLL-I Implementation Guide - Page 127

Working, duplicate, components, during, deployment, Compiling, creating, schemas

Page 127 highlights

Working with duplicate components during deployment Commonly there will be components with the same name in the package file as there are in the repository. In this case you must decide whether or not you want to replace the components in the repository with those in the package file. The -ai option specifies that duplicate components should not be loaded into the repository: C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -iCustomer.jar -ai If you want to replace all the duplicate components in the repository, use the -ar option as in the following example: C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -iCustomerSyncInterface.jar -ar You can use the -arp option to interactively replace duplicate components in the repository. This lets you decide for each individual duplicate component whether it should be replaced or not. C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -iCustomerSyncInterface.jar -arp Compiling and creating schemas For maps and collaboration to execute at runtime, the maps and collaboration templates defined in the repository must be compiled. For relationships to function properly at runtime, their schemas must be created. When you deploy components to a server running in production mode, all templates are automatically compiled and all relationship schemas are created. For the deployment to succeed, then, the code of the map and collaboration templates must be valid and InterChange Server Express must be able to communicate with the databases specified in the settings of the relationship definitions. When you deploy components to a server running in design mode, the templates are not automatically compiled; relationship schemas are automatically created. There are options you can use to compile the templates, however, and there are options to not create relationship schemas. The following example uses the -xCompilePackage option and does not use any form of the -r option. The result is that when the package specified by the -i option is deployed, the maps and collaboration templates are compiled and schemas are created for the relationships: C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -iWebSphereICSServer.jar -xCompilePackage You may not want relationship schemas created when you do a deployment. For instance, if you are deploying a package from one environment to another and did not change the properties of the relationships to use the database resources in the new environment then you will not want the schemas created until after you have changed the relevant properties. The following example uses the -r* option to not create schemas for all of the relationships in the package being deployed: C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -iWebSphereICSServer.jar -xCompilePackage -r* Note: You can use the -r option without the asterisk to specify the names of individual relationships whose schemas should not be created. For instance, Chapter 6. Using repos_copy 115

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302

Working
with
duplicate
components
during
deployment
Commonly
there
will
be
components
with
the
same
name
in
the
package
file
as
there
are
in
the
repository.
In
this
case
you
must
decide
whether
or
not
you
want
to
replace
the
components
in
the
repository
with
those
in
the
package
file.
The
-ai
option
specifies
that
duplicate
components
should
not
be
loaded
into
the
repository:
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-iCustomer.jar
-ai
If
you
want
to
replace
all
the
duplicate
components
in
the
repository,
use
the
-ar
option
as
in
the
following
example:
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-iCustomerSyncInterface.jar
-ar
You
can
use
the
-arp
option
to
interactively
replace
duplicate
components
in
the
repository.
This
lets
you
decide
for
each
individual
duplicate
component
whether
it
should
be
replaced
or
not.
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-iCustomerSyncInterface.jar
-arp
Compiling
and
creating
schemas
For
maps
and
collaboration
to
execute
at
runtime,
the
maps
and
collaboration
templates
defined
in
the
repository
must
be
compiled.
For
relationships
to
function
properly
at
runtime,
their
schemas
must
be
created.
When
you
deploy
components
to
a
server
running
in
production
mode,
all
templates
are
automatically
compiled
and
all
relationship
schemas
are
created.
For
the
deployment
to
succeed,
then,
the
code
of
the
map
and
collaboration
templates
must
be
valid
and
InterChange
Server
Express
must
be
able
to
communicate
with
the
databases
specified
in
the
settings
of
the
relationship
definitions.
When
you
deploy
components
to
a
server
running
in
design
mode,
the
templates
are
not
automatically
compiled;
relationship
schemas
are
automatically
created.
There
are
options
you
can
use
to
compile
the
templates,
however,
and
there
are
options
to
not
create
relationship
schemas.
The
following
example
uses
the
-xCompilePackage
option
and
does
not
use
any
form
of
the
-r
option.
The
result
is
that
when
the
package
specified
by
the
-i
option
is
deployed,
the
maps
and
collaboration
templates
are
compiled
and
schemas
are
created
for
the
relationships:
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-iWebSphereICSServer.jar
-xCompilePackage
You
may
not
want
relationship
schemas
created
when
you
do
a
deployment.
For
instance,
if
you
are
deploying
a
package
from
one
environment
to
another
and
did
not
change
the
properties
of
the
relationships
to
use
the
database
resources
in
the
new
environment
then
you
will
not
want
the
schemas
created
until
after
you
have
changed
the
relevant
properties.
The
following
example
uses
the
-r*
option
to
not
create
schemas
for
all
of
the
relationships
in
the
package
being
deployed:
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-iWebSphereICSServer.jar
-xCompilePackage
-r*
Note:
You
can
use
the
-r
option
without
the
asterisk
to
specify
the
names
of
individual
relationships
whose
schemas
should
not
be
created.
For
instance,
Chapter
6.
Using
repos_copy
115