docu57844 documentum conteddddnt management interoperability services 7.2 deployment guide

7/25/2019 Docu57844 Documentum Conteddddnt Management Interoperability Services 7.2 Deployment Guide

1/35

E M C D o c u m e n t u m

C o n t e n t M a n a g e m e n t

I n t e r o p e r a b i l i t y S e r v i c e s V e r s i o n 7 . 2

D e p l o y m e n t G u i d e

E M C C o r p o r a t i o n

C o r p o r a t e H e a d q u a r t e r s

H o p k i n t o n , M A 0 1 7 4 8 - 9 1 0 3

1 - 5 0 8 - 4 3 5 - 1 0 0 0

w w w . E M C . c o m


2/35

L e g a l N o t i c e

C o p y r i g h t 2 0 1 1 2 0 1 5 E M C C o r p o r a t i o n . A l l R i g h t s R e s e r v e d .

E M C b e l i e v e s t h e i n f o r m a t i o n i n t h i s p u b l i c a t i o n i s a c c u r a t e a s o f i t s p u b l i c a t i o n d a t e . T h e i n f o r m a t i o n i s s u b j e c t t o c h a n g e w i t h o u t n o t i c e .

T H E I N F O R M A T I O N I N T H I S P U B L I C A T I O N I S P R O V I D E D A S I S . E M C C O R P O R A T I O N M A K E S N O R E P R E S E N T A T I O N S O R W A R R A N T I E S O F A N Y K I N D W I T H R E S P E C T T O T H E I N F O R M A T I O N I N T H I S P U B L I C A T I O N , A N D S P E C I F I C A L L Y D I S C L A I M S I M P L I E D W A R R A N T I E S O F M E R C H A N T A B I L I T Y O R F I T N E S S F O R A P A R T I C U L A R P U R P O S E .

U s e , c o p y i n g , a n d d i s t r i b u t i o n o f a n y E M C s o f t w a r e d e s c r i b e d i n t h i s p u b l i c a t i o n r e q u i r e s a n a p p l i c a b l e s o f t w a r e l i c e n s e .

F o r t h e m o s t u p - t o - d a t e l i s t i n g o f E M C p r o d u c t n a m e s , s e e E M C C o r p o r a t i o n T r a d e m a r k s o n E M C . c o m . A d o b e a n d A d o b e P D F L i b r a r y a r e t r a d e m a r k s o r r e g i s t e r e d t r a d e m a r k s o f A d o b e S y s t e m s I n c . i n t h e U . S . a n d o t h e r c o u n t r i e s . A l l o t h e r t r a d e m a r k s u s e d h e r e i n a r e t h e p r o p e r t y o f t h e i r r e s p e c t i v e o w n e r s .

D o c u m e n t a t i o n F e e d b a c k

Y o u r o p i n i o n m a t t e r s . W e w a n t t o h e a r f r o m y o u r e g a r d i n g o u r p r o d u c t d o c u m e n t a t i o n . I f y o u h a v e f e e d b a c k a b o u t h o w w e c a n m a k e o u r d o c u m e n t a t i o n b e t t e r o r e a s i e r t o u s e , p l e a s e s e n d u s y o u r f e e d b a c k d i r e c t l y a t I I G D o c u m e n t a t i o n F e e d b a c k @ e m c . c o m


3/35

T a b l e o f C o n t e n t s

P r e f a c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

C h a p t e r 1 A b o u t D o c u m e n t u m C M I S D e p l o y m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7O v e r v i e w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

C h a p t e r 2 C o n g u r a t i o n S e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9G e n e r a l J V M c o n g u r a t i o n s e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9U s i n g u r a n d o m g e n e r a t o r s o n L i n u x s y s t e m s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9D o c u m e n t u m C M I S c o n g u r a t i o n l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0D F C c o n g u r a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0D o c u m e n t u m C M I S r u n t i m e p r o p e r t i e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1

A n o n y m o u s a c c e s s s e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4M a x i m u m i t e m s d e f a u l t a n d u p p e r l i m i t s e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5

C h a p t e r 3 C o n g u r i n g K e r b e r o s S S O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7O v e r v i e w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7P r o c e d u r e t o e n a b l e K e r b e r o s S S O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7C o n g u r i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N a n d * . k e y t a b l e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8

M a p p i n g t h e S P N t o a u s e r n a m e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9

C o n g u r i n g t h e a p p l i c a t i o n s e r v e r f o r K e r b e r o s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0C o n g u r i n g k r b 5 . i n i a n d c m i s - r u n t i m e . p r o p e r t i e s l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0C o n g u r i n g t h e J A A S . c o n f l e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2C o n g u r i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 4

L o g g i n g f o r K e r b e r o s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 5P e r f o r m a n c e b e s t p r a c t i c e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 5

Q U E S T T C P / U D P s e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 5

C h a p t e r 4 D e p l o y i n g t o S u p p o r t e d A p p l i c a t i o n S e r v e r s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 7O v e r v i e w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 7A p a c h e T o m c a t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 8V M w a r e v F a b r i c t c S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 8

O r a c l e W e b L o g i c S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 8I B M W e b S p h e r e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 9

C h a p t e r 5 P o s t D e p l o y m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1V a l i d a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1R E S T f u l A t o m P u b s e r v i c e d o c u m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1W e b s e r v i c e e n t r y p o i n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1

3


4/35

T a b l e o f C o n t e n t s

L i s t o f T a b l e s

T a b l e 1 . P r o p e r t i e s i n d f c . p r o p e r t i e s t h a t a r e r e l e v a n t t o D o c u m e n t u m C M I S . . . . . . . . . . . . . . . . . . . . . . . . 1 0T a b l e 2 . D o c u m e n t u m C M I S s t a r t u p p r o p e r t i e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2T a b l e 3 . P r o p e r t i e s i n c m i s - r u n t i m e . p r o p e r t i e s f o r K e r b e r o s S i n g l e - d o m a i n

S u p p o r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0T a b l e 4 . P r o p e r t i e s i n c m i s - r u n t i m e . p r o p e r t i e s f o r K e r b e r o s M u l t i - d o m a i n

S u p p o r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0T a b l e 5 . R e s p o n s e - t i m e t e s t r e s u l t s f o r s i n g l e - a n d m u l t i - d o m a i n r e q u e s t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 6T a b l e 6 . R e s p o n s e - t i m e t e s t r e s u l t s f o r m u l t i - d o m a i n r e q u e s t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 6T a b l e 7 . D o c u m e n t u m C M I S W e b A p p l i c a t i o n A r c h i v e F i l e s f o r A p p l i c a t i o n S e r v e r s . . . . . . . . . . . . . 2 7

T a b l e 8 . C M I S w e b s e r v i c e e n d p o i n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1

4


5/35

P r e f a c e

T h i s m a n u a l d e s c r i b e s h o w t o d e p l o y E M C D o c u m e n t u m C o n t e n t M a n a g e m e n t I n t e r o p e r a b i l i t y

S e r v i c e s ( C M I S ) t o a s u p p o r t e d s e r v l e t c o n t a i n e r , a s w e l l a s i n f o r m a t i o n a b o u t c o n g u r a t i o n o f t h e

C M I S s e r v e r e n v i r o n m e n t .

I n t e n d e d a u d i e n c e

T h i s m a n u a l i s f o r s y s t e m a d m i n i s t r a t o r s o r p r o g r a m m e r s w h o w i s h t o d e p l o y D o c u m e n t u m C M I S .

R e v i s i o n h i s t o r y

T h i s s e c t i o n c o n t a i n s a d e s c r i p t i o n o f t h i s d o c u m e n t s r e v i s i o n h i s t o r y .

R e v i s i o n D a t e D e s c r i p t i o n

F e b r u a r y 2 0 1 5 I n i t i a l p u b l i c a t i o n .

5


6/35

P r e f a c e

6


7/35

C h a p t e r 1

A b o u t D o c u m e n t u m C M I S D e p l o y m e n t

T h e s e t o p i c s a r e i n c l u d e d :

O v e r v i e w , p a g e 7

O v e r v i e w D o c u m e n t u m C M I S i s a w e b a p p l i c a t i o n . T o d e p l o y D o c u m e n t u m C M I S , y o u d e p l o y a D o c u m e n t u m

C M I S w e b a p p l i c a t i o n a r c h i v e l e t o a n a p p l i c a t i o n s e r v e r .

M a k e s u r e t h a t y o u r e n v i r o n m e n t m e e t s t h e D o c u m e n t u m C M I S h a r d w a r e a n d s o f t w a r e

r e q u i r e m e n t s . D o c u m e n t u m E n v i r o n m e n t a n d S y s t e m R e q u i r e m e n t s G u i d e p r o v i d e s d e t a i l e d i n f o r m a t i o n .

Y o u m u s t e n a b l e K e r b e r o s S S O b e f o r e d e p l o y i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n . S e e

C h a p t e r 3 , C o n g u r i n g K e r b e r o s S S O .

N o t e : Y o u c a n n o t u s e K e r b e r o s S S O a t t h e s a m e t i m e a s :

F o r S O A P b i n d i n g , W S - S e c u r i t y U s e r n a m e T o k e n P r o l e 1 . 1

F o r A t o m P u b b i n d i n g , H T T P b a s i c a u t h e n t i c a t i o n

7


8/35

A b o u t D o c u m e n t u m C M I S D e p l o y m e n t

8


9/35

C h a p t e r 2

C o n g u r a t i o n S e t t i n g s

T h i s c h a p t e r p r o v i d e s i n f o r m a t i o n o n c o n g u r a t i o n s e t t i n g s t h a t a f f e c t D o c u m e n t u m C M I S , i n c l u d i n g

J V M , L i n u x , a n d a p p l i c a t i o n p r o p e r t i e s s e t t i n g s .


G e n e r a l J V M c o n g u r a t i o n s e t t i n g s , p a g e 9

U s i n g u r a n d o m g e n e r a t o r s o n L i n u x s y s t e m s , p a g e 9

D o c u m e n t u m C M I S c o n g u r a t i o n l e s , p a g e 1 0

D F C c o n g u r a t i o n , p a g e 1 0

D o c u m e n t u m C M I S r u n t i m e p r o p e r t i e s , p a g e 1 1

G e n e r a l J V M c o n g u r a t i o n s e t t i n g s

T o p r o v i d e a d e q u a t e h e a p s p a c e a n d P e r m G e n s p a c e f o r t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n , w e

r e c o m m e n d t h e f o l l o w i n g J V M s e t t i n g s : - X m s 5 1 2 m

- X m x 5 1 2 m

- X X : M a x P e r m S i z e = 1 2 8 m

U s i n g u r a n d o m g e n e r a t o r s o n L i n u x s y s t e m s

T h e r e a r e i s s u e s w i t h i m p l e m e n t a t i o n o f p s e u d o - r a n d o m n u m b e r g e n e r a t o r s o n L i n u x . F o r m o r e

e f c i e n t r a n d o m i z a t i o n , L i n u x s y s t e m s s h o u l d u s e u r a n d o m g e n e r a t o r s t h a t a r e f a s t e r b u t l e s s s e c u r e .

T o c h a n g e t h e s o u r c e o f s e c u r e r a n d o m n u m b e r s f r o m r a n d o m t o u r a n d o m , s e t t h e

j a v a . s e c u r i t y . e g d s y s t e m p r o p e r t y a s f o l l o w s :

- D j a v a . s e c u r i t y . e g d = f i l e : / / / d e v / u r a n d o m

S p e c i f y i n g t h i s s y s t e m p r o p e r t y w i l l o v e r r i d e t h e s e c u r e r a n d o m . s o u r c e s e t t i n g t o u r a n d o m .

I f t h e a p p l i c a t i o n s e r v e r i s o n R e d H a t L i n u x , t h e a p p l i c a t i o n s e r v e r s t a r t u p s c r i p t ( f o r e x a m p l e

r u n . s h f o r J B o s s , a n d s t a r t W e b l o g i c . s h f o r W e b L o g i c ) m u s t b e m o d i e d t o s e t t h e o p t i o n

i n t h e J V M .

9


10/35


D o c u m e n t u m C M I S c o n g u r a t i o n l e s

D o c u m e n t u m C M I S u s e s t h e s e c o n g u r a t i o n l e s t o s e t p r o p e r t i e s f o r d i f f e r e n t l a y e r s o f t h e

a p p l i c a t i o n :

d f c . p r o p e r t i e s , w h i c h c o n t a i n s p r o p e r t y s e t t i n g s f o r t h e u n d e r l y i n g D F C ( D o c u m e n t u m

F o u n d a t i o n C l a s s e s ) c l i e n t . T h e s e t t i n g s c r i t i c a l t o y o u r d e p l o y m e n t a r e t h e c o n n e c t i o n b r o k e r a n d

g l o b a l r e g i s t r y s e t t i n g s , a s w e l l a s o t h e r s e t t i n g s , d e s c r i b e d u n d e r D F C c o n g u r a t i o n , p a g e 1 0 .

c m i s - r u n t i m e . p r o p e r t i e s , w h i c h i n c l u d e s p r o p e r t i e s s p e c i c t o t h e D o c u m e n t u m C M I S

l a y e r . T h e s e p r o p e r t i e s a r e d e s c r i b e d u n d e r D o c u m e n t u m C M I S r u n t i m e p r o p e r t i e s , p a g e 1 1 .

D F C c o n g u r a t i o n

T h e d f c . p r o p e r t i e s l e p r o v i d e s p r o p e r t y s e t t i n g s f o r t h e D o c u m e n t u m F o u n d a t i o n C l a s s e s

r u n t i m e . T h i s l e i s l o c a t e d i n A P P - I N F / c l a s s e s i f y o u a r e d e p l o y i n g t h e E A R l e , o r i n

W E B - I N F / c l a s s e s i f y o u d e p l o y i n g t h e W A R l e .

T a b l e 1 , p a g e 1 0 d e s c r i b e s p r o p e r t i e s i n t h e d f c . p r o p e r t i e s l e t h a t a r e r e l e v a n t f o r D o c u m e n t u m

C M I S . F o r e x a m p l e , t h e d f c . p r o p e r t i e s l e s i n c l u d e s t h e c r i t i c a l s e t t i n g s t h a t a r e r e q u i r e d f o r

D o c u m e n t u m C M I S t o r e a c h a c o n n e c t i o n b r o k e r ( h i s t o r i c a l l y c a l l e d a d o c b r o k e r ) a n d c o n n e c t t o a

C o n t e n t S e r v e r .

T a b l e 1 . P r o p e r t i e s i n d f c . p r o p e r t i e s t h a t a r e r e l e v a n t t o D o c u m e n t u m C M I S

P r o p e r t y V a l u e

d f c . d o c b r o k e r . h o s t [ 0 ] T h e f u l l y q u a l i e d h o s t n a m e f o r t h e c o n n e c t i o n

b r o k e r . Y o u c a n a d d b a c k u p h o s t s b y a d d i n g

n e w p r o p e r t i e s a n d i n c r e m e n t i n g t h e i n d e x n u m b e r w i t h i n b r a c k e t s .

d f c . d o c b r o k e r . p o r t I f y o u w i s h t o u s e a p o r t f o r t h e c o n n e c t i o n

b r o k e r o t h e r t h a n t h e d e f a u l t o f 1 4 8 9 , a d d a p o r t

k e y .

d f c . g l o b a l r e g i s t r y . r e p o s i t o r y T h e g l o b a l r e g i s t r y r e p o s i t o r y n a m e .

d f c . g l o b a l r e g i s t r y . u s e r n a m e T h e u s e r n a m e o f t h e g l o b a l r e g i s t r y u s e r .

T h e g l o b a l r e g i s t r y u s e r , w h o h a s t h e d e f a u l t

u s e r n a m e d m _ b o f _ r e g i s t r y , m u s t h a v e r e a d

a c c e s s t o o b j e c t s i n t h e / S y s t e m / M o d u l e s a n d

/ S y s t e m / N e t w o r k L o c a t i o n s o n l y .

d f c . g l o b a l r e g i s t r y . p a s s w o r d A n e n c r y p t e d p a s s w o r d v a l u e f o r t h e g l o b a l

r e g i s t r y u s e r .

1 0


11/35


P r o p e r t y V a l u e

d f c . s e a r c h . e x t e r n a l _ s o u r c e s . e n a b l e T r u e , t o e n a b l e D o c u m e n t u m F e d e r a t e d S e a r c h

S e r v i c e s ( f o r m e r l y k n o w n a s E C I S ) ; f a l s e , t o

d i s a b l e E C I S .

Y o u m u s t s p e c i f y t h e D o c u m e n t u m F e d e r a t e d S e a r c h S e r v i c e s h o s t m a c h i n e n a m e i n

d f c . s e a r c h . e c i s . h o s t .

d f c . s e a r c h . e x t e r n a l _ s o u r c e s . h o s t S p e c i e s t h e D o c u m e n t u m F e d e r a t e d S e a r c h

S e r v i c e s ( f o r m e r l y k n o w n a s E C I S ) h o s t m a c h i n e

n a m e .

Y o u m u s t s e t d f c . s e a r c h . e c i s . e n a b l e t o

t r u e .

d f c . c a c h e . d d i n f o . s i z e V a l i d v a l u e s a r e 1 t o 1 0 0 0 0 . C o n t r o l s t h e m e m o r y

c a c h e s i z e o f t h e C o n t e n t S e r v e r d a t a d i c t i o n a r y .

T h i s p a r a m e t e r i s r e q u i r e d f o r t h e C M I S t y p e d e n i t i o n c a c h e .

d f c . c a c h e . t y p e . c u r r e n c y _ c h e c k

_ i n t e r v a l

V a l i d v a l u e s a r e 0 t o 8 6 4 0 0 .

T h i s p a r a m e t e r i s r e q u i r e d f o r t h e C M I S t y p e

d e n i t i o n c a c h e .

Y o u c a n e i t h e r c o p y t h e u s e r n a m e a n d e n c r y p t e d p a s s w o r d f o r t h e g l o b a l r e g i s t r y u s e r f r o m t h e

d f c . p r o p e r t i e s l e o n t h e g l o b a l r e g i s t r y C o n t e n t S e r v e r h o s t , o r y o u c a n s e l e c t a n o t h e r g l o b a l

r e g i s t r y u s e r a n d e n c r y p t t h e p a s s w o r d u s i n g t h e f o l l o w i n g c o m m a n d :

j a v a - c p d f c . j a r c o m . d o c u m e n t u m . f c . t o o l s . R e g i s t r y P a s s w o r d U t i l s p a s s w o r d _ t o _ b e _ e n c r y p t e d

D o c u m e n t u m C M I S r u n t i m e p r o p e r t i e s

T h e c m i s - r u n t i m e . p r o p e r t i e s l e e n a b l e s y o u t o s e t p r o p e r t i e s t h a t a f f e c t a p p l i c a t i o n b e h a v i o r

a t t h e C M I S l a y e r .

T h e s e p r o p e r t i e s a r e o p t i o n a l u n l e s s o t h e r w i s e s p e c i e d , a n d i f n o t s p e c i e d w i l l d e f a u l t t o a v a l u e

d o c u m e n t e d i n t h e f o l l o w i n g t a b l e . I f a s u p p l i e d v a l u e f o r a n i n t e g e r o r B o o l e a n p r o p e r t y i s i n v a l i d ,

t h e d e f a u l t v a l u e w i l l b e u s e d i n s t e a d .

T h e s e i t e m s a r e c a c h e d :

R e p o s i t o r y M I M E t y p e s

R e p o s i t o r y o b j e c t t y p e s

D F C s e s s i o n s e r v i c e t o k e n s f o r l o g g e d - i n u s e r s

1 1


12/35


T a b l e 2 . D o c u m e n t u m C M I S s t a r t u p p r o p e r t i e s

N a m e D e s c r i p t i o n D e f a u l t

v a l u e

P e r m i s -

s i b l e v a l -

u e s |

r a n g e

s e c u r i t y

. c o n g u r a t i o n . l e

R e q u i r e d . F i l e n a m e o f s e c u r i t y ( X W S - S e c u r i t y )

c o n g u r a t i o n f o r S O A P b i n d i n g w e b s e r v i c e s .

.

c m i s - s e c u r i t y

. x m l ( i n

c m i s - w s

- b i n d i n g

. j a r )

s e c u r i t y

l e n a m e

s t r i n g

c m i s . m i m e _ t y p e

. c a c h e _ e x p i r a t i o n

_ a f t e r _ x _ s e c o n d s

I n d i c a t e s t h e e x p i r a t i o n t i m e o u t f o r M I M E t y p e

c a c h e .

R e p o s i t o r y M I M E t y p e s a r e c a c h e d i n m e m o r y t o

h e l p w i t h p e r f o r m a n c e .

T h i s p r o p e r t y s p e c i e s h o w o f t e n t h e M I M E t y p e

c a c h e i s u s h e d .

3 , 6 0 0 1 -

8 , 6 4 0 , 0 0 0

( 1 0 0 d a y s

)

c m i s . t o k e n . c a c h e _ e x p i r a t i o n _ a f t e r _ x

_ s e c o n d s

I n d i c a t e s t h e e x p i r a t i o n t i m e o u t f o r s e r v i c e t o k e n c a c h e .

S e r v i c e t o k e n s f o r l o g i n u s e r s a r e c a c h e d i n

m e m o r y t o s a v e t h e c o s t o f n e w D F C s e s s i o n s .

T h i s p r o p e r t y s p e c i e s h o w o f t e n t h e s e r v i c e

t o k e n i s u s h e d .

3 , 6 0 0 1 - 8 , 6 4 0 , 0 0 0

( 1 0 0 d a y s

)

c m i s . t y p e _ i n f o

. c a c h e _ e x p i r a t i o n

_ a f t e r _ x _ s e c o n d s

I n d i c a t e s t h e e x p i r a t i o n t i m e o u t ( i n s e c o n d s ) f o r

t h e C M I S t y p e d e n i t i o n c a c h e .

W h e n t h e s p e c i e d i n t e r v a l h a s e l a p s e d a n d i f

t h e r e p o s i t o r y s o b j e c t t y p e s h a v e c h a n g e d , t h e n t h e C M I S t y p e d e n i t i o n c a c h e i s u s h e d a n d

r e l o a d e d w i t h t h e u p d a t e d o b j e c t t y p e s f r o m t h e

r e p o s i t o r y . A l l r e q u e s t s t h a t r e q u i r e a c c e s s t o t h e

t y p e d e n i t i o n c a c h e a r e b l o c k e d u n t i l t h e c a c h e

i s r e l o a d e d .

T h e r e p o s i t o r y s o b j e c t t y p e d e n i t i o n s a r e

c a c h e d i n m e m o r y t o i m p r o v e p e r f o r m a n c e . I n

a d d i t i o n , o b j e c t t y p e a n d p r o p e r t y d e n i t i o n s a r e

l o a d e d i n t o t h e c a c h e l a z i l y .

Y o u m i g h t n e e d t o t u n e t h i s v a l u e t o o p t i m i z e

p e r f o r m a n c e f o r y o u r d e p l o y m e n t .

3 , 6 0 0 1 -

8 , 6 4 0 , 0 0 0

( 1 0 0 d a y s

)

c m i s . m i m e _ t y p e

. c a c h e _ s i z e

T h e c a c h e s i z e f o r m i m e t y p e .

T h e c a c h e s i z e s h o u l d n o t b e l e s s t h a n t h e

r e p o s i t o r y l i s t s i z e .

1 0 1 - 1 0 , 0 0 0

1 2


13/35



v a l u e

P e r m i s -

s i b l e v a l -

u e s |

r a n g e

c m i s . t o k e n . c a c h e

_ s i z e

T h e c a c h e s i z e f o r s e r v i c e t o k e n .



1 0 1 - 1 0 , 0 0 0

c m i s . t y p e _ i n f o

. c a c h e _ s i z e

T h e c a c h e s i z e f o r C M I S t y p e d e n i t i o n .



1 0 1 - 1 0 , 0 0 0

c m i s . d e f a u l t _ m a x

_ i t e m s

T h e d e f a u l t m a x i m u m n u m b e r o f i t e m s i n a

r e t u r n e d c o l l e c t i o n . T h i s v a l u e i s u s e d i f t h e

c l i e n t d o e s n o t p r o v i d e a v a l u e f o r m a x I t e m s .

I f v a l u e = - 1 o r v a l u e = 0 t h e n t h e v a l u e w i l l b e s e t

t o I n t e g e r . M A X _ V A L U E .

M a x i m u m i t e m s d e f a u l t a n d u p p e r l i m i t s e t t i n g s ,

p a g e 1 5 p r o v i d e s d e t a i l e d i n f o r m a t i o n .

1 0 0 - 1 -

I n t e g e r

. M A X

_ V A L U E

c m i s . m a x _ i t e m s

_ u p p e r _ l i m i t

T h e a l l o w e d m a x i m u m v a l u e f o r m a x I t e m s . T h i s

s e t s a n u p p e r l i m i t o n m a x I t e m s p r o v i d e d b y a

c l i e n t .

T h i s s e t t i n g i s r e c o m m e n d e d f o r s y s t e m

s c a l a b i l i t y a n d p e r f o r m a n c e .

I f v a l u e = - 1 o r v a l u e = 0 t h e n t h e v a l u e w i l l b e s e t

t o I n t e g e r . M A X _ V A L U E .

M a x i m u m i t e m s d e f a u l t a n d u p p e r l i m i t s e t t i n g s ,

p a g e 1 5 p r o v i d e s d e t a i l e d i n f o r m a t i o n .

2 , 0 0 0 - 1 -

I n t e g e r

. M A X

_ V A L U E

c m i s . e x c e p t i o n . f u l l

_ m e s s a g e . a p p e n d

I n d i c a t e s w h e t h e r t o o u t p u t e r r o r m e s s a g e s f r o m

l a y e r s b e l o w C M I S ; t h a t i s , D o c u m e n t u m e r r o r

m e s s a g e s .

T h e s e m e s s a g e s c a n h e l p t o i d e n t i f y t h e r o o t

c a u s e o f e x c e p t i o n s .

t r u e t r u e ,

f a l s e

c m i s . a n o n y m o u s

_ a c c e s s

. r e p o s i t o r y [ i n d e x ]

T h e n a m e o f t h e r e p o s i t o r y t o w h i c h t o g r a n t

a n o n y m o u s a c c e s s .

I f o n e r e p o s i t o r y i s c o n g u r e d a s a n o n y m o u s

a c c e s s i b l e , s e t i t s r e p o s i t o r y n a m e h e r e . Y o u

c a n s e t m u l t i p l e r e p o s i t o r i e s f o r a n o n y m o u s

a c c e s s , o r s e t a l l a v a i l a b l e r e p o s i t o r i e s t o b e

a n o n y m o u s l y a c c e s s i b l e ( s e e A n o n y m o u s a c c e s s

s e t t i n g s , p a g e 1 4 .

N o t - S e t v a l i d

r e p o s i t o r y

n a m e

s t r i n g

1 3

14/35



v a l u e

P e r m i s -

s i b l e v a l -

u e s |

r a n g e


_ a c c e s s . p r i n c i p a l . u s e r n a m e [ i n d e x ]

T h e D o c u m e n t u m l o g i n n a m e t o b e u s e d f o r

a n o n y m o u s a c c e s s t o t h e r e p o s i t o r y w i t h t h e s a m e i n d e x . S e e A n o n y m o u s a c c e s s s e t t i n g s ,

p a g e 1 4 .


u s e r l o g i n

n a m e

s t r i n g


_ a c c e s s . p r i n c i p a l

. p a s s w o r d [ i n d e x ]

T h e D o c u m e n t u m p a s s w o r d f o r t h e u s e r l o g i n

w i t h t h e s a m e i n d e x . S e e A n o n y m o u s a c c e s s

s e t t i n g s , p a g e 1 4 .


u s e r

p a s s w o r d

A n o n y m o u s a c c e s s s e t t i n g s

Y o u c a n c o n g u r e a p r i n c i p a l t o a l l o w a c c e s s t o a s i n g l e r e p o s i t o r y , t o m u l t i p l e b u t n o t a l l r e p o s i t o r i e s ,

o r t o a l l a v a i l a b l e r e p o s i t o r i e s .

T o m a k e o n l y o n e r e p o s i t o r y a n o n y m o u s l y a c c e s s i b l e , s e t t h e a n o n y m o u s _ a c c e s s p r o p e r t i e s a s

f o l l o w s :

c m i s . a n o n y m o u s _ a c c e s s . r e p o s i t o r y [ 0 ] = < r e p o n a m e >

c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . u s e r n a m e [ 0 ] = c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . p a s s w o r d [ 0 ] = 

T o e n a b l e a n o n y m o u s a c c e s s t o m u l t i p l e r e p o s i t o r i e s , c o n g u r e e a c h r e p o s i t o r y b y i n c r e m e n t i n g

t h e i n d e x o n t h e p r o p e r t i e s :

c m i s . a n o n y m o u s _ a c c e s s . r e p o s i t o r y [ 0 ] = < r e p o n a m e > c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . u s e r n a m e [ 0 ] = c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . p a s s w o r d [ 0 ] = c m i s . a n o n y m o u s _ a c c e s s . r e p o s i t o r y [ 1 ] = < r e p o n a m e 1 > c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . u s e r n a m e [ 1 ] = c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . p a s s w o r d [ 1 ] = 

I f a l l r e p o s i t o r i e s a v a i l a b l e t o t h e C M I S s e r v i c e s a l l o w a n o n y m o u s a c c e s s , a n d i f t h e u s e r n a m e a n d

p a s s w o r d f o r t h e p r i n c i p a l a r e t h e s a m e o n a l l r e p o s i t o r i e s , y o u c a n u s e t h e w i l d c a r d , * ( a s t e r i s k ) ,

a s f o l l o w s : c m i s . a n o n y m o u s _ a c c e s s . r e p o s i t o r y [ 0 ] = * c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . u s e r n a m e [ 0 ] = c m i s . a n o n y m o u s _ a c c e s s . p r i n c i p a l . p a s s w o r d [ 0 ] = 

1 4


15/35


M a x i m u m i t e m s d e f a u l t a n d u p p e r l i m i t s e t t i n g s

T h e C M I S s p e c i c a t i o n d e n e s t h e m a x I t e m s p a r a m e t e r a s t h e m a x i m u m n u m b e r o f i t e m s t o

r e t u r n i n a r e s p o n s e . M a n y C M I S s e r v i c e s / r e s o u r c e s s u p p o r t t h i s p a r a m e t e r f o r p a g i n g p u r p o s e s .

T y p i c a l l y , a C M I S c l i e n t w i l l p r o v i d e a m a x I t e m s s e t t i n g i n r e q u e s t s t o s u c h r e s o u r c e s a n d s e r v i c e s .

H o w e v e r , i n c a s e s w h e n t h e c l i e n t d o e s n o t p r o v i d e a v a l u e f o r m a x I t e m s , C M I S w i l l u s e a d e f a u l t v a l u e . T h e C M I S s e r v e r a d m i n i s t r a t o r c a n s e t t h i s d e f a u l t u s i n g t h e c m i s . d e f a u l t _ m a x _ i t e m s

r u n t i m e p r o p e r t y .

I n s o m e c a s e s a c l i e n t ( p e r h a p s w i t h m a l i c i o u s i n t e n t ) m a y s e t m a x I t e m s t o a n e x c e s s i v e l y l a r g e v a l u e

i n a r e q u e s t , w h i c h m a y n e g a t i v e l y a f f e c t s e r v e r p e r f o r m a n c e . T o g u a r d a g a i n s t t h i s p o s s i b i l i t y , t h e

C M I S s e r v e r a d m i n i s t r a t o r c a n s e t a n u p p e r l i m i t t o m a x I t e m s i n c m i s . m a x _ i t e m s _ u p p e r _ l i m i t .

I f e i t h e r p r o p e r t y h a s a v a l u e o f - 1 o r 0 , C M I S w i l l s e t n o u p p e r b o u n d o n t h e n u m b e r o f i t e m s

r e t u r n e d , s o t h a t t h e e f f e c t i v e l i m i t i s I n t e g e r . M A X _ V A L U E . C M I S d e t e r m i n e s t h e e f f e c t i v e m a x I t e m s

v a l u e u s i n g b o t h o f t h e s e p r o p e r t y s e t t i n g s , a s f o l l o w s :

m a x I t e m s = M I N ( c l i e n t _ o r _ d e f a u l t _ m a x _ i t e m s , s e r v e r _ m a x _ i t e m s _ u p p e r _ l i m i t ) , w h e r e a v a l u e o f - 1 o r 0 i s t r e a t e d a s e q u i v a l e n t t o I n t e g e r . M A X _ V A L U E

1 5


16/35


1 6


17/35

C h a p t e r 3

C o n g u r i n g K e r b e r o s S S O


O v e r v i e w , p a g e 1 7

C o n g u r i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N a n d * . k e y t a b l e , p a g e 1 8

C o n g u r i n g t h e a p p l i c a t i o n s e r v e r f o r K e r b e r o s , p a g e 2 0

L o g g i n g f o r K e r b e r o s , p a g e 2 5

P e r f o r m a n c e b e s t p r a c t i c e s , p a g e 2 5

O v e r v i e w

E M C D o c u m e n t u m s u p p o r t s K e r b e r o s s e c u r e S i n g l e - S i g n - O n ( S S O ) u s i n g M i c r o s o f t A c t i v e S e r v e r

D o m a i n S e r v i c e s f o r K e r b e r o s K e y D i s t r i b u t i o n C e n t e r ( K D C ) s e r v i c e s i n t h e f o l l o w i n g w a y s :

I n a s i n g l e d o m a i n .

I n t w o - w a y t r u s t s b e t w e e n m u l t i p l e d o m a i n s i n t h e s a m e f o r e s t o n l y ; t h a t i s , c r o s s - f o r e s t t r u s t s a r e n o t s u p p o r t e d .

N o t e : I n a d d i t i o n , t h e C M I S c l i e n t a n d s e r v e r m u s t b e i n t h e s a m e d o m a i n , w h e r e a s C o n t e n t S e r v e r

c a n b e i n a d i f f e r e n t d o m a i n .

T o s u p p o r t K e r b e r o s a u t h e n t i c a t i o n , D o c u m e n t u m C M I S p r o v i d e s s e r v e r - s i d e J A X - W S h a n d l e r

f o r S O A P b i n d i n g a n d t h e S e r v l e t l t e r f o r A t o m P u b b i n d i n g . T h e K e r b e r o s t o k e n i s u s e d f o r

a u t h e n t i c a t i o n , b u t n o t f o r m e s s a g e e n c r y p t i o n . O n l y B A S E 6 4 d e c o d i n g i s s u p p o r t e d . T h e f u l l n a m e

o f E n c o d i n g T y p e i s :

h t t p : / / d o c s . o a s i s - o p e n . o r g / w s s / 2 0 0 4 / 0 1 / o a s i s - 2 0 0 4 0 1 - w s s - s o a p - m e s s a g e - s e c u r i t y - 1 . 0 # B A S E 6 4 B i n

P r o c e d u r e t o e n a b l e K e r b e r o s S S O

Y o u m u s t e n a b l e K e r b e r o s S S O b e f o r e d e p l o y i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n .

M a k e s u r e t h a t y o u h a v e c o n g u r e d t h e f o l l o w i n g c o m p o n e n t s :

( R e q u i r e d f o r c r o s s - d o m a i n s u p p o r t o n l y ) T w o - w a y t r u s t s b e t w e e n a l l a p p l i c a b l e d o m a i n s i n

t h e s a m e f o r e s t .

1 7


18/35


N o t e : I n a d d i t i o n , t h e D o c u m e n t u m C M I S c l i e n t a n d D o c u m e n t u m C M I S w e b a p p l i c a t i o n s e r v e r

m u s t b e i n t h e s a m e d o m a i n , w h e r e a s C o n t e n t S e r v e r c a n b e i n a d i f f e r e n t d o m a i n .

K e r b e r o s S S O o n C o n t e n t S e r v e r

N o t e : T h e E M C D o c u m e n t u m C o n t e n t S e r v e r A d m i n i s t r a t i o n a n d C o n f g u r a t i o n G u i d e p r o v i d e s

d e t a i l e d i n f o r m a t i o n .

1 . R e g i s t e r t h e C M I S w e b a p p l i c a t i o n s s e r v i c e p r i n c i p a l n a m e ( S P N ) i n t h e A c t i v e D i r e c t o r y a n d

g e n e r a t e a * . k e y t a b l e . S e e C o n g u r i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N a n d

* . k e y t a b l e , p a g e 1 8 .

2 . E n a b l e t h e a p p l i c a t i o n s e r v e r f o r K e r b e r o s . S e e C o n g u r i n g t h e a p p l i c a t i o n s e r v e r f o r K e r b e r o s ,

p a g e 2 0 .

C o n g u r i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N a n d * . k e y t a b l e

T o e n a b l e a u t h e n t i c a t i o n o f t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n o n t h e K e r b e r o s K e y D i s t r i b u t i o n

C e n t e r ( K D C ) , r e g i s t e r t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s s e r v i c e p r i n c i p a l n a m e ( S P N ) o n

t h e A c t i v e S e r v e r K D C u s i n g t h e M i c r o s o f t k t p a s s u t i l i t y . A K e r b e r o s S P N u n i q u e l y i d e n t i e s a

s e r v i c e t h a t u s e s K e r b e r o s a u t h e n t i c a t i o n . I n t h i s c a s e , t h e s e r v i c e i s t h e D o c u m e n t u m C M I S w e b

a p p l i c a t i o n . E x e c u t i n g t h e k t p a s s u t i l i t y a l s o g e n e r a t e s a * . k e y t a b l e . T h e * . k e y t a b l e

c o n t a i n s n a m e / v a l u e p a i r s c o n s i s t i n g o f a n S P N a n d a l o n g - t e r m k e y d e r i v e d f r o m a p a s s w o r d .

B o t h t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n a n d t h e K D C m u s t b e a b l e t o a c c e s s t h e * . k e y t a b

l e . Y o u c o p y t h e * . k e y t a b l e t o t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n m a c h i n e ( t h e m a c h i n e

w h e r e t h e K e r b e r o s s e r v i c e t i c k e t ( S T ) i s v a l i d a t e d ) a n d s p e c i f y t h e l o c a t i o n o f t h e * . k e y t a b l e

i n t h e J A A S c o n g u r a t i o n .

N o t e : A l t h o u g h t h e * . k e y t a b l e i s u s u a l l y u s e d o n n o n - W i n d o w s m a c h i n e s , D o c u m e n t u m C M I S l e v e r a g e s t h e * . k e y t a b l e t o i m p r o v e n e t w o r k p e r f o r m a n c e b y e l i m i n a t i n g K e r b e r o s a u t h e n t i c a t i o n

c o m m u n i c a t i o n b e t w e e n W i n d o w s m a c h i n e s a n d t h e K D C .

I n s o m e c a s e s , y o u c a n r e g i s t e r t h e S P N s o f m o r e t h a n o n e D o c u m e n t u m C M I S w e b a p p l i c a t i o n t o t h e

s a m e a c c o u n t . F o r e x a m p l e , i n l o a d - b a l a n c e d e n v i r o n m e n t s s u p p o r t f o r K e r b e r o s c a n b e a c h i e v e d

b y j o i n i n g a l l l o a d - b a l a n c e d n o d e s i n t o a s i n g l e a c c o u n t a n d a s s i g n i n g a s i n g l e S P N t o t h e c l u s t e r .

I f a c c e s s t o t h e s e r v i c e i s r e q u i r e d t h r o u g h a d i f f e r e n t S P N ( f o r e x a m p l e , b a s e d o n t h e s e r v i c e h o s t

I P a d d r e s s r a t h e r t h a n t h e l o a d b a l a n c e r n a m e ) , t h e n t h i s S P N c a n a l s o b e r e g i s t e r e d w i t h t h e s a m e

a c c o u n t . T h e f o l l o w i n g p r o c e d u r e d e s c r i b e s t h e m a i n s t e p s f o r r e g i s t e r i n g a n S P N u s i n g a o n e - t o - o n e

m a p p i n g b e t w e e n t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N a n d u s e r a c c o u n t , o r a m a n y - t o - o n e

m a p p i n g i n w h i c h m u l t i p l e S P N s a r e r e g i s t e r e d t o o n e u s e r a c c o u n t .

T o c o n g u r e t h e S P N a n d k e y t a b l e ( m a i n s t e p s ) :

1 . C r e a t e a u s e r ( o r u s e a n e x i s t i n g o n e ) f o r t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n i n t h e A c t i v e

D i r e c t o r y .

N o t e : M a k e s u r e t o e n a b l e d e l e g a t i o n t r u s t f o r t h e s e r v i c e a c c o u n t s w h o c r e a t e t h e S P N s .

2 . M a p t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N t o a u s e r a n d g e n e r a t e t h e * . k e y t a b l e .

S e e M a p p i n g t h e S P N t o a u s e r n a m e , p a g e 1 9 .

1 8

19/35


M a p p i n g t h e S P N t o a u s e r n a m e

T h e r e c o m m e n d e d S P N f o r m a t f o r a D o c u m e n t u m C M I S w e b a p p l i c a t i o n i s :

H T T P / < h o s t > : @ < R E A L M >

w h e r e : < h o s t _ n a m e > i s t h e n a m e o f t h e m a c h i n e o n w h i c h t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n i s

d e p l o y e d . E M C r e c o m m e n d s u s i n g a h o s t n a m e r a t h e r t h a n a n I P a d d r e s s a s t h e h o s t s t r i n g .

F o r e x a m p l e , m y h o s t . m y d o m a i n . c o m . r e a l m i s t h e n a m e o f t h e K e r b e r o s r e a l m , w h i c h i s

d e n e d i n t h e K e r b e r o s c o n g u r a t i o n l e ( s e e C o n g u r i n g k r b 5 . i n i a n d c m i s - r u n t i m e . p r o p e r t i e s

l e s , p a g e 2 0 ) .

 i s t h e p o r t a t w h i c h t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n i s l i s t e n i n g .

N o t e : W h e n u s i n g W i n d o w s I n t e g r a t e d S e c u r i t y , I n t e r n e t E x p l o r e r u s e s t h e H T T P - s e r v i c e - t y p e o f

S P N t o r e q u e s t s e r v i c e t i c k e t s a n d t o p r o c e s s r e q u e s t s . T h e r e f o r e , u s i n g t h e H T T P p r o t o c o l i n t h e S P N

i s m o r e a p p r o p r i a t e a n d c o n s i s t e n t f o r b o t h t h e C M I S S O A P a n d H T T P p r o t o c o l s .

T o m a p t h e S P N t o a u s e r n a m e :

N o t e :

B y d e f a u l t , W i n d o w s S e r v e r 2 0 0 8 R 2 S P 1 d o e s n o t s u p p o r t D E S - r e l a t e d c i p h e r s ( f o r e x a m p l e ,

D E S - C B C - M D 5 ) . h t t p : / / t e c h n e t . m i c r o s o f t . c o m / e n - u s / l i b r a r y / d d 5 6 0 6 7 0 ( v = W S . 1 0 ) . a s p x p r o v i d e s

d e t a i l e d i n f o r m a t i o n a b o u t D E S - r e l a t e d c i p h e r s o n W i n d o w s S e r v e r 2 0 0 8 .

F o r t h e k t p a s s u t i l i t y s y n t a x , s e e h t t p : / / t e c h n e t . m i c r o s o f t . c o m / e n - u s / l i b r a r y / c c 7 5 3 7 7 1 % 2 8 v = W S

. 1 0 % 2 9 . a s p x .

1 . P e r f o r m o n e o f t h e f o l l o w i n g t a s k s :

T o m a p t h e S P N t o a u s e r n a m e u s i n g a o n e - t o - o n e m a p p i n g , e x e c u t e t h e k t p a s s u t i l i t y

a s f o l l o w s :

N o t e : F o r a o n e - t o - o n e m a p p i n g , d o n o t m a p t h e s a m e S P N t o m o r e t h a n o n e u s e r a c c o u n t .

k t p a s s / p a s s - o u t < k e y t a b _ f i l e > - p r i n c < S P N > - c r y p t o < c r y p t o _ t y p e > + D u m p S a l t - p t y p e K R B 5 _ N T _ P R I N C I P A L + d e s O n l y

/ m a p O p s e t / m a p U s e r / t a r g e t < d o m a i n _ c o n t r o l l e r >

T o m a p m u l t i p l e S P N s t o a u s e r n a m e u s i n g m a n y - t o - o n e m a p p i n g , p e r f o r m t h e f o l l o w i n g

s t e p s :

a . E x e c u t e t h e k t p a s s u t i l i t y a s f o l l o w s :

k t p a s s / p a s s - o u t < k e y t a b _ f i l e > - p r i n c < S P N > - c r y p t o < c r y p t o _ t y p e > + D u m p S a l t - p t y p e K R B 5 _ N T _ P R I N C I P A L + d e s O n l y / m a p O p s e t / m a p U s e r / t a r g e t < d o m a i n _ c o n t r o l l e r >

R e m e m b e r t h e s a l t s t r i n g a n d t h e k e y v e r s i o n n u m b e r ( v n o ) b e c a u s e y o u n e e d t o u s e

t h e m i n s t e p c .

b . T o m a p t h e n e x t S P N t o t h e s a m e u s e r a c c o u n t , e x e c u t e t h e s e t s p n u t i l i t y a s f o l l o w s :

s e t s p n - A < S P N > 

c . E x e c u t e k t p a s s u t i l i t y f o r t h e s e c o n d S P N w i t h o u t s e t t i n g w i t h t h e s a m e u s e r a s f o l l o w s :

N o t e : . U s e t h e s a l t a n d k e y v e r s i o n n u m b e r ( k v n o ) t h a t w e r e d i s p l a y e d a s t h e o u t p u t

i n s t e p a .

1 9
http://technet.microsoft.com/en-us/library/cc753771(v=WS.10).aspxhttp://technet.microsoft.com/en-us/library/cc753771(v=WS.10).aspxhttp://technet.microsoft.com/en-us/library/cc753771(v=WS.10).aspxhttp://technet.microsoft.com/en-us/library/cc753771(v=WS.10).aspxhttp://technet.microsoft.com/en-us/library/dd560670(v=WS.10).aspx

20/35


k t p a s s / p a s s - o u t < k e y t a b _ f i l e > - p r i n c < S P N > - c r y p t o < c r y p t o _ t y p e > + D u m p S a l t - p t y p e K R B 5 _ N T _ P R I N C I P A L + d e s O n l y / m a p O p s e t + R a w S a l t < s a l t > - i n < k e y t a b _ f i l e > - k v n o < v n o >

d . R e p e a t S t e p s b a n d c f o r e a c h a d d i t i o n a l S P N .

C o n g u r i n g t h e a p p l i c a t i o n s e r v e r f o r K e r b e r o s

T o e n a b l e K e r b e r o s o n t h e a p p l i c a t i o n s e r v e r , p e r f o r m t h e f o l l o w i n g t a s k s :

C o n g u r i n g k r b 5 . i n i a n d c m i s - r u n t i m e . p r o p e r t i e s l e s , p a g e 2 0

C o n g u r i n g t h e J A A S . c o n f l e , p a g e 2 2

C o n g u r i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n , p a g e 2 4

C o n g u r i n g k r b 5 . i n i a n d c m i s - r u n t i m e . p r o p e r t i e s l e s

1 . F o r t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n t o p e r f o r m K e r b e r o s d e l e g a t i o n , s e t t h e f o l l o w i n g

p r o p e r t i e s i n c m i s - r u n t i m e . p r o p e r t i e s :

F o r s i n g l e - d o m a i n s u p p o r t :

T a b l e 3 . P r o p e r t i e s i n c m i s - r u n t i m e . p r o p e r t i e s f o r K e r b e r o s S i n g l e - d o m a i n S u p p o r t

P r o p e r t y D e s c r i p t i o n

c m i s . s p n T h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s

S P N a s s p e c i e d i n M a p p i n g t h e S P N t o a

u s e r n a m e , p a g e 1 9 . T h e s y n t a x i s :

H T T P / < H O S T N A M E > : @ < R E A L M >

c m i s . j a a s . c o n f T h e p a t h t o t h e j a a s . c o n f l e ( f o r e x a m p l e ,

C : / j a a s . c o n f ) .

c m i s . k r b 5 . c o n f T h e p a t h t o t h e k r b 5 . i n i l e ( f o r e x a m p l e ,

C : / W i n d o w s / k r b 5 . i n i ) .

F o r m u l t i - d o m a i n s u p p o r t :

T a b l e 4 . P r o p e r t i e s i n c m i s - r u n t i m e . p r o p e r t i e s f o r K e r b e r o s M u l t i - d o m a i n S u p p o r t


c m i s . s p n T h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s

S P N a s s p e c i e d i n M a p p i n g t h e S P N t o a

u s e r n a m e , p a g e 1 9 . T h e s y n t a x i s :

H T T P / < H O S T N A M E > : 

2 0

21/35



c m i s . j c s i . n a m e s e r v e r I P a d d r e s s e s f o r K e r b e r o s n a m e s e r v e r s .

c m i s . j c s i . m a x p a c k e t s i z e T h e m a x i m u m p a c k e t s i z e s e t t i n g f o r

m u l t i - d o m a i n K e r b e r o s s u p p o r t . Q U E S T

l i b r a r i e s u s e T C P a s t h e d e f a u l t p r o t o c o l

o v e r U D P f o r c o m m u n i c a t i n g w i t h t h e K D C . I t u s e s N a g l e s a l g o r i t h m w h e n K e r b e r o s

r e q u e s t s a r e s m a l l ( l e s s t h a n a n E t h e r n e t

p a c k e t s i z e ; f o r e x a m p l e , 1 4 2 0 ) a n d c a u s e s

a d e l a y . Q U E S T s t i l l s u p p o r t s U D P i f y o u

w a n t t o u s e t h i s p r o t o c o l . S w i t c h i n g f r o m

T C P t o U D P c a n b e d o n e b y s e t t i n g t h i s

p r o p e r t y . I f t h e p a c k e t s i z e i s l e s s t h a n

o r e q u a l t o t h e v a l u e p r o v i d e d i n t h i s

p r o p e r t y , t h e n t h e Q U E S T l i b r a r y u s e s U D P

t o c o m m u n i c a t e w i t h t h e K D C ; o t h e r w i s e ,

i t u s e s T C P . T h e v a l u e w i l l o v e r w r i t e t h e

j c s i . k e r b e r o s . m a x p a c k e t s i z e s y s t e m

v a r i a b l e . D e f a u l t i s n o t - s e t .

2 . C r e a t e t h e k r b 5 . i n i l e a s f o l l o w s :

N o t e : T h i s l e i s t y p i c a l l y c r e a t e d i n C : \ W i n d o w s .

[ l i b d e f a u l t s ] d e f a u l t _ r e a l m = < R E A L M > f o r w a r d a b l e = t r u e t i c k e t _ l i f e t i m e = 2 4 h c l o c k s k e w = 7 2 0 0 0 d e f a u l t _ t k t _ e n c t y p e s = d e f a u l t _ t g s _ e n c t y p e s =

[ r e a l m s ] < R E A L M > = {k d c = < k d c _ s e r v e r _ i p > a d m i n _ s e r v e r = < a d m i n _ s e r v e r _ i p >

}

[ d o m a i n _ r e a l m ] < d o m a i n > = < R E A L M >

[ l o g g i n g ] d e f a u l t = c : \ k d c . l o g k d c = c : \ k d c . l o g

[ a p p d e f a u l t s ] a u t o l o g i n = t r u e

f o r w a r d = t r u e f o r w a r d a b l e = t r u e e n c r y p t = t r u e

< k d c _ s e r v e r _ i p > T h e I P a d d r e s s o f t h e K D C s e r v e r .

< a d m i n _ s e r v e r _ i p > T h e I P a d d r e s s o f t h e A d m i n i s t r a t i o n s e r v e r .

2 1

22/35


< d o m a i n > T h e d o m a i n i n w h i c h t h e D o c u m e n t u m C M I S

w e b a p p l i c a t i o n s S P N r e s i d e s .

< R E A L M > T h e r e a l m n a m e . F o r e x a m p l e :

M Y D O M A I N . M Y C O R P . C O M

C o n g u r i n g t h e J A A S . c o n f l e

A n a p p l i c a t i o n s e r v e r s J A A S c o n g u r a t i o n l e s p e c i e s p r o p e r t i e s f o r t h e L o g i n C o n t e x t n a m e ,

K e r b e r o s l o g i n m o d u l e , t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N , a n d t h e l o c a t i o n o f t h e

* . k e y t a b l e .

T h e l o c a t i o n a n d f o r m a t o f t h e J A A S c o n g u r a t i o n s e t t i n g s m i g h t b e d i f f e r e n t f o r e a c h a p p l i c a t i o n

s e r v e r . U n l e s s o t h e r w i s e s p e c i e d i n t h e a p p l i c a t i o n s e r v e r d e p l o y m e n t i n s t r u c t i o n s , a c o n g u r a t i o n

l e s e t t i n g c a n a l s o b e s p e c i e d a s f o l l o w s :

I n c m i s - r u n t i m e . p r o p e r t i e s

I n a J V M c o m m a n d - l i n e p a r a m e t e r ; f o r e x a m p l e :

- D j a v a . s e c u r i t y . a u t h . l o g i n . c o n f i g = 

E x a m p l e 3 - 1 . S i n g l e - D o m a i n J A A S C o n g u r a t i o n r e f e r r i n g t o S U N J D K

{c o m . s u n . s e c u r i t y . a u t h . m o d u l e . K r b 5 L o g i n M o d u l e r e q u i r e d d e b u g = f a l s e p r i n c i p a l = < S P N > r e f r e s h K r b 5 C o n f i g = t r u e u s e K e y T a b = t r u e s t o r e K e y = t r u e d o N o t P r o m p t = t r u e u s e T i c k e t C a c h e = f a l s e

i s I n i t i a t o r = f a l s e k e y T a b = < c m i s u s e r _ k e y t a b _ p a t h > ;

} ;

E x a m p l e 3 - 2 . S i n g l e - D o m a i n J A A S C o n g u r a t i o n r e f e r r i n g t o I B M J D K

{c o m . i b m . s e c u r i t y . a u t h . m o d u l e . K r b 5 L o g i n M o d u l e r e q u i r e d d e b u g = f a l s e c r e d s T y p e = " b o t h " u s e K e y t a b = < c m i s u s e r _ k e y t a b _ p a t h > p r i n c i p a l = < S P N > ;

} ;

E x a m p l e 3 - 3 . J A A S C o n g u r a t i o n r e f e r r i n g t o Q U E S T L i b r a r i e s w h i c h s u p p o r t b o t h S i n g l e D o m a i n

a n d M u l t i D o m a i n

{c o m . d s t c . s e c u r i t y . k e r b e r o s . j a a s . K e r b e r o s L o g i n M o d u l e r e q u i r e d

d e b u g = f a l s e p r i n c i p a l = < S P N > r e a l m = " C M I S K D C . I I G . E M C . C O M " r e f r e s h K r b 5 C o n f i g = t r u e n o T G T = t r u e

2 2

23/35


u s e K e y T a b = t r u e s t o r e K e y = t r u e d o N o t P r o m p t = t r u e u s e T i c k e t C a c h e = f a l s e i s I n i t i a t o r = f a l s e k e y T a b = < c m i s u s e r _ k e y t a b _ p a t h > ;

} ;

N o t e : I n W e b S p h e r e A p p l i c a t i o n S e r v e r , t h e J A A S c o n g u r a t i o n m u s t b e s p e c i e d i n

< W A S _ I n s t a l l a t i o n _ p a t h > \ A p p S e r v e r \ p r o f i l e s \ < A P P _ S E R V E R _ N O D E _ N A M E >

\ p r o p e r t i e s \ w s j a a s . c o n f .

< l o g i n C o n t e x t > C o r r e s p o n d s t o t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N . Y o u r e p l a c e

s e p a r a t o r c h a r a c t e r s w i t h h y p h e n c h a r a c t e r s a n d o m i t t h e @ R E A L M s e g m e n t

i n t h e S P N . F o r e x a m p l e , t h e f o l l o w i n g L o g i n C o n t e x t i s d e r i v e d f r o m t h e

c o r r e s p o n d i n g S P N :

L o g i n C o n t e x t :

H T T P - m y h o s t - m y d o m a i n - c o m - 8 0 8 0

S P N :

H T T P / m y h o s t . m y d o m a i n . c o m : 8 0 8 0 @ M Y D O M A I N . M Y C O R P . C O M

N o t e : M a k e s u r e t h a t t h e S P N i n t h e J A A S c o n g u r a t i o n m a t c h e s t h e S P N

d e n e d i n c m i s - r u n t i m e . p r o p e r t i e s ( s e e C o n g u r i n g k r b 5 . i n i a n d

c m i s - r u n t i m e . p r o p e r t i e s l e s , p a g e 2 0 ) .

S p e c i f y t h e K e r b e r o s l o g i n m o d u l e t o b e u s e d t o p e r f o r m u s e r a u t h e n t i c a t i o n .

S i n g l e D o m a i n :

R e f e r r i n g t o S u n J D K :

c o m . s u n . s e c u r i t y . a u t h

. m o d u l e . K r b 5 L o g i n M o d u l e

R e f e r r i n g t o I B M J D K :

c o m . i b m . s e c u r i t y . a u t h

. m o d u l e . K r b 5 L o g i n M o d u l e

R e f e r r i n g t o Q U E S T L i b r a r i e s :

c o m . d s t c . s e c u r i t y

. k e r b e r o s . j a a s

. K e r b e r o s L o g i n M o d u l e

M u l t i - D o m a i n :

c o m . d s t c . s e c u r i t y . k e r b e r o s

. j a a s . K e r b e r o s L o g i n M o d u l e

< L o g i n M o d u l e >

N o t e : F o r Q U E S T l o g i n m o d u l e s , i f y o u w a n t t o e n a b l e t i c k e t c a c h e , p e r f o r m

o n e o f t h e f o l l o w i n g o p e r a t i o n s . O t h e r w i s e , d i s a b l e t i c k e t c a c h e b y s e t t i n g

u s e T i c k e t C a c h e t o f a l s e .

E n a b l e c r e a t e T i c k e t C a c h e :

u s e T i c k e t C a c h e = t r u e

c r e a t e T i c k e t C a c h e = t r u e

E n a b l e c r e a t e T i c k e t C a c h e a n d s p e c i f y a c a c h e p a t h :

2 3

24/35


u s e T i c k e t C a c h e = t r u e

c r e a t e T i c k e t C a c h e = t r u e

t i c k e t C a c h e = < c a c h e _ p a t h >

< S P N > T h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n s S P N .

F o r e x a m p l e , f o r S U N a n d I B M l o g i n m o d u l e s :

H T T P / m y h o s t . m y d o m a i n . c o m : 8 0 8 0 @ M Y D O M A I N . M Y C O R P . C O M

F o r Q U E S T l o g i n m o d u l e s , t h e S P N d o e s n o t c o n t a i n t h e @ c h a r a c t e r a n d

t h e s t r i n g a f t e r t h a t . F o r e x a m p l e :

H T T P / m y h o s t . m y d o m a i n . c o m : 8 0 8 0

< R E A L M > ( M u l t i - d o m a i n s u p p o r t o n l y ) T h e r e a l m n a m e . F o r e x a m p l e :

@ M Y D O M A I N . M Y C O R P . C O M

< c m i s u s e r _ k e y t a b

_ p a t h >

T h e p a t h t o t h e u s e r a c c o u n t s * . k e y t a b l e o n t h e D o c u m e n t u m C M I S

w e b a p p l i c a t i o n . F o r e x a m p l e : c : \ c m i s u s e r . k e y t a b

C o n g u r i n g t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n

M a k e t h e f o l l o w i n g c h a n g e s t o t h e D o c u m e n t u m C M I S w e b a p p l i c a t i o n a n d r e d e p l o y i t .

1 . F o r S O A P b i n d i n g , c h a n g e a u t h o r i z e d - s e r v i c e - h a n d l e r - c h a i n . x m l ( i n

c m i s - w s - b i n d i n g . j a r ) t o s p e c i f y t h e c l a s s i n b o l d :

N o t e : M a k e s u r e t h a t y o u d o n o t s p e c i f y t h e U s e r n a m e T o k e n h a n d l e r i n a d d i t i o n t o t h e K e r b e r o s

T o k e n h a n d l e r .

< h a n d l e r - c h a i n s x m l n s = " h t t p : / / j a v a . s u n . c o m / x m l / n s / j a v a e e " >

< h a n d l e r - c h a i n > < h a n d l e r >

< ! - - E n a b l e K e r b e r o s a u t h e n t i c a t i o n - - > < h a n d l e r - n a m e &

docu57844 documentum conteddddnt management interoperability services 7.2 deployment guide

Documents