documentum d2 4.2 installation guide

8/16/2019 Documentum D2 4.2 Installation Guide

1/135

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

D 2

V e r s i o n 4 . 2

I n s t a l l a t i o n 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/135

L e g a l N o t i c e

C o p y r i g h t © 2 0 0 5 – 2 0 1 4 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/135

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

C h a p t e r 1 G e t t i n g S t a r t e d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

K n o w B e f o r e Y o u S t a r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

P r e p a r i n g f o r I n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

U p g r a d i n g D 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0

I n s t r u c t i o n s f o r I n s t a l l i n g D 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1

C h a p t e r 2 I n s t a l l i n g D 2 o n t h e C o n t e n t S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5

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

W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 I n s t a l l i n g D 2 w i t h o u t D o c u m e n t u m P r o c e s s E n g i n e C o m p a t i b i l i t y o n a L i n u x

E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7

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

W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9

I n s t a l l i n g D 2 w i t h D o c u m e n t u m P r o c e s s E n g i n e C o m p a t i b i l i t y o n a L i n u x

E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0

C o n g u r i n g L o c k b o x o n t h e D o c u m e n t u m C o n t e n t S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 3

D e p l o y i n g D A R F i l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 6

C h a p t e r 3 C r e a t i n g D 2 W A R F i l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 9

C r e a t i n g D 2 W A R F i l e s o n a W e b A p p l i c a t i o n S e r v e r U s i n g M i c r o s o f t

W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 9

C r e a t i n g D 2 W A R F i l e s o n a W e b A p p l i c a t i o n S e r v e r U s i n g a L i n u x

E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1

C r e a t i n g D 2 W A R F i l e s o n a W e b A p p l i c a t i o n S e r v e r U s i n g I B M A I X . . . . . . . . . . . . . . . . . . . 3 3

C h a p t e r 4 I n s t a l l i n g D 2 o n t h e W e b A p p l i c a t i o n S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 7

I n s t a l l i n g D 2 o n A p a c h e T o m c a t f o r M i c r o s o f t W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 7

I n s t a l l i n g D 2 o n A p a c h e T o m c a t f o r a L i n u x E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 8

I n s t a l l i n g D 2 o n I B M W e b S p h e r e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 9

I n s t a l l i n g D 2 o n O r a c l e W e b L o g i c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1

I n s t a l l i n g D 2 o n R e d h a t J B O S S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2

I n s t a l l i n g D 2 o n V M w a r e v F a b r i c t c S e r v e r f o r M i c r o s o f t W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . 4 3

C o n g u r i n g L o c k b o x o n t h e W e b A p p l i c a t i o n S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4

C h a p t e r 5 C o n g u r i n g D 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 7

I n s t a l l a t i o n V a l i d a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 7

C o n g u r i n g D 2 C o n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5

E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e

3


4/135


C o n g u r i n g D 2 C l i e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 8

C o n g u r i n g D 2 J a v a M e t h o d S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1

S t o r i n g P a s s w o r d s i n t h e D 2 L o c k b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1

F i l e T r a n s f e r M o d e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 4

C o n g u r i n g F i l e T r a n s f e r M o d e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 4 I n s t a l l i n g D 2 C o n g L a n g u a g e P a c k s ( F r e n c h - o n l y ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 4

I n s t a l l i n g D 2 C l i e n t L a n g u a g e P a c k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 5

M o d i f y i n g L a n g u a g e P a c k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6

C o n g u r i n g l o g b a c k . x m l f o r t h e C o n t e n t S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6

R e m o v i n g D e b u g L o g s f r o m t h e J B o s s 7 . 1 . 1 J M S L o g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7

C o n g u r i n g D o c u m e n t u m C o n t e n t S e r v e r s e r v e r . i n i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7

C o n g u r i n g D 2 A u d i t i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 8

C o n g u r i n g A p p l i c a t i o n S e r v e r P o o l i n g S e s s i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 8

D i s a b l i n g x Q u e r y w h e n U s i n g t h e x P l o r e S e a r c h E n g i n e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 8

C o n g u r i n g D 2 f o r D o c u m e n t u m C o n n e c t o r f o r S y n c p l i c i t y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 9

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

( I R M ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 9

C o n g u r i n g t h e D 2 E v e n t S e n d e r M a i l M e t h o d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 0

C h a p t e r 6 B e s t P r a c t i c e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1

E n a b l i n g C o m p r e s s i o n a t t h e A p p l i c a t i o n S e r v e r w h e n u s i n g A p a c h e T o m c a t

o r J B o s s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1

O p t i m i z i n g P e r f o r m a n c e f o r W i d g e t s a n d L a r g e N u m b e r s o f C o n t e n t . . . . . . . . . . . . . . . . . . . 7 2

I m p r o v i n g C o n t e n t T r a n s f e r P e r f o r m a n c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 3

G e n e r a l T u n i n g T i p s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 3

C h a p t e r 7 C o n g u r i n g A u t h e n t i c a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 5

S i n g l e S i g n O n ( S S O ) A u t h e n t i c a t i o n f o r D 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 5

C o n g u r i n g M i c r o s o f t W i n d o w s N T U n i e d L o g o n ( N T L M ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 5

C o n g u r i n g K e r b e r o s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 6

C o n g u r i n g T r u s t e d R e v e r s e P r o x y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 8

A d d i n g t h e A d m i n i s t r a t o r L o g i n N a m e t o t h e d 2 f s - t r u s t . p r o p e r t i e s l e . . . . . . . . . . . . . . . . . . . 7 9

A d d i n g t h e A d m i n i s t r a t o r P a s s w o r d t o t h e D 2 L o c k b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 9

C o n g u r i n g t h e S h i r o . i n i l e f o r I n t e r o p e r a b i l i t y w i t h D 2 - C o n g a n d t h e

D o c u m e n t u m M e t h o d S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 9

C h a p t e r 8 I n s t a l l i n g C 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 1

I n s t a l l i n g t h e C 2 P l u g - i n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 1

I n s t a l l i n g C 2 L i b r a r i e s o n M i c r o s o f t W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2

I n s t a l l i n g C 2 L i b r a r i e s o n a L i n u x E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 3

C h a p t e r 9 I n s t a l l i n g O 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5

I n s t a l l i n g t h e O 2 P l u g - i n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5

4 E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e


5/135


I n s t a l l i n g O 2 L i b r a r i e s o n M i c r o s o f t W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 6

I n s t a l l i n g O 2 L i b r a r i e s o n a L i n u x E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 8

C h a p t e r 1 0 I n s t a l l i n g D 2 - B i n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1

I n s t a l l i n g t h e D 2 - B i n P l u g - i n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1

I n s t a l l i n g D 2 - B i n o n M i c r o s o f t W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2 I n s t a l l i n g D 2 - B i n o n a L i n u x E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3

C h a p t e r 1 1 I n s t a l l i n g D 2 R P S C o n n e c t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 5

I n s t a l l i n g t h e D 2 R P S C o n n e c t o r P l u g - i n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 5

I n s t a l l i n g D 2 R P S C o n n e c t o r L i b r a r i e s o n M i c r o s o f t W i n d o w s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 6

I n s t a l l i n g D 2 R P S C o n n e c t o r L i b r a r i e s o n a L i n u x E n v i r o n m e n t . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 8

C h a p t e r 1 2 I n s t a l l i n g D 2 - B O C S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 1

U n d e r s t a n d i n g D o c u m e n t u m B r a n c h O f c e C a c h i n g S e r v e r s ( B O C S ) . . . . . . . . . . . . . . . . 1 0 1

I n s t a l l i n g t h e D 2 - B O C S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 2

I n s t a l l i n g D 2 – B O C S o n a B O C S S e r v e r f o r D o c u m e n t u m C o n t e n t S e r v e r 6 . 7

S P 2 a n d O l d e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 3

I n s t a l l i n g D 2 – B O C S o n a B O C S S e r v e r f o r D o c u m e n t u m C o n t e n t S e r v e r

7 . 0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 4

I n s t a l l i n g D 2 – B O C S o n a B O C S S e r v e r f o r D o c u m e n t u m C o n t e n t S e r v e r

7 . 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 5

I n s t a l l i n g D 2 – B O C S o n a n A C S s e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 6

C o n g u r i n g D 2 C l i e n t f o r B O C S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 7

C o n g u r i n g L o c k b o x f o r B O C S a n d A C S S e r v e r s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 8

C o n g u r i n g O 2 f o r B O C S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 2

C o n g u r i n g C 2 f o r B O C S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 4

C h e c k i n g D 2 - B O C S I n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 6

E n a b l i n g B O C S C o n t e n t T r a n s f e r w i t h N o n - A n o n y m o u s C e r t i c a t e B a s e d

S S L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 7

E n a b l i n g C o m p r e s s i o n f o r U p l o a d a n d D o w n l o a d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 7

E n a b l i n g A s y n c h r o n o u s B O C S W r i t e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 8

B O C S a n d A C S N e t w o r k L o c a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 8

S e t t i n g t h e B O C S a n d A C S N e t w o r k L o c a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 9

U s i n g D 2 - B O C S f o r D o w n l o a d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 9

U s i n g D 2 - B O C S f o r U p l o a d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 1

C h a p t e r 1 3 U n i n s t a l l i n g D 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 3

U n i n s t a l l i n g D 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 3

C h a p t e r 1 4 T r o u b l e s h o o t i n g t h e I n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 5

U n a b l e t o A c c e s s D 2 U s i n g M i c r o s o f t I n t e r n e t E x p l o r e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 5

C o n g u r i n g M i c r o s o f t S Q L S e r v e r 2 0 0 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 6

E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e

5


6/135


U n a b l e t o O p e n a N e w W i n d o w o r N e w C o n n e c t i o n . N o R e s o u r c e

A v a i l a b l e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 6

D f R e g i s t r y W i n 3 2 . D L L i s A l r e a d y L o a d e d i n A n o t h e r C l a s s l o a d e r . . . . . . . . . . . . . . . . . . . . . . . 1 2 7

I B M A I X a n d A p a c h e T o m c a t 6 . 0 C r a s h i n g t h e S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 7

F i l e s C o r r u p t i n g D u r i n g E x p o r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 8 D 2 C a c h i n g a n d F i l e - C l e a n i n g S e r v i c e s F a i l t o O p e r a t e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 9

N u l l P o i n t e r E x c e p t i o n W h e n U s i n g R e v e r s e - p r o x y I I S 7 t o I m p o r t a F i l e L a r g e r

T h a n 2 5 M B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 9

C o n t e n t T r a n s f e r D o e s N o t G o T h r o u g h t h e B O C S S e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 0

S l o w F i l e T r a n s f e r W h e n U s i n g a L i n u x - b a s e d O p e r a t i n g S y s t e m . . . . . . . . . . . . . . . . . . . . . . 1 3 0

j a v a . l a n g . C l a s s N o t F o u n d E x c e p t i o n w h e n R u n n i n g a n I n s t a l l e r P a c k a g e . . . . . . . . . . . . 1 3 1

N o J M S S e r v e r A v a i l a b l e E x c e p t i o n W h e n T r y i n g J a v a M e t h o d S e r v e r ( J M S )

F a i l o v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 2

U n a b l e t o L o g i n t o D 2 A f t e r I n i t i a l i z i n g L o c k b o x o n O r a c l e W e b l o g i c . . . . . . . . . . . . . . . . . . 1 3 2

U n a b l e t o S e t L o c k b o x P r o p e r t y o n a 6 4 - b i t O p e r a t i n g S y s t e m . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 3

C h a p t e r 1 5 C o n g u r a t i o n F i l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 5

C o n g u r a t i o n F i l e L o c a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 5



7/135

P r e f a c e

E M C ® D o c u m e n t u m ® D 2 c o n s i s t s o f t w o c o m p o n e n t s :

• D 2 C o n g u r a t i o n : T h e w e b - b a s e d a p p l i c a t i o n , h e r e a f t e r k n o w n a s D 2 C o n g , f o r a d m i n i s t r a t o r s

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

s e t t i n g s f o r D 2 C l i e n t .

• D 2 C l i e n t : T h e w e b - b a s e d a p p l i c a t i o n , h e r e a f t e r k n o w n a s D 2 C l i e n t , f o r u s e r s t h a t p r o v i d e s t h e

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

W h e n t h i s g u i d e r e f e r s t o D 2 , i t r e f e r s t o t h e p r o d u c t a s a w h o l e , n o t t h e i n d i v i d u a l c o m p o n e n t s .

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

T h e i n f o r m a t i o n i n t h i s g u i d e 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 w h o i n s t a l l a n d a d m i n i s t e r D o c u m e n t u m

s o f t w a r e .

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

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

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

D e c e m b e r 2 0 1 4 A d d e d t h e i n f o r m a t i o n r e l a t e d t o d o c b r o k e r / g l o b a l r e g i s t r y

s e t t i n g s f o r d f c . p r o p e r t i e s l e i n I n s t a l l i n g D 2 - B O C S c h a p t e r .

N o v e m b e r 2 0 1 4 • R e m o v e d t h e i n f o r m a t i o n r e l a t e d t o d m _ e v e n t _ s e n d e r _ j a v a m e t h o d

f r o m t h e C o n g u r i n g t h e D 2 E v e n t S e n d e r M a i l M e t h o d , p a g e 7 0 t o p i c .

• U p d a t e d t h e r e l a t i v e l e p a t h f o r c o n g u r i n g O 2 a n d C 2 p l u g - i n f o r B O C S .

S e p t e m b e r 2 0 1 4 A d d e d t h e f o l l o w i n g t o p i c s i n C h a p t e r 7 , C o n g u r i n g A u t h e n t i c a t i o n :

• S i n g l e S i g n O n ( S S O ) A u t h e n t i c a t i o n f o r D 2 , p a g e 7 5

• C o n g u r i n g T r u s t e d R e v e r s e P r o x y , p a g e 7 8

• A d d i n g t h e A d m i n i s t r a t o r L o g i n N a m e t o t h e d 2 f s - t r u s t . p r o p e r t i e s l e ,

p a g e 7 9

• A d d i n g t h e A d m i n i s t r a t o r P a s s w o r d t o t h e D 2 L o c k b o x , p a g e 7 9

• C o n g u r i n g t h e S h i r o . i n i l e f o r I n t e r o p e r a b i l i t y w i t h D 2 - C o n g a n d t h e

D o c u m e n t u m M e t h o d S e r v e r , p a g e 7 9

J u n e 2 0 1 4 A d d e d a s t e p f o r r e m o v i n g s e r i a l i z e r - x . x . x . j a r l e f r o m t h e J M S l i b r a r i e s i n

t h e U p g r a d i n g D 2 , p a g e 1 0 t o p i c .

E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e 7


8/135

P r e f a c e

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

M a y 2 0 1 4 • A d d e d a n o t e a b o u t p a s s w o r d r e s t r i c t i o n f o r D 2 M e t h o d p a s s p h r a s e

p a r a m e t e r i n t h e L i n u x e n v i r o n m e n t

• A d d e d a n o t e a b o u t r u n n i n g D 2 a n d W e b t o p i n t h e s a m e o r d i f f e r e n t

a p p l i c a t i o n s e r v e r s w h i l e w o r k i n g w i t h K e r b e r o s S S O .

• U p d a t e d i n f o r m a t i o n a b o u t j a r l e s i n S t e p 4 b a n d 5 b i n t h e I n s t a l l i n g D 2

R P S C o n n e c t o r L i b r a r i e s o n M i c r o s o f t W i n d o w s , p a g e 9 6 a n d I n s t a l l i n g

D 2 R P S C o n n e c t o r L i b r a r i e s o n a L i n u x E n v i r o n m e n t , p a g e 9 8 s e c t i o n s

r e s p e c t i v e l y .

A p r i l 2 0 1 4 • A d d e d S t e p 4 a b o u t s e t t i n g u p t h e l o c k b o x l e f o r D o c u m e n t u m P r o c e s s

E n g i n e i n t h e C o n g u r i n g L o c k b o x o n t h e D o c u m e n t u m C o n t e n t S e r v e r ,

p a g e 2 3 s e c t i o n .

• U p d a t e d S t e p 7 a n d S t e p 1 2 i n t h e I n s t a l l i n g D 2 o n I B M W e b S p h e r e ,

p a g e 3 9 s e c t i o n .

• A d d e d S t e p 1 ( d ) i n t h e C o n g u r i n g L o c k b o x o n t h e D o c u m e n t u m C o n t e n t

S e r v e r , p a g e 2 3 s e c t i o n .

M a r c h 2 0 1 4 • U p d a t e d t h e f o l d e r p a t h i n t h e I n s t a l l i n g D 2 o n R e d h a t J B O S S , p a g e 4 2

s e c t i o n .

• A d d e d S t e p 5 a n d S t e p 6 i n t h e C o n g u r i n g M i c r o s o f t W i n d o w s N T

U n i e d L o g o n ( N T L M ) , p a g e 7 5 s e c t i o n .

• U p d a t e d t h e C o n g u r i n g K e r b e r o s , p a g e 7 6 s e c t i o n a n d a d d e d a r e f e r e n c e

t o t h e S i n g l e S i g n O n s e c t i o n .

• U p d a t e d t h e C o n t e n t S e r v e r v e r s i o n s a n d p a t h i n t h e C o n g u r i n g L o c k b o x

o n t h e D o c u m e n t u m C o n t e n t S e r v e r , p a g e 2 3 s e c t i o n i n c o n t e x t o f c o p y i n g

t h e D 2 . l o c k b o x l e .

J a n u a r y 2 0 1 4 I n i t i a l p u b l i c a t i o n .



9/135

C h a p t e r 1

G e t t i n g S t a r t e d

T h i s c h a p t e r c o n t a i n s t h e f o l l o w i n g t o p i c s :

• K n o w B e f o r e Y o u S t a r t

• P r e p a r i n g f o r I n s t a l l a t i o n

• U p g r a d i n g D 2

• I n s t r u c t i o n s f o r I n s t a l l i n g D 2

K n o w B e f o r e Y o u S t a r t

B e f o r e i n s t a l l i n g , m a k e s u r e y o u k n o w :

• H o w t o s e t C L A S S P A T H e n v .

• T h e i n s t a l l p a t h s f o r D o c u m e n t u m , C o n t e n t S e r v e r , J a v a M e t h o d S e r v e r ( J M S ) o n b o t h m a c h i n e s , a n d y o u r w e b a p p l i c a t i o n s e r v e r .

• H o w t o s e t v a r i a b l e p a r a m e t e r s f o r t h e J a v a V i r t u a l M a c h i n e .

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

• H o w t o s e t v a r i a b l e p a r a m e t e r s f o r y o u r a p p l i c a t i o n s e r v e r .

P r e p a r i n g f o r I n s t a l l a t i o n

1 . R e a d t h e E M C D o c u m e n t u m D 2 R e l e a s e N o t e s f o r y o u r c o r r e s p o n d i n g v e r s i o n f o r c o m p a t i b i l i t y m a t r i c e s a n d u p d a t e d i n s t a l l a t i o n p r o c e d u r e s .

2 . M a k e s u r e y o u h a v e i n s t a l l e d :

• D o c u m e n t u m C o n t e n t S e r v e r a n d h a v e c o n g u r e d y o u r r e p o s i t o r i e s a n d d o c b r o k e r s .

• A J 2 E E w e b a p p l i c a t i o n s e r v e r a s p e r y o u r e n t e r p r i s e s e t u p .

• D o c u m e n t u m C o m p o s e r w i t h a D A R I n s t a l l e r f o r . d a r d e p l o y m e n t o r D o c u m e n t u m H e a d l e s s C o m p o s e r f o r h e a d l e s s d e p l o y m e n t o f . d a r l e s .

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

4 . I n a L i n u x e n v i r o n m e n t , s e t t h e g r a p h i c a l e n v i r o n m e n t , e i t h e r b y :

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

• A d d i n g t h e p a r a m e t e r - D j a v a . a w t . h e a d l e s s = t r u e t o t h e J a v a M e t h o d S e r v e r s t a r t u p s c r i p t .

E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e 9


10/135


5 . D o w n l o a d t h e f o l l o w i n g l e s t o t h e C o n t e n t S e r v e r a n d w e b a p p l i c a t i o n s e r v e r m a c h i n e s :

F i l e D e s c r i p t i o n C o n t e n t

e m c - d f s - s d k - x . z i p D o c u m e n t u m F o u n d a t i o n

S e r v i c e s ( D F S ) S o f t w a r e

D e v e l o p m e n t K i t ( S D K )

D o w n l o a d t h e D F S S D K z i p l e

f o r t h e v e r s i o n o f D o c u m e n t u m

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

T o l o c a t e t h e l e , u s e t h e s e a r c h

f e a t u r e f o r D F S S D K x S P x

F o r e x a m p l e , i f y o u u s e

D o c u m e n t u m C o n t e n t S e r v e r

6 . 7 , s e a r c h f o r D F S S D K 6 . 7 .

I f y o u u s e D o c u m e n t u m C o n t e n t

S e r v e r 6 . 7 S P 1 , s e a r c h f o r D F S

S D K 6 . 7 S P 1

A l l c o n t e n t w i t h i n t h i s a r c h i v e a r e

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

D 2 _ x . z i p C o n t a i n s t h e D 2 c o r e i n s t a l l e r . D 2 – I n s t a l l e r -

< v e r s i o n > . j a r .

H R C o n f i g D 2 4 . x —

E x p o r t - C o n f i g . z i p

C o n t a i n s t h e s a m p l e a p p l i c a t i o n

t o i m p o r t a f t e r i n s t a l l i n g D 2 .

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

w h e n c e r t a i n c o n g u r a t i o n s d o

n o t e x i s t . D o w n l o a d a n d i m p o r t

t h e s a m p l e c o n g u r a t i o n o r a

p r e v i o u s c o n g u r a t i o n t o e n s u r e

t h a t r e q u i r e d c o n g u r a t i o n s e x i s t

f o r D 2 t o r u n w i t h o u t e r r o r s .

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

n o t n e e d t o i m p o r t t h e p r o v i d e d

s a m p l e .

A l l c o n t e n t w i t h i n t h i s a r c h i v e a r e

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

6 . I f y o u a r e u p g r a d i n g D 2 , f o l l o w t h e i n s t r u c t i o n s i n U p g r a d i n g D 2 , p a g e 1 0 .

7 . F o l l o w t h e i n s t r u c t i o n s f o r i n s t a l l i n g D 2 i n I n s t r u c t i o n s f o r I n s t a l l i n g D 2 , p a g e 1 1 .

U p g r a d i n g D 2

1 . D e l e t e e x i s t i n g u s e r p r e f e r e n c e s w i t h t h e D Q L q u e r y d e l e t e d 2 c _ p r e f e r e n c e s o b j e c t s ; 2 . S t o p C o n t e n t S e r v e r , J M S s e r v i c e s , a n d w e b a p p l i c a t i o n s e r v i c e s .

3 . D e l e t e t h e c o o k i e s a n d c a c h e o f t h e w e b b r o w s e r s .

4 . B a c k u p c o n g u r a t i o n l e s . L o c a t i o n s o f C o n g u r a t i o n F i l e s , p a g e 1 3 5 c o n t a i n s t h e l o c a t i o n s o f c o n g u r a t i o n l e s .

5 . R e m o v e a l l p o i - < t y p e > – 3 . 6 . j a r l e s f r o m t h e J M S l i b r a r i e s l o c a t e d a s d e s c r i b e d i n t h e f o l l o w i n g t a b l e . I f y o u d o n o t r e m o v e t h e 3 . 6 l e s , t h e i n s t a l l e r d o e s n o t r e p l a c e t h e l e s a n d D 2 m a y n o t f u n c t i o n c o r r e c t l y .

1 0 E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e


11/135


C o n t e n t S e r v e r 7 . 1 a n d l a t e r C o n t e n t S e r v e r 6 . 7 S P I t o 7 . 0 C o n t e n t S e r v e r 6 . 6 a n d 6 . 7

< i n s t a l l p a t h o f D o c -

u m e n t u m > / < J B O S S v e r -

s i o n > / s e r v e r / D c t m -

S e r v e r _ M e t h o d -

S e r v e r / d e p l o y -

m e n t s / S e r v e r -

A p p s . e a r / l i b





S e r v e r / d e p l o y / S e r v e r -

A p p s . e a r / l i b





S e r v e r / d e p l o y / S e r v e r -

A p p s . e a r / A P P - I N F / l i b

6 . R e m o v e s e r i a l i z e r - x . x . x . j a r l e f r o m t h e J M S l i b r a r i e s l o c a t e d a t b p m . e a r / l i b .

7 . D e l e t e t h e t e m p o r a r y i n s t a l l e r l e s . F o r e x a m p l e , i n M i c r o s o f t W i n d o w s d e l e t e t h e f o l d e r C : \ U s e r s \ A d m i n i s t r a t o r \ A p p D a t a \ L o c a l \ T e m p \ 2 \ D 2 – I n s t a l l e r _ < v e r s i o n >

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

8 . F o l l o w t h e I n s t r u c t i o n s f o r I n s t a l l i n g D 2 , p a g e 1 1 .

I n s t r u c t i o n s f o r I n s t a l l i n g D 2 T h e f o l l o w i n g i n s t a l l a t i o n c o n t a i n s t h e s t e p s f o r i n s t a l l i n g t h e D 2 - A P I l i b r a r y l e s o n t h e D o c u m e n t u m

C o n t e n t S e r v e r , d e p l o y i n g t h e D A R l e s , a n d t h e n i n s t a l l i n g t h e D 2 C o n g a n d D 2 C l i e n t w e b

a p p l i c a t i o n s o n t h e w e b a p p l i c a t i o n s e r v e r :

1 . O n t h e D o c u m e n t u m C o n t e n t S e r v e r m a c h i n e :

a . E x t r a c t t h e c o n t e n t s o f e m c - d f s - s d k - x . z i p . R e m e m b e r t h e p a t h s t o t h e c r e a t e d f o l d e r s , b e c a u s e t h e D 2 i n s t a l l a t i o n r e q u i r e s y o u t o r e f e r e n c e c o n t e n t f r o m t h e a r c h i v e .

b . S t o p t h e D o c u m e n t u m C o n t e n t S e r v e r r e p o s i t o r y a n d J M S s e r v i c e s .

c . F o l l o w t h e i n s t r u c t i o n s f o r i n s t a l l i n g t h e D 2 A P I l i b r a r i e s a n d e x t r a c t i n g D 2 – D A R . d a r , D 2 W i d g e t - D A R . d a r , a n d C o l l a b o r a t i o n _ S e r v i c e s . d a r , w i t h o r w i t h o u t

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

O p e r a t i n g s y s t e m o f y o u r D o c u m e n t u m C o n t e n t S e r v e r m a c h i n e

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

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

M i c r o s o f t W i n d o w s I n s t a l l i n g D 2 w i t h o u t

D o c u m e n t u m P r o c e s s E n g i n e

C o m p a t i b i l i t y o n M i c r o s o f t

W i n d o w s , p a g e 1 5

I n s t a l l i n g D 2 w i t h D o c u m e n t u m

P r o c e s s E n g i n e C o m p a t i b i l i t y

o n M i c r o s o f t W i n d o w s , p a g e 1 9

A L i n u x e n v i r o n m e n t I n s t a l l i n g D 2 w i t h o u t

D o c u m e n t u m P r o c e s s E n g i n e

C o m p a t i b i l i t y o n a L i n u x

E n v i r o n m e n t , p a g e 1 7

I n s t a l l i n g D 2 w i t h D o c u m e n t u m

P r o c e s s E n g i n e C o m p a t i b i l i t y

o n a L i n u x E n v i r o n m e n t , p a g e

2 0

d . I f y o u a r e i n s t a l l i n g D 2 o n a C o n t e n t S e r v e r c l u s t e r , i n s t a l l t h e D 2 A P I l i b r a r i e s o n e a c h i n s t a n c e o f C o n t e n t S e r v e r .

e . C o n g u r e l o c k b o x f o r e a c h i n s t a n c e o f C o n t e n t S e r v e r a n d c r e a t e t h e D 2 M e t h o d . p a s s p h r a s e . D 2 u s e s l o c k b o x t o m a n a g e l o g i n t i c k e t s . C o n g u r i n g L o c k b o x o n t h e D o c u m e n t u m C o n t e n t S e r v e r , p a g e 2 3 c o n t a i n s f u r t h e r i n s t r u c t i o n s .

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

E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e 1 1


12/135


C o n g u r a t i o n I n s t r u c t i o n s

C o n g u r i n g l o g b a c k . x m l C o n g u r i n g l o g b a c k . x m l f o r t h e C o n t e n t S e r v e r ,

p a g e 6 6

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

6 7

C o n g u r i n g D 2 a u d i t i n g C o n g u r i n g D 2 A u d i t i n g , p a g e 6 8

g . R e s t a r t D o c u m e n t u m C o n t e n t S e r v e r a n d J M S .

2 . O n a s y s t e m w i t h D o c u m e n t u m C o m p o s e r , f o l l o w t h e i n s t r u c t i o n s f o r d e p l o y i n g D 2 – D A R . d a r , D 2 W i d g e t - D A R . d a r a n d C o l l a b o r a t i o n _ S e r v i c e s . d a r . I n s t a l l i n g D 2 D A R , p a g e 2 6 c o n t a i n s f u r t h e r i n s t r u c t i o n s .

3 . O n t h e w e b a p p l i c a t i o n s e r v e r :

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

b . F o l l o w t h e i n s t r u c t i o n s f o r c r e a t i n g t h e D 2 W A R l e s f o r d e p l o y m e n t a s d e s c r i b e d i n t h e f o l l o w i n g t a b l e :

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

s e r v e r m a c h i n e

I n s t r u c t i o n s

M i c r o s o f t W i n d o w s C r e a t i n g D 2 W A R F i l e s o n a W e b A p p l i c a t i o n

S e r v e r U s i n g M i c r o s o f t W i n d o w s , p a g e 2 9

A L i n u x e n v i r o n m e n t C r e a t i n g D 2 W A R F i l e s o n a W e b A p p l i c a t i o n

S e r v e r U s i n g a L i n u x e n v i r o n m e n t , p a g e 3 1

c . F o l l o w t h e i n s t r u c t i o n s f o r i n s t a l l i n g D 2 o n t h e w e b a p p l i c a t i o n s e r v e r a s d e s c r i b e d i n t h e f o l l o w i n g t a b l e :

W e b a p p l i c a t i o n s e r v e r I n s t r u c t i o n s

A p a c h e T o m c a t f o r M i c r o s o f t W i n d o w s I n s t a l l i n g D 2 o n A p a c h e T o m c a t f o r M i c r o s o f t

W i n d o w s , p a g e 3 7

A p a c h e T o m c a t f o r a L i n u x e n v i r o n m e n t I n s t a l l i n g D 2 o n A p a c h e T o m c a t f o r a L i n u x E n v i r o n m e n t , p a g e 3 8

I B M W e b S p h e r e I n s t a l l i n g D 2 o n I B M W e b S p h e r e , p a g e 3 9

B E A W e b L o g i c I n s t a l l i n g D 2 o n O r a c l e W e b L o g i c , p a g e 4 1

R e d h a t J B O S S I n s t a l l i n g D 2 o n R e d h a t J B O S S , p a g e 4 2

V M w a r e v F a b r i c t c S e r v e r f o r M i c r o s o f t W i n d o w s I n s t a l l i n g D 2 o n V M w a r e v F a b r i c t c S e r v e r f o r

M i c r o s o f t W i n d o w s , p a g e 4 3

d . S t a r t a p p l i c a t i o n s e r v e r s e r v i c e s .

e . C o n g u r e l o c k b o x f o r e a c h w e b a p p l i c a t i o n s e r v e r a n d c r e a t e t h e D 2 M e t h o d . p a s s p h r a s e . D 2 u s e s l o c k b o x t o m a n a g e l o g i n t i c k e t s . C o n g u r i n g L o c k b o x o n t h e W e b A p p l i c a t i o n S e r v e r ,

p a g e 4 4 c o n t a i n s f u r t h e r i n s t r u c t i o n s . 4 . C o n g u r e D 2 :

a . C o n g u r e t h e a p p l i c a t i o n s a s d e s c r i b e d i n t h e f o l l o w i n g t a b l e :

A p p l i c a t i o n I n s t r u c t i o n s

D 2 C o n g C o n g u r i n g D 2 C o n g , p a g e 5 5

D 2 C l i e n t C o n g u r i n g D 2 C l i e n t , p a g e 5 8

D 2 J a v a M e t h o d S e r v e r C o n g u r i n g D 2 J a v a M e t h o d S e r v e r , p a g e 6 1

1 2 E M C D o c u m e n t u m D 2 V e r s i o n 4 . 2 I n s t a l l a t i o n G u i d e


13/135


b . S t o r e p a s s w o r d s i n t h e l o c k b o x l e . S t o r i n g P a s s w o r d s i n t h e D 2 L o c k b o x , p a g e 6 1 c o n t a i n s f u r t h e r i n f o r m a t i o n a n d i n s t r u c t i o n s .

5 . C o n g u r i n g a u t h e n t i c a t i o n p r o t o c o l s i f y o u w a n t t o u s e W i n d o w s N T U n i e d L o g o n ( N T L M ) o r K e r b e r o s a s d e s c r i b e d i n t h e f o l l o w i n g t a b l e :

A u t h e n t i c a t i o n I n s t r u c t i o n s

N T L M C o n g u r i n g N T U n i e d L o g o n ( N T L M ) , p a g e 7 5

K e r b e r o s C o n g u r i n g K e r b e r o s , p a g e 7 6

6 . Y o u c a n c o n g u r e t h e l e t r a n s f e r m o d e . F i l e T r a n s f e r M o d e s , p a g e 6 4 c o n t a i n s m o r e i n f o r m a t i o n a b o u t t h e J a v a a n d t h i n c l i e n t l e t r a n s f e r m o d e s a n d C o n g u r i n g F i l e T r a n s f e r M o d e s , p a g e 6 4 c o n t a i n s c o n g u r a t i o n i n s t r u c t i o n s .

7 . I n s t a l l t h e l a n g u a g e p a c k s . I n s t a l l i n g D 2 C o n g L a n g u a g e P a c k s ( F r e n c h - o n l y ) , p a g e 6 4 a n d I n s t a l l i n g D 2 C l i e n t L a n g u a g e P a c k s , p a g e 6 5 c o n t a i n f u r t h e r i n s t r u c t i o n s .

8 . R u n t h e a p p l i c a t i o n s .

9 . L o g i n t o D 2 C o n g a n d i m p o r t c o n g u r a t i o n s . T h e E M C D o c u m e n t u m D 2 A d m i n i s t r a t i o n G u i d e

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

U s i n g D 2 w i t h o u t c o n g u r a t i o n s c a n c a u s e e r r o r s . I f y o u d o n o t h a v e a p r e v i o u s s e t o f c o n g u r a t i o n s

t o i m p o r t , d o w n l o a d a n d i m p o r t H R C o n f i g D 2 4 . x — E x p o r t - C o n f i g . z i p a s a s a m p l e

s e t o f c o n g u r a t i o n s .



14/135


15/135

C h a p t e r 2

I n s t a l l i n g D 2 o n t h e C o n t e n t S e r v e r

T h i s c h a p t e r c o n t a i n s t h e f o l l o w i n g t o p i c s :

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

W i n d o w s

• I n s t a l l i n g D 2 w i t h o u t D o c u m e n t u m P r o c e s s E n g i n e C o m p a t i b i l i t y o n a L i n u x

E n v i r o n m e n t

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

W i n d o w s

• I n s t a l l i n g D 2 w i t h D o c u m e n t u m P r o c e s s E n g i n e C o m p a t i b i l i t y o n a L i n u x

E n v i r o n m e n t

• C o n g u r i n g L o c k b o x o n t h e D o c u m e n t u m C o n t e n t S e r v e r

• D e p l o y i n g D A R F i l e s

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

1 . R i g h t - c l i c k o n D 2 – I n s t a l l e r - < v e r s i o n > . j a r , s e l e c t O p e n w i t h , a n d t h e n s e l e c t J a v a ( T M ) P l a t f o r m S E b i n a r y .

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

M a c h i n e ( J V M ) a s i t s t e m p o r a r y d i r e c t o r y :

C : \ D o c u m e n t a n d S e t t i n g s \ < u s e r > \ L o c a l S e t t i n g s \ T e m p \ D 2 - I n s t a l l e r _ x

[ u s e r ] i s t h e u s e r n a m e o f t h e a c c o u n t , a n d x i s t h e v e r s i o n n u m b e r .

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

2 . O n t h e S e l e c t i n s t a l l a t i o n p a c k a g e s p a g e , s e l e c t D 2 - A P I f o r C o n t e n t S e r v e r \ J M S a n d D A R .

3 . O n t h e D 2 p l u g i n s i n s t a l l a t i o n p a g e , c l i c k A d d a p l u g i n a n d a d d t h e i n s t a l l e r . j a r l e s t o i n s t a l l n e w p l u g - i n s o r u p d a t e e x i s t i n g p l u g - i n s .

T h e D 2 I n s t a l l e r a u t o m a t i c a l l y r u n s t h e a d d e d p l u g - i n i n s t a l l e r . j a r l e s a n d a c t i v a t e s t h e p l u g - i n f o r

D 2 , b u t y o u m u s t m a n u a l l y d e p l o y D A R l e s . F o r e x a m p l e , i f y o u a d d C 2 – I n s t a l l . j a r :

• Y o u d o n o t n e e d t o d e p l o y t h e o u t p u t C 2 – A P I . j a r a n d C 2 – P l u g i n . j a r l e s .

• Y o u d o n o t n e e d t o c o n g u r e D 2 – C o n f i g . p r o p e r t i e s .

• Y o u m u s t d e p l o y C 2 – D A R . d a r .



16/135

I n s t a l l i n g D 2 o n t h e C o n t e n t S e r v e r

I f y o u d o n o t a d d p l u g - i n s u s i n g t h e D 2 I n s t a l l e r , y o u c a n m a n u a l l y r u n t h e p l u g - i n i n s t a l l e r a n d

d e p l o y t h e . j a r l e s a f t e r c o m p l e t i n g t h e D 2 i n s t a l l a t i o n .

4 . F i l l o u t t h e D 2 - A P I e x t r a c t i o n f o l d e r s p a g e a s d e s c r i b e d i n t h e f o l l o w i n g t a b l e :

F i e l d P a t h

F o r C o n t e n t S e r v e r < i n s t a l l p a t h o f D 2 >

F o r J a v a M e t h o d S e r v e r F o r C o n t e n t S e r v e r V e r s i o n 7 . 1 a n d l a t e r , u s e < i n s t a l l p a t h o f

D o c u m e n t u m > \ < J B O S S v e r s i o n > \ D c t m S e r v e r _ M e t h o d -

S e r v e r \ d e p l o y m e n t s \ S e r v e r A p p s . e a r

F o r C o n t e n t S e r v e r V e r s i o n 6 . 7 S P 1 t o 7 . 0 , u s e < i n s t a l l p a t h o f


S e r v e r \ d e p l o y \ S e r v e r A p p s . e a r

F o r C o n t e n t S e r v e r V e r s i o n 6 . 7 a n d e a r l i e r , u s e < i n s t a l l p a t h o f


S e r v e r \ d e p l o y \ S e r v e r A p p s . e a r \ A P P - I N F

5 . O n t h e D A R e x t r a c t i o n f o l d e r p a g e , s e l e c t t h e p a t h t o e x t r a c t t h e D A R l e s .

T h i s s t e p p r o d u c e s t h e D 2 – d a r . d a r , D 2 W i d g e t - d a r . d a r , a n d

C o l l a b o r a t i o n _ S e r v i c e s . d a r l e s i n t h e s e l e c t e d f o l d e r .

6 . O n t h e D o c u m e n t u m d e p e n d e n c i e s p a g e , f o r P a t h , l o c a t e a n d s e l e c t t h e f o l d e r t o w h i c h y o u e x t r a c t e d t h e D F S S D K .

M a k e s u r e y o u s e l e c t t h e m a i n D F S S D K f o l d e r t h a t c o n t a i n s t h e l i b f o l d e r , s u c h a s t h e d e f a u l t

e m c — d f s - s d k – 6 . 7 f o l d e r s h o w n i n t h e f o l l o w i n g i m a g e :

T h e i n s t a l l e r a u t o m a t i c a l l y i n c l u d e s n e c e s s a r y l e s i n t h e e x t r a c t e d W A R l e s . Y o u c a n d e l e t e t h e

D F S S D K l i b r a r y l e s a f t e r t h e D 2 i n s t a l l a t i o n c o m p l e t e s .

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

documentum d2 4.2 installation guide

Documents