In this document , we are not
mentioning the steps for CS installtion and xPlore installation. We are just
going through the steps which are required for xCP2.1 Configuration.
All Components are being install
or configure on one single machine (same machine).
Software requirement:
IE 8 or Higher
SQL Server R2 2008
Documentum content
Server 7.1
xPlore Server-1.4
Tc Server (vfabric-tc-server-developer-2.9.6.RELEASE.msi)
BAM server (bam-server.war, compatible to CS
and xcp version)
BPM-2.1 (Process Engine) (compatible to CS and xcp version)
Bps.war (Process
Integrator) (compatible to CS and
xcp version)
BPM.Ear (compatible to CS and xcp version)
xms-agent-1.1 (compatible to CS and xcp version)
xms-tools-1.1 (compatible to CS and xcp version)
CTS(MTS, ADTS,AVTS) (compatible
to CS and xcp version)
CIS (compatible
to CS and xcp version)
<AppServerHost> All App Server Instances
<tcServerXcpInstance> C:\tcserver\xcpInstance
(port:8000)
<tcServerAppInstance> C:\tcserver\appInstance
(DA, port :7000)
<tcServerXmsAgentInstance> C:\tcserver\xmsagent
(port:5050)
<CIS installation
directory> C:\Documentum\CTS\CIS
<xms-tools-home> C:\xms-tools-1.1
TC Server Instances
Create multiple
instance of tc server or Tomcat server, but following port should be different
in every instances (Edit catalina.properties):
base.shutdown.port=7072
base.jmx.port=7073
bio.http.port=7070
bio.https.port=7071
In this document, we
are supposed to create 3 instances of tc server, with following port details:
AppInstance:
base.shutdown.port=-1
base.jmx.port=6969
bio.http.port=7000
bio.https.port=7443
bio-ssl.https.port=7443
xCPInstance:
base.shutdown.port=-1
base.jmx.port=6969
bio.http.port=8000
bio.https.port=8443
bio-ssl.https.port=8443
xmsAgentInstance:
base.shutdown.port=5072
base.jmx.port=5959
bio.http.port=5050
bio.https.port=5443
bio-ssl.https.port=5443
We could specify
these ports, during the instance creation of tc server, but for tomcat we have
to modify the catalina.properties under conf directory. We could also change
these port in same file under the same folder, for tc server.
Ideally we should
change base.shutdown.port also, means it should be unique, in case all
instances are on same machine.
So, the base url for
these instance would be:
AppInstance: http://localhost:7000
xCPInstance: http://localhost:8000
xmsAgentInstance: http://localhost:5050
Add users in all
appServer instances:
Add users in
tomcat-users.xml in folder <AppServerHost>\conf .
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="admin-gui"/>
<role
rolename="admin-script"/>
<role
rolename="manager-gui"/>
<role
rolename="manager-script"/>
<role
rolename="manager-jmx"/>
<role
rolename="manager-status"/>
<user username="tomcat"
password="tomcat" roles="tomcat"/>
<user username="both"
password="tomcat" roles="tomcat,role1"/>
<user username="role1"
password="tomcat" roles="role1"/>
<user username="admin"
password="admin"
roles="tomcat,role1,admin-gui,manager-gui,manager-script"/>
</tomcat-users>
Edit web.xml file,
add following lines, under folder <AppServerHost>\conf
<init-param>
<param-name>enablePooling</param-name>
<param-value>false</param-value>
</init-param>
After configuration, port
& url for the all installed com[ponents would be
xPlore DSearch:- http://localhost:9300/dsearch
xPlore Indexagent:- http://localhost:9200/IndexAgent
bam server:- http://localhost:8000/bam-server
http://localhost:8000/bps/versions.jsp
http://localhost:8000/bps/lsnrs.jsp
http://localhost:8000/bps/webservice
http://localhost:9080/bpm/outbound_details.jsp
http://localhost:9080/bpm/servlet/DoMethod
xms-agent :- http://localhost:5050/xms-agent
OR
http://127.0.0.1:5050/xms-agent
Thumnail server:- http://localhost:8081/thumbsrv/getThumbnail
CTS:- http://localhost:9095/CTSAgent/CTSAgent
Ports:-
CIS:- 8079/1099
CTS:- 9095
and 9096, for its web-services
MTS:- 9095
ADTS:- 9095
AVTS:- 9095
BAM Deployment for xCP2.1
step 1:--> Add users, if it is not exist, in
tomcat-users.xml in folder <tcServerXcpInstance>\conf
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="admin-gui"/>
<role
rolename="admin-script"/>
<role
rolename="manager-gui"/>
<role
rolename="manager-script"/>
<role
rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="tomcat"
password="tomcat" roles="tomcat"/>
<user username="both"
password="tomcat" roles="tomcat,role1"/>
<user username="role1"
password="tomcat" roles="role1"/>
<user username="admin"
password="admin" roles="tomcat,role1,admin-gui,manager-gui,manager-script"/>
</tomcat-users>
We are adding users in
this file just for accessing app server.
Step 2:--> Download the bam-server.war , unzip
and deploy it under <tcServerXcpInstance>\webapps directory.
Step 3:--> Change the value of bam.properties file
under path " <tcServerXcpInstance> \webapps\bam-server\WEB-INF\classes\config\bam.properties".
But before below
steps, we have to create a database(should be case sensetive, in sql server set
collation as Latin1_General_CS_AS) for BAM, here I created a DB with name BAM and to access this DB, created
user with name BAMADMIN and password BAMADMIN. Initial size of DB should be
1000 MB . Log file size should be at least 500 MB.
bam.properties should
be something like below:
bam.encrypt=true
bam.jdbc.dialect=mssql
bam.jdbc.url=jdbc:sqlserver://localhost;databasename=BAMDB;SELECTMETHOD=Cursor
bam.jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
bam.jdbc.userName=BAMADMIN
bam.jdbc.password=BAMADMIN
bam.jdbc.preference.maxRows=10000
bam.jdbc.preference.deployBatchSize=2500
bam.jdbc.preference.dataFormatBatchSize=1000
bam.jdbc.preference.initialSize=10
bam.jdbc.preference.maxIdle=-1
bam.jdbc.preference.maxActive=-1
bam.dfc.session.repository=TestingRepo
bam.dfc.session.repositoryUserName=Administrator
bam.dfc.session.repositoryPassword=Reims.408
bam.cluster.ttl = 1500
bam.cluster.pulse = 500
bam.cluster.activateOnStartup= false
Step 4:--> Create folder named bam(in lower case)
in <tcServerXcpInstance>
directly.
Step 5:-->
Now, copy the same bam.properties file(from Step 3) in folder bam under <tcServerXcpInstance>.
Step 6:--> Copy log4j.properties file from " <tcServerXcpInstance>
\webapps\bam-server\WEB-INF\classes" folder and paste it in a folder named bam under <tcServerXcpInstance>.
Step
7:à Create and copy the dfc.properties file for
the application to reference the repository, as follows:
7.a. Create a Customconf folder at the root of the
application server instance:
<tcServerXcpInstance> /Customconf.
7.b. Copy the dfc.properties file from the
%Documentum%\Config folder , from Content Server to
the above location.
7.c. Create the rest-api-runtime.properties file
in the <tcServerXcpInstance> /Customconf folder and add these
properties to the end of the file:
rest.user.private.session.preferred=true
(Optional) Set this property for performance
tuning of the MS SQL Server:
rest.api.paged_query_template.db_hint.com.emc.documentum.rest.dfc.impl.query.FolderChildrenQueryTemplate=SQL_SERVER(’FORCESEEK’)
7.d. Open the dfc.properties file in <tcServerXcpInstance>
/Customconf and add the following:
dfc.session.allow_trusted_login =
false
dfc.docbroker.host[0]=WIN-BU8P0V1FYQK
dfc.docbroker.port[0]=1489
dfc.docbroker.host[1]=WIN-BU8P0V1FYQK
dfc.docbroker.port[1]=1589 Save your changes.
7.e.
Create a file , “ <tcServerXcpInstance> \Customconf\deployment.properties“ with following
content:
xcp.repository.name=TestingRepo
7.f.
Modify file “ <tcServerXcpInstance>
\conf\catalina.properties“,
add following content (already mentioned above):
base.shutdown.port=-1
base.jmx.port=6969
bio.http.port=8000
bio.https.port=8443
bio-ssl.https.port=8443
Step 8:àModify
wrapper.conf file (“<tcServerXcpInstance>\conf\wrapper.conf“)
Add
wrapper.java.additional.8="-Xss192K"
wrapper.java.additional.9="-Xmx1024M"
wrapper.java.additional.10="-XX:MaxPermSize=256m"
wrapper.java.additional.11="-Xms1024M"
wrapper.java.additional.12="-Dbam.properties=C:\tcserver\xcpInstance\bam\bam.properties"
wrapper.java.additional.13="-Dlog4j.configuration=C:\tcserver\xcpInstance\bam\log4j.properties"
Add
wrapper.java.classpath.5= <tcServerXcpInstance> \Customconf
Step 9:--> Changes in context.xml file under
directory " <tcServerXcpInstance> \conf"
Replace
<Context> with <Context antiJARLocking="true" antiResourceLocking="true">
Step 10:-->
Changes in server.xml file under
directory " <tcServerXcpInstance> \conf" , it is not applicable
for TC Server, require only for Tomcat. In TC server, instead of explicit ports
and other values , it will already have variable, that will be mentioning in
cataline.properties.
Add attribute
URIEncoding="UTF-8" with connector tag, e.g.,
<Connector port="8080"
protocol="HTTP/1.1" URIEncoding="UTF-8"
connectionTimeout="20000"
redirectPort="8443"
/>
Step 11:-->
Changes in web.xml file under
directory " <tcServerXcpInstance> \conf"
<init-param>
<param-name>enablePooling</param-name>
<param-value>false</param-value>
</init-param>
Step 12:--->
Copy dfc.properties file from documentum/config and paste it in " <tcServerXcpInstance>
\webapps\bam-server\WEB-INF\classes" folder.
Step 13:-->
Change the value of " <tcServerXcpInstance> \webapps\bam-server\bam-server.properties",
i.e.,
bam.server.host=localhost
bam.server.port=8000
bam.server.context=bam-server
#bam.server.protocol=https
Step 14:--> Download
xcp-runtime-2.0.zip and extract all jar files, copy these jar files in folder
TOMCAT_HOME\lib. (NA for 2.1, In xCP 2.0, xCP runtime libraries were bundled separately.
It was mandatory to copy xCP runtime JAR libraries to the lib folder of the
application server. Both the BAM server and the xCP application required these
JAR files. For xCP 2.1, the BAM server and xCP application WAR files are
packaged differently. The BAM Server and xCP application contain all necessary
xCP runtime JAR library files within their respective WAR files under
WEB-INF\lib. So, it is necessary to ensure that the lib folder of the
application server does not contain any of the xCP runtime libraries to avoid
conflict with the JAR files packaged within the WAR files of the BAM server and
xCP application.)
Step 15:--> Check the sql server port, because BAM get
connect with sql server through port 1433. This can be checked through sql
server configuration manager. OR
commandprompt>netstat
-abn
shows details of ports
which are currently in used. If u don't get port 1433 in list, then try to add,
through Sql Server Configuration Manager(refer below screen shots.)
Sql Server
Configuration Managerà Sql Server Network Configuration à Protocols for
SQL Express à TCP/IPàIP Address àTCP PORTà1433
TCP/IP should be
enabled.
Step 16:-->
Download xms-tools-1.1.zip and unzip it. Copy the content of manager.war
file and copy or merge with existing one in <tcServerXcpInstance>
\webapps folder.
After performing Step 16, we are unable to
open management console of tomcat. [If you are using tc Server Developer Edition, the
Application Manager is available in the application server by default. Verify
that the Application Manager is running by opening the following URL in a
browser:
http://localhost:8000/manager/html
Log in using the user
credentials you created for the application instance.
If you are using the
manager.war file provided in the xms-tools.zip file for xCP deployment, you
cannot access the Tomcat manager user interface using the above URL. In this
case, deploy an application to verify if the Application Manager is running correctly.
Also, view the application server logs to check for any errors. If there are no
errors, the manager.war is deployed correctly.]
Now, start the tomcat
server, if bam server has deployed successfully , the content of bam.properties
file under directory <tcServerXcpInstance> \bam,
would be changed. Now, it would be as follow:
#do not touch the
'bam.encrypted' parameter!!!!!!
#Sat Aug 16 19:58:42
PDT 2014
bam.jdbc.preference.maxIdle=-1
bam.jdbc.dialect=mssql
bam.jdbc.preference.deployBatchSize=2500
bam.dfc.session.repositoryUserName=Administrator
bam.encrypt=true
bam.encrypted=true
bam.jdbc.preference.dataFormatBatchSize=1000
bam.cluster.ttl=1500
bam.jdbc.preference.initialSize=10
bam.jdbc.userName=BAMADMIN
bam.jdbc.preference.maxActive=-1
bam.jdbc.url=jdbc\:sqlserver\://localhost;databasename\=BAMDB;SELECTMETHOD\=Cursor
bam.dfc.session.repository=TestingRepo
bam.jdbc.password=AAAAEBEgHQZ2bNSm6YIX4rThkLgFDDZEmMWfkKOk5Wg9lKS+
bam.jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
bam.cluster.activateOnStartup=false
bam.dfc.session.repositoryPassword=AAAAELODkr6JpqVpO2UEjR5NFXk/j86dK59e0taAP1jtZ25z
bam.jdbc.preference.maxRows=10000
bam.cluster.pulse=500
Step 17:--> Start the <tcServerXcpInstance> and
try the following URL in browser
login with “dmadmin“
credential, “dmadmin“ is super user. After successful logged-in, you will get
welcome page.
Credentials:
User: dmadmin
Pasword:demo.demo
OR
User: Administrator
Pasword:Reims.408
Configuring BPM by installing Process engine on CS
machine.
Step1:- Start Connection Broker and all
Repositories
Step
2:- Before
installing Process Engine, ensure that Java Method Server (JMS) service
is stopped.
Step
3:- unpacking
Process_Engine_win.zip creates a folder named Process_Engine_win
Step
4:- run
installation programs - peSetup.exe
Step
5:- Click Done to
close the Process Engine Installation wizard
Step
6:- Restart the Content Sever and Java Method Server.
Step
7:- To verify that the Process Engine installation is
successful:
http://localhost:9080/bpm/outbound_details.jsp
http://localhost:9080/bpm/servlet/DoMethod
http://localhost:9080/bpm/modules.jsp
if bpm.ear file, doesn’t gets install on JMS,
download it from subscriber net and configure it in JMS.
I’ve not remembered, how did it gets install,
whether it is automatically configured through the Process engine installation
steps or I did it manually by downloading it from subscriber net.
But the path where this bpm.ear file should be exist, is as
follow , this path is changed in CS7.1:
C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments
BPS (Process Integrator) installation with xCP2.1
Step 1:---> Download the bps.war, deploy it in <tcServerXcpInstance>
\webapps directory.
Step 2:---> Change the dfc.properties file in WEB-INF
directory of <tcServerXcpInstance> \webapps\bps directory.
Step 3:---> Update the file name
"bps_template.xml" under directory
<tcServerXcpInstance> \webapps\bps\WEB-INF.
<polling_interval>300</polling_interval>
<message_store_home_dir>C:\\Documentum\\BPS\\message_store</message_store_home_dir>
<instance_name>bps1</instance_name>
<ha_enabled>FALSE</ha_enabled>
<config_properties>
<property
name="mail.imap.partialfetch" value="false"/>
<property name="mail.debug"
value="false"/>
</config_properties>
<connections>
<docbase-connection>
<docbase>TestingRepo</docbase>
<user>Administrator</user> !—Superuser
Credentials--
<password>Reims.408</password>
<domain/>
</docbase-connection>
</connections>
Step 4:--> Changes in catalina.bat file under
directory "TOMCAT_HOME\bin", applicable for tomcat instance only
set
JAVA_OPTS=%JAVA_OPTS% %LOGGING_MANAGER% -Xss256k -Xms256m -Xmx512m -XX:MaxPermSize=128m
-XX:+UseParallelOldGC -Xdebug -Xnoagent
-Xrunjdwp:transport=dt_socket,server=y,suspend=n
-Dbam.properties=C:\TOMCAT80\bam\bam.properties -Dlog4j.configuration=file:///C:\TOMCAT80\bam\log4j.properties
we should add above
statement below following statement in
catalina.bat. , applicable for tomcat instance only
set JAVA_OPTS=%JAVA_OPTS%
%LOGGING_MANAGER%
For tc server, we have
to make those changes in wrapper.conf file, that we already did , during BAM
configuration, because we are using same TC Server instances for both BAM and
BPS.
Step 5:-->
Verify the installation by accessing following links:
http://localhost:8000/bps/inbound_details.jsp
http://localhost:8000/bps/webservice
http://localhost:9080/bpm/outbound_details.jsp -->Content Server Link
IP
Thumbnail Server
Step 1:--> Download and install dar file for
thumbnail server.
Step 2:--> Download and unzip the file
Thumbnail_Server_7.1_windows.zip, and start the installtion process
Step 3-->
Step 4:-->
Step 5:-->
Step 6:-->
Step 7:- Start menu à Apply
Thumbnail server support to docbase.
Follow steps to complete this
installation.
Step 8:- Verify the
installation:
CIS Installation
After installing CIS (it is a normal installation), do following steps
Verifying
the deployment of CIS artifacts (DAR file)
After you deployed
CIS DAR file (cis_artifacts.dar), check in Documentum Administrator that the modules
were created.
1. Log in to
Documentum Administrator.
2. Navigate to Cabinets
> System > Modules > Aspect and check that the module cis_annotation_aspect
is
present.
3. Verify that the
tables dm_annotation and dm_object_annotations
have
been created.
Verifying
that the repository was enabled for CIS
When you enable a
repository for CIS, a number of sections and folders are created. You can check
their existence to make sure that the repository has been successfully enabled.
To
check the existence of CIS sections and folders in the repository:
1. Log in to
Documentum Administrator.
2. Navigate to Content
Intelligence node
and verify that the following sections are present:
• Taxonomies
• Category Class
• Document Set
•
My Categories
Navigate to Cabinets
> System > Applications > CI and verify that the following folders
are present:
• AttributeProcessing
• Classes
• Configuration
• DocsetConfiguration
• DocumentSets
• MetadataExtrationRules
• Runs
• TaxonomySnapshots
• XMLTaxonomies
Verifying
that the tables were created
The following tables are
created in the repository for CIS:
• When the repository is
enabled, the table dm_docstatus is created.
• When CIS DAR file
(cis_artifacts.dar) is deployed, the tables dm_annotation and dm_object_annotations
are created.
To check the existence of
the tables:
1. Log in to Documentum Administrator.
2. Select Tools > DQL
Editor.
3. Run the query to check
the existence of the dm_docstatus table:
Select * from dm_docstatus
The result structure must
be:
st_object_id, st_docset_id, st_mode, st_last_modified, st_date
4. Run the query to check
the existence of the dm_annotation table:
Select * from dm_annotation
The result structure must
be:
ann_id, ann_type, ann_value
5. Run the query to check
the existence of the dm_object_annotations table:
Select * from
dm_object_annotations
The result structure must
be:
ann_object_id, ann_index, ann_chronicle_id, ann_confidence, ann_id
Verifying
the configuration of the entity detection server
CIS server needs to
communicate with the entity detection server to start the detection process,
and retrieve the entities.
To
verify the configuration of the entity detection server:
1. On CIS host, open the
configuration file <CIS installation directory>/config/ cis.properties.
2. Check that the property
cis.entity.luxid.annotation_server.host indicates the IP address of the entity
detection server.
Verifying
that all services are started
To make sure that all
services for the entity detection server are started, check the Temis
Luxid
Started
icon
in the notification area (usually on the right of the taskbar). When all
services are started,
the tooltip indicates
“Temis Luxid Started”. On the contrary, if some services have not started, the
tooltip indicates the
number of services started.
On Windows hosts, the CIS
services are installed in automatic startup mode. You can make sure that
all services are started
correctly, and, if not, start them manually or reboot to start them
automatically.
To
verify the status of the services (Windows hosts):
1. Select My
Computer > Manage > Services and Applications > Services.
2. Make sure the service Documentum
Content Intelligence Services is started. If not, start it.
3. For the entity detection
analysis, make sure that the following services are started:
• Documentum CIS Luxid IDE
Server v2
• Documentum CIS Luxid Admin
Server
• Documentum CIS Luxid
Annotation Node
• Documentum CIS Luxid
Annotation Server
• Documentum CIS Luxid SVN
Service
• Documentum CIS Luxid
Vinci Naming Service
• Documentum CIS Luxid
Xelda Service
If
you start them manually, start them in the specified order.
CTS installation:
It’s basic
installation doc , where we are basically mentioning, what components we need
to install with and for CTS, that is require for xCP2.1. Here we are not
dealing with the profile creation or all other steps , that is require for
fully working of CTS.
Step 1>> Install
following dar file in docbase
CTSActivity.dar, CTSAspects.dar, Rich_Media_Services.dar,
Transformation.dar, xCP_Viewer_Services.dar, ImageServices.dar
Step 2>> Double
click the all 3 following file to install this version of the Content
Transformation Services product.
• adtsWinSetup.exe to
install Advanced Document Transformation Services.
• mtsWinSetup.exe to
install Media Transformation Services.
• avtsWinSetup.exe to
install Audio Video Transformation Services.
Step 3>> Only
those Content Transformation Services products that you have already installed
are listed during "Configuring an instance of a Content Transformation
Services server".
Step 4>> To
configure an instance of Content Transformation Server:
Select the CTS
Configuration Utility located at Start > Programs.
The Content Transformation Services
Configuration Utility screen appears, follow the steps.
Step 5>> Verify
if the following Windows services have been started using services.msc:
·
Documentum
Content Transformation Services
·
Documentum
Content Transformation Monitor Services
·
Documentum
CTS Admin Agent
xMS Agent-1.1 installation
For xCP2.1
Step 1:à Create a new
TC Server instance or choose any instance where you want to deploy xms-agent,
but never deploy this xms-agent along with DA.
Step
2:à Stop the tc Server instance.Edit wrapper.conf located in <tcServerXmsAgentInstance>\<server_instance>/conf.
Add / modify follwoing statements:
wrapper.java.additional.8="-server"
wrapper.java.additional.9="-Xss192K"
wrapper.java.additional.10="-Xmx1024M"
wrapper.java.additional.11="-XX:MaxPermSize=256m"
wrapper.java.additional.12="-Xms1024M"
wrapper.java.additional.13="-XX:+UseParallelOldGC"
#wrapper.java.additional.14="-XX:+UseCompressedOops"
wrapper.java.additional.14="-DXMS_DATA_DIR=C:\xms-tools-1.1\catalog"
Step
3:àStart tc server instance and check whether it
is working or not, by following url in browser:
http://localhost:5050
Step
4:àAgain Stop tc server instance
Step
5:à In the catalina.properties file located in <tcServerXmsAgentInstance>\conf,add
the following (We already mentioned this , in beginning of this doc):
base.shutdown.port=5072
base.jmx.port=5959
bio.http.port=5050
bio.https.port=5443
This step is required because all instances
use the default port 8080. Changing the port numbers in the catalina.properties
file avoids port conflict.
Step
6: à validate <tcServerXmsAgentInstance>\Conf\context.xml
file. antiJARLocking and antiResourceLocking attribute should be false or
shouldn’t mention within <context> tag.
<context> à Correct format
<Context
antiJARLocking="true" antiResourceLocking="true">
à Incorrect
If we are suppose to mention those attributes
with Context tag, we will loose xms-agent password and provisioning
environment, when we will restart our app server instance. Then we have to
create new password (Although password may be same) and new provisioning
environment in every session. To persist those thing (xms-agent Password and
provisionoing environment ), we shouldn’t use those 2 attributes with context
tag.
Step
7:àDownload the xms-agent.war file to your local
system and place it in the following folder:
<tcServerXmsAgentInstance>\webapps
Step
8:àNavigate to <xms-tools-home>
and copy the Catalog folder.
Step
9:àPaste the folder in the location where you
want xMS to maintain catalog information and log files.
Step
10:àSet the XMS_DATA_DIR environment variable, in
wrapper.conf located in
<tcServerXmsAgentInstance>\conf, add the following line:
wrapper.java.additional.$$="-DXMS_DATA_DIR=<Catalog
location>"
e.g. wrapper.java.additional.14="-DXMS_DATA_DIR=C:\xms-tools-1.1\catalog"
We already mentioned this steps in step 2.
Step
11:à restart app server/instance, verify with
following url:
http://localhost:5050/xms-agent
Step
12:à On a Windows machine, run the xMS Agent
configuration script:
Step
12.a:à Connect to xMS Agent:
Set up xMS Tools and open the <xms-tools-home>\config\xms-server.properties
file. Specify the IP address of the machine where the xMS Agent is running and
the port number on which the xMS Agent is listening.
If you are deploying to a clustered
environment, specify the IP address and port number of the primary node of the
xCP application host cluster. For the xms-server-context-path
property, type xms-agent. These entries point
xMS Tools to the xMS Agent running on the application server.
Edit xms-server. properties @ <xms-tools-home>\config\xms-server.properties
and add/update following statements:
xms-server-host
= 127.0.0.1
xms-server-port
= 5050
#xms-server-schema
= <server host protocol.http or https>
xms-server-schema=http
xms-server-context-path
= xms-agent
Step
12.b:à Set up a password for the xMS Agent admin
user: Double-click xms.bat in <xms-tools-home>\bin. At the
prompt, type a password. Repeat to confirm the password. The EMC Documentum
xCelerated Management System Deployment Guide describes how to create and
configure additional users. Close the xms.bat console.
Note:- JAVA_HOME should point to java 1.7
Step
12.c:à Start the xMS Agent configuration script:
Double-click configure-xms-agent.bat in <xms-tools-home>\bin.
Step12.d:à In the new console, specify the password
(created in 12.b) for the xMS Agent admin user.
Step
12.e:à The
system imports the following configuration information:
• The
bootstrap-dctm-configuration.xml file from <xms-tools-home>\config
• Default environment templates
from <xms-tools-home>\blueprints\module-templates
Step
13:à You can now use the xMS Management Center to
register an environment by accessing following url
http://localhost:5050/xms-agent
user:admin
password:Reims.408
Registering a Environment through xms-agent
managemtn center
Step 1:à Access the following url:
http://localhost:5050/xms-agent
user:admin
password:Reims.408
Step 2:à User name:- admin, password:Reims.408
Actually , the password would be same as that
we will supposed to set it througn xms.bat, under xms-tools-1.1\bin.
Step 3:à
Step 4:àClick on catalog tab, then select one existing
environemnt.
Click on update template and after that click
on “create Template“.
Step 5:à provide the require informatio to create a
new custom template.
Step 6:à Click on “Environment“ tab and then click on “create Environment“. We can’t
create more than one environment within a xms.
Step 7:àprovide the require info.
Step 8: à provide account info for this environment.
User:dmadmin
Password:demo.demo
Step 9:à Add CustomHostGroup
Click on Add, to add new HostGroup
Step 10:à Click on Host tab to add host. We can’t create
multiple host with same host name or multiple host with same host IP.
But we can associate multiple host with same
host group (Not tested yet).
Step 11. à Click on “Services “ tab to configure host
details and other stuffs , for all services. Select service (one at a time) and
click on edit button
Step 12:àClick on properties (default) tab, and provide
require details. We should select only those host group (from corresponding
drop down), which are mapped with host. Here we couln’t find which host group
is mapped with host or not, but if we will select incorrect host group , it
would create problem in next steps.
Step 13:àClick on Endpoints tab, and provide the
endpoint details, by selecting endpoints and then click on edit button. Use
superuser credentials for all services, except few.
For App host service , provide login
credential whatevre we will supposed to provide during the configuration of
AppServer instance. We already did this stuff in starting , by updating tomcat-user.xml file.
Here it would be:
User:- admin
Pwd:-admin
For xPlore Service, we should use Installation
user credential in Endpoint definiton.
Step 14:- After creating environment, we have
to synchronize this environment, otherwise we will probably lost this
configuration when we restart our app server.
Click on the Environment tab and select the
environment and then click on “Maintenance“ button
Do the selected stuffs
Now the status of environment would be
“Maintenance“,
Click on refresh button, after few minutes,
the status becomes “Provisioned“
Step 15:à Check the status of the environment
Step 16:à Create xcp App and deploy it.
Before deployment , we need to configure
xms-agent in designer, do the follwoing selected in screen shots.
In this document , I am not
mentioning the steps for CS installtion and xPlore installation. We are just
going through the steps which are required for xCP2.1 Configuration.
All Components are being install
or configure on one single machine (same machine).
Software requirement:
IE 8 or Higher
SQL Server R2 2008
Documentum content
Server 7.1
xPlore Server-1.4
Tc Server (vfabric-tc-server-developer-2.9.6.RELEASE.msi)
BAM server (bam-server.war, compatible to CS
and xcp version)
BPM-2.1 (Process Engine) (compatible to CS and xcp version)
Bps.war (Process
Integrator) (compatible to CS and
xcp version)
BPM.Ear (compatible to CS and xcp version)
xms-agent-1.1 (compatible to CS and xcp version)
xms-tools-1.1 (compatible to CS and xcp version)
CTS(MTS, ADTS,AVTS) (compatible
to CS and xcp version)
CIS (compatible
to CS and xcp version)
<AppServerHost> All App Server Instances
<tcServerXcpInstance> C:\tcserver\xcpInstance
(port:8000)
<tcServerAppInstance> C:\tcserver\appInstance
(DA, port :7000)
<tcServerXmsAgentInstance> C:\tcserver\xmsagent
(port:5050)
<CIS installation
directory> C:\Documentum\CTS\CIS
<xms-tools-home> C:\xms-tools-1.1
TC Server Instances
Create multiple
instance of tc server or Tomcat server, but following port should be different
in every instances (Edit catalina.properties):
base.shutdown.port=7072
base.jmx.port=7073
bio.http.port=7070
bio.https.port=7071
In this document, we
are supposed to create 3 instances of tc server, with following port details:
AppInstance:
base.shutdown.port=-1
base.jmx.port=6969
bio.http.port=7000
bio.https.port=7443
bio-ssl.https.port=7443
xCPInstance:
base.shutdown.port=-1
base.jmx.port=6969
bio.http.port=8000
bio.https.port=8443
bio-ssl.https.port=8443
xmsAgentInstance:
base.shutdown.port=5072
base.jmx.port=5959
bio.http.port=5050
bio.https.port=5443
bio-ssl.https.port=5443
We could specify
these ports, during the instance creation of tc server, but for tomcat we have
to modify the catalina.properties under conf directory. We could also change
these port in same file under the same folder, for tc server.
Ideally we should
change base.shutdown.port also, means it should be unique, in case all
instances are on same machine.
So, the base url for
these instance would be:
AppInstance: http://localhost:7000
xCPInstance: http://localhost:8000
xmsAgentInstance: http://localhost:5050
Add users in all
appServer instances:
Add users in
tomcat-users.xml in folder <AppServerHost>\conf .
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="admin-gui"/>
<role
rolename="admin-script"/>
<role
rolename="manager-gui"/>
<role
rolename="manager-script"/>
<role
rolename="manager-jmx"/>
<role
rolename="manager-status"/>
<user username="tomcat"
password="tomcat" roles="tomcat"/>
<user username="both"
password="tomcat" roles="tomcat,role1"/>
<user username="role1"
password="tomcat" roles="role1"/>
<user username="admin"
password="admin"
roles="tomcat,role1,admin-gui,manager-gui,manager-script"/>
</tomcat-users>
Edit web.xml file,
add following lines, under folder <AppServerHost>\conf
<init-param>
<param-name>enablePooling</param-name>
<param-value>false</param-value>
</init-param>
After configuration, port
& url for the all installed com[ponents would be
xPlore DSearch:- http://localhost:9300/dsearch
xPlore Indexagent:- http://localhost:9200/IndexAgent
bam server:- http://localhost:8000/bam-server
http://localhost:8000/bps/versions.jsp
http://localhost:8000/bps/lsnrs.jsp
http://localhost:8000/bps/webservice
http://localhost:9080/bpm/outbound_details.jsp
http://localhost:9080/bpm/servlet/DoMethod
xms-agent :- http://localhost:5050/xms-agent
OR
http://127.0.0.1:5050/xms-agent
Thumnail server:- http://localhost:8081/thumbsrv/getThumbnail
CTS:- http://localhost:9095/CTSAgent/CTSAgent
Ports:-
CIS:- 8079/1099
CTS:- 9095
and 9096, for its web-services
MTS:- 9095
ADTS:- 9095
AVTS:- 9095
BAM Deployment for xCP2.1
step 1:--> Add users, if it is not exist, in
tomcat-users.xml in folder <tcServerXcpInstance>\conf
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="admin-gui"/>
<role
rolename="admin-script"/>
<role
rolename="manager-gui"/>
<role
rolename="manager-script"/>
<role
rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="tomcat"
password="tomcat" roles="tomcat"/>
<user username="both"
password="tomcat" roles="tomcat,role1"/>
<user username="role1"
password="tomcat" roles="role1"/>
<user username="admin"
password="admin" roles="tomcat,role1,admin-gui,manager-gui,manager-script"/>
</tomcat-users>
We are adding users in
this file just for accessing app server.
Step 2:--> Download the bam-server.war , unzip
and deploy it under <tcServerXcpInstance>\webapps directory.
Step 3:--> Change the value of bam.properties file
under path " <tcServerXcpInstance> \webapps\bam-server\WEB-INF\classes\config\bam.properties".
But before below
steps, we have to create a database(should be case sensetive, in sql server set
collation as Latin1_General_CS_AS) for BAM, here I created a DB with name BAM and to access this DB, created
user with name BAMADMIN and password BAMADMIN. Initial size of DB should be
1000 MB . Log file size should be at least 500 MB.
bam.properties should
be something like below:
bam.encrypt=true
bam.jdbc.dialect=mssql
bam.jdbc.url=jdbc:sqlserver://localhost;databasename=BAMDB;SELECTMETHOD=Cursor
bam.jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
bam.jdbc.userName=BAMADMIN
bam.jdbc.password=BAMADMIN
bam.jdbc.preference.maxRows=10000
bam.jdbc.preference.deployBatchSize=2500
bam.jdbc.preference.dataFormatBatchSize=1000
bam.jdbc.preference.initialSize=10
bam.jdbc.preference.maxIdle=-1
bam.jdbc.preference.maxActive=-1
bam.dfc.session.repository=TestingRepo
bam.dfc.session.repositoryUserName=Administrator
bam.dfc.session.repositoryPassword=Reims.408
bam.cluster.ttl = 1500
bam.cluster.pulse = 500
bam.cluster.activateOnStartup= false
Step 4:--> Create folder named bam(in lower case)
in <tcServerXcpInstance>
directly.
Step 5:-->
Now, copy the same bam.properties file(from Step 3) in folder bam under <tcServerXcpInstance>.
Step 6:--> Copy log4j.properties file from " <tcServerXcpInstance>
\webapps\bam-server\WEB-INF\classes" folder and paste it in a folder named bam under <tcServerXcpInstance>.
Step
7:à Create and copy the dfc.properties file for
the application to reference the repository, as follows:
7.a. Create a Customconf folder at the root of the
application server instance:
<tcServerXcpInstance> /Customconf.
7.b. Copy the dfc.properties file from the
%Documentum%\Config folder , from Content Server to
the above location.
7.c. Create the rest-api-runtime.properties file
in the <tcServerXcpInstance> /Customconf folder and add these
properties to the end of the file:
rest.user.private.session.preferred=true
(Optional) Set this property for performance
tuning of the MS SQL Server:
rest.api.paged_query_template.db_hint.com.emc.documentum.rest.dfc.impl.query.FolderChildrenQueryTemplate=SQL_SERVER(’FORCESEEK’)
7.d. Open the dfc.properties file in <tcServerXcpInstance>
/Customconf and add the following:
dfc.session.allow_trusted_login =
false
dfc.docbroker.host[0]=WIN-BU8P0V1FYQK
dfc.docbroker.port[0]=1489
dfc.docbroker.host[1]=WIN-BU8P0V1FYQK
dfc.docbroker.port[1]=1589 Save your changes.
7.e.
Create a file , “ <tcServerXcpInstance> \Customconf\deployment.properties“ with following
content:
xcp.repository.name=TestingRepo
7.f.
Modify file “ <tcServerXcpInstance>
\conf\catalina.properties“,
add following content (already mentioned above):
base.shutdown.port=-1
base.jmx.port=6969
bio.http.port=8000
bio.https.port=8443
bio-ssl.https.port=8443
Step 8:àModify
wrapper.conf file (“<tcServerXcpInstance>\conf\wrapper.conf“)
Add
wrapper.java.additional.8="-Xss192K"
wrapper.java.additional.9="-Xmx1024M"
wrapper.java.additional.10="-XX:MaxPermSize=256m"
wrapper.java.additional.11="-Xms1024M"
wrapper.java.additional.12="-Dbam.properties=C:\tcserver\xcpInstance\bam\bam.properties"
wrapper.java.additional.13="-Dlog4j.configuration=C:\tcserver\xcpInstance\bam\log4j.properties"
Add
wrapper.java.classpath.5= <tcServerXcpInstance> \Customconf
Step 9:--> Changes in context.xml file under
directory " <tcServerXcpInstance> \conf"
Replace
<Context> with <Context antiJARLocking="true" antiResourceLocking="true">
Step 10:-->
Changes in server.xml file under
directory " <tcServerXcpInstance> \conf" , it is not applicable
for TC Server, require only for Tomcat. In TC server, instead of explicit ports
and other values , it will already have variable, that will be mentioning in
cataline.properties.
Add attribute
URIEncoding="UTF-8" with connector tag, e.g.,
<Connector port="8080"
protocol="HTTP/1.1" URIEncoding="UTF-8"
connectionTimeout="20000"
redirectPort="8443"
/>
Step 11:-->
Changes in web.xml file under
directory " <tcServerXcpInstance> \conf"
<init-param>
<param-name>enablePooling</param-name>
<param-value>false</param-value>
</init-param>
Step 12:--->
Copy dfc.properties file from documentum/config and paste it in " <tcServerXcpInstance>
\webapps\bam-server\WEB-INF\classes" folder.
Step 13:-->
Change the value of " <tcServerXcpInstance> \webapps\bam-server\bam-server.properties",
i.e.,
bam.server.host=localhost
bam.server.port=8000
bam.server.context=bam-server
#bam.server.protocol=https
Step 14:--> Download
xcp-runtime-2.0.zip and extract all jar files, copy these jar files in folder
TOMCAT_HOME\lib. (NA for 2.1, In xCP 2.0, xCP runtime libraries were bundled separately.
It was mandatory to copy xCP runtime JAR libraries to the lib folder of the
application server. Both the BAM server and the xCP application required these
JAR files. For xCP 2.1, the BAM server and xCP application WAR files are
packaged differently. The BAM Server and xCP application contain all necessary
xCP runtime JAR library files within their respective WAR files under
WEB-INF\lib. So, it is necessary to ensure that the lib folder of the
application server does not contain any of the xCP runtime libraries to avoid
conflict with the JAR files packaged within the WAR files of the BAM server and
xCP application.)
Step 15:--> Check the sql server port, because BAM get
connect with sql server through port 1433. This can be checked through sql
server configuration manager. OR
commandprompt>netstat
-abn
shows details of ports
which are currently in used. If u don't get port 1433 in list, then try to add,
through Sql Server Configuration Manager(refer below screen shots.)
Sql Server
Configuration Managerà Sql Server Network Configuration à Protocols for
SQL Express à TCP/IPàIP Address àTCP PORTà1433
TCP/IP should be
enabled.
Step 16:-->
Download xms-tools-1.1.zip and unzip it. Copy the content of manager.war
file and copy or merge with existing one in <tcServerXcpInstance>
\webapps folder.
After performing Step 16, we are unable to
open management console of tomcat. [If you are using tc Server Developer Edition, the
Application Manager is available in the application server by default. Verify
that the Application Manager is running by opening the following URL in a
browser:
http://localhost:8000/manager/html
Log in using the user
credentials you created for the application instance.
If you are using the
manager.war file provided in the xms-tools.zip file for xCP deployment, you
cannot access the Tomcat manager user interface using the above URL. In this
case, deploy an application to verify if the Application Manager is running correctly.
Also, view the application server logs to check for any errors. If there are no
errors, the manager.war is deployed correctly.]
Now, start the tomcat
server, if bam server has deployed successfully , the content of bam.properties
file under directory <tcServerXcpInstance> \bam,
would be changed. Now, it would be as follow:
#do not touch the
'bam.encrypted' parameter!!!!!!
#Sat Aug 16 19:58:42
PDT 2014
bam.jdbc.preference.maxIdle=-1
bam.jdbc.dialect=mssql
bam.jdbc.preference.deployBatchSize=2500
bam.dfc.session.repositoryUserName=Administrator
bam.encrypt=true
bam.encrypted=true
bam.jdbc.preference.dataFormatBatchSize=1000
bam.cluster.ttl=1500
bam.jdbc.preference.initialSize=10
bam.jdbc.userName=BAMADMIN
bam.jdbc.preference.maxActive=-1
bam.jdbc.url=jdbc\:sqlserver\://localhost;databasename\=BAMDB;SELECTMETHOD\=Cursor
bam.dfc.session.repository=TestingRepo
bam.jdbc.password=AAAAEBEgHQZ2bNSm6YIX4rThkLgFDDZEmMWfkKOk5Wg9lKS+
bam.jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
bam.cluster.activateOnStartup=false
bam.dfc.session.repositoryPassword=AAAAELODkr6JpqVpO2UEjR5NFXk/j86dK59e0taAP1jtZ25z
bam.jdbc.preference.maxRows=10000
bam.cluster.pulse=500
Step 17:--> Start the <tcServerXcpInstance> and
try the following URL in browser
login with “dmadmin“
credential, “dmadmin“ is super user. After successful logged-in, you will get
welcome page.
Credentials:
User: dmadmin
Pasword:demo.demo
OR
User: Administrator
Pasword:Reims.408
Configuring BPM by installing Process engine on CS
machine.
Step1:- Start Connection Broker and all
Repositories
Step
2:- Before
installing Process Engine, ensure that Java Method Server (JMS) service
is stopped.
Step
3:- unpacking
Process_Engine_win.zip creates a folder named Process_Engine_win
Step
4:- run
installation programs - peSetup.exe
Step
5:- Click Done to
close the Process Engine Installation wizard
Step
6:- Restart the Content Sever and Java Method Server.
Step
7:- To verify that the Process Engine installation is
successful:
http://localhost:9080/bpm/outbound_details.jsp
http://localhost:9080/bpm/servlet/DoMethod
http://localhost:9080/bpm/modules.jsp
if bpm.ear file, doesn’t gets install on JMS,
download it from subscriber net and configure it in JMS.
I’ve not remembered, how did it gets install,
whether it is automatically configured through the Process engine installation
steps or I did it manually by downloading it from subscriber net.
But the path where this bpm.ear file should be exist, is as
follow , this path is changed in CS7.1:
C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments
BPS (Process Integrator) installation with xCP2.1
Step 1:---> Download the bps.war, deploy it in <tcServerXcpInstance>
\webapps directory.
Step 2:---> Change the dfc.properties file in WEB-INF
directory of <tcServerXcpInstance> \webapps\bps directory.
Step 3:---> Update the file name
"bps_template.xml" under directory
<tcServerXcpInstance> \webapps\bps\WEB-INF.
<polling_interval>300</polling_interval>
<message_store_home_dir>C:\\Documentum\\BPS\\message_store</message_store_home_dir>
<instance_name>bps1</instance_name>
<ha_enabled>FALSE</ha_enabled>
<config_properties>
<property
name="mail.imap.partialfetch" value="false"/>
<property name="mail.debug"
value="false"/>
</config_properties>
<connections>
<docbase-connection>
<docbase>TestingRepo</docbase>
<user>Administrator</user> !—Superuser
Credentials--
<password>Reims.408</password>
<domain/>
</docbase-connection>
</connections>
Step 4:--> Changes in catalina.bat file under
directory "TOMCAT_HOME\bin", applicable for tomcat instance only
set
JAVA_OPTS=%JAVA_OPTS% %LOGGING_MANAGER% -Xss256k -Xms256m -Xmx512m -XX:MaxPermSize=128m
-XX:+UseParallelOldGC -Xdebug -Xnoagent
-Xrunjdwp:transport=dt_socket,server=y,suspend=n
-Dbam.properties=C:\TOMCAT80\bam\bam.properties -Dlog4j.configuration=file:///C:\TOMCAT80\bam\log4j.properties
we should add above
statement below following statement in
catalina.bat. , applicable for tomcat instance only
set JAVA_OPTS=%JAVA_OPTS%
%LOGGING_MANAGER%
For tc server, we have
to make those changes in wrapper.conf file, that we already did , during BAM
configuration, because we are using same TC Server instances for both BAM and
BPS.
Step 5:-->
Verify the installation by accessing following links:
http://localhost:8000/bps/inbound_details.jsp
http://localhost:8000/bps/webservice
http://localhost:9080/bpm/outbound_details.jsp -->Content Server Link
IP
Thumbnail Server
Step 1:--> Download and install dar file for
thumbnail server.
Step 2:--> Download and unzip the file
Thumbnail_Server_7.1_windows.zip, and start the installtion process
Step 3-->
Step 4:-->
Step 5:-->
Step 6:-->
Step 7:- Start menu à Apply
Thumbnail server support to docbase.
Follow steps to complete this
installation.
Step 8:- Verify the
installation:
CIS Installation
After installing CIS (it is a normal installation), do following steps
Verifying
the deployment of CIS artifacts (DAR file)
After you deployed
CIS DAR file (cis_artifacts.dar), check in Documentum Administrator that the modules
were created.
1. Log in to
Documentum Administrator.
2. Navigate to Cabinets
> System > Modules > Aspect and check that the module cis_annotation_aspect
is
present.
3. Verify that the
tables dm_annotation and dm_object_annotations
have
been created.
Verifying
that the repository was enabled for CIS
When you enable a
repository for CIS, a number of sections and folders are created. You can check
their existence to make sure that the repository has been successfully enabled.
To
check the existence of CIS sections and folders in the repository:
1. Log in to
Documentum Administrator.
2. Navigate to Content
Intelligence node
and verify that the following sections are present:
• Taxonomies
• Category Class
• Document Set
•
My Categories
Navigate to Cabinets
> System > Applications > CI and verify that the following folders
are present:
• AttributeProcessing
• Classes
• Configuration
• DocsetConfiguration
• DocumentSets
• MetadataExtrationRules
• Runs
• TaxonomySnapshots
• XMLTaxonomies
Verifying
that the tables were created
The following tables are
created in the repository for CIS:
• When the repository is
enabled, the table dm_docstatus is created.
• When CIS DAR file
(cis_artifacts.dar) is deployed, the tables dm_annotation and dm_object_annotations
are created.
To check the existence of
the tables:
1. Log in to Documentum Administrator.
2. Select Tools > DQL
Editor.
3. Run the query to check
the existence of the dm_docstatus table:
Select * from dm_docstatus
The result structure must
be:
st_object_id, st_docset_id, st_mode, st_last_modified, st_date
4. Run the query to check
the existence of the dm_annotation table:
Select * from dm_annotation
The result structure must
be:
ann_id, ann_type, ann_value
5. Run the query to check
the existence of the dm_object_annotations table:
Select * from
dm_object_annotations
The result structure must
be:
ann_object_id, ann_index, ann_chronicle_id, ann_confidence, ann_id
Verifying
the configuration of the entity detection server
CIS server needs to
communicate with the entity detection server to start the detection process,
and retrieve the entities.
To
verify the configuration of the entity detection server:
1. On CIS host, open the
configuration file <CIS installation directory>/config/ cis.properties.
2. Check that the property
cis.entity.luxid.annotation_server.host indicates the IP address of the entity
detection server.
Verifying
that all services are started
To make sure that all
services for the entity detection server are started, check the Temis
Luxid
Started
icon
in the notification area (usually on the right of the taskbar). When all
services are started,
the tooltip indicates
“Temis Luxid Started”. On the contrary, if some services have not started, the
tooltip indicates the
number of services started.
On Windows hosts, the CIS
services are installed in automatic startup mode. You can make sure that
all services are started
correctly, and, if not, start them manually or reboot to start them
automatically.
To
verify the status of the services (Windows hosts):
1. Select My
Computer > Manage > Services and Applications > Services.
2. Make sure the service Documentum
Content Intelligence Services is started. If not, start it.
3. For the entity detection
analysis, make sure that the following services are started:
• Documentum CIS Luxid IDE
Server v2
• Documentum CIS Luxid Admin
Server
• Documentum CIS Luxid
Annotation Node
• Documentum CIS Luxid
Annotation Server
• Documentum CIS Luxid SVN
Service
• Documentum CIS Luxid
Vinci Naming Service
• Documentum CIS Luxid
Xelda Service
If
you start them manually, start them in the specified order.
CTS installation:
It’s basic
installation doc , where we are basically mentioning, what components we need
to install with and for CTS, that is require for xCP2.1. Here we are not
dealing with the profile creation or all other steps , that is require for
fully working of CTS.
Step 1>> Install
following dar file in docbase
CTSActivity.dar, CTSAspects.dar, Rich_Media_Services.dar,
Transformation.dar, xCP_Viewer_Services.dar, ImageServices.dar
Step 2>> Double
click the all 3 following file to install this version of the Content
Transformation Services product.
• adtsWinSetup.exe to
install Advanced Document Transformation Services.
• mtsWinSetup.exe to
install Media Transformation Services.
• avtsWinSetup.exe to
install Audio Video Transformation Services.
Step 3>> Only
those Content Transformation Services products that you have already installed
are listed during "Configuring an instance of a Content Transformation
Services server".
Step 4>> To
configure an instance of Content Transformation Server:
Select the CTS
Configuration Utility located at Start > Programs.
The Content Transformation Services
Configuration Utility screen appears, follow the steps.
Step 5>> Verify
if the following Windows services have been started using services.msc:
·
Documentum
Content Transformation Services
·
Documentum
Content Transformation Monitor Services
·
Documentum
CTS Admin Agent
xMS Agent-1.1 installation
For xCP2.1
Step 1:à Create a new
TC Server instance or choose any instance where you want to deploy xms-agent,
but never deploy this xms-agent along with DA.
Step
2:à Stop the tc Server instance.Edit wrapper.conf located in <tcServerXmsAgentInstance>\<server_instance>/conf.
Add / modify follwoing statements:
wrapper.java.additional.8="-server"
wrapper.java.additional.9="-Xss192K"
wrapper.java.additional.10="-Xmx1024M"
wrapper.java.additional.11="-XX:MaxPermSize=256m"
wrapper.java.additional.12="-Xms1024M"
wrapper.java.additional.13="-XX:+UseParallelOldGC"
#wrapper.java.additional.14="-XX:+UseCompressedOops"
wrapper.java.additional.14="-DXMS_DATA_DIR=C:\xms-tools-1.1\catalog"
Step
3:àStart tc server instance and check whether it
is working or not, by following url in browser:
http://localhost:5050
Step
4:àAgain Stop tc server instance
Step
5:à In the catalina.properties file located in <tcServerXmsAgentInstance>\conf,add
the following (We already mentioned this , in beginning of this doc):
base.shutdown.port=5072
base.jmx.port=5959
bio.http.port=5050
bio.https.port=5443
This step is required because all instances
use the default port 8080. Changing the port numbers in the catalina.properties
file avoids port conflict.
Step
6: à validate <tcServerXmsAgentInstance>\Conf\context.xml
file. antiJARLocking and antiResourceLocking attribute should be false or
shouldn’t mention within <context> tag.
<context> à Correct format
<Context
antiJARLocking="true" antiResourceLocking="true">
à Incorrect
If we are suppose to mention those attributes
with Context tag, we will loose xms-agent password and provisioning
environment, when we will restart our app server instance. Then we have to
create new password (Although password may be same) and new provisioning
environment in every session. To persist those thing (xms-agent Password and
provisionoing environment ), we shouldn’t use those 2 attributes with context
tag.
Step
7:àDownload the xms-agent.war file to your local
system and place it in the following folder:
<tcServerXmsAgentInstance>\webapps
Step
8:àNavigate to <xms-tools-home>
and copy the Catalog folder.
Step
9:àPaste the folder in the location where you
want xMS to maintain catalog information and log files.
Step
10:àSet the XMS_DATA_DIR environment variable, in
wrapper.conf located in
<tcServerXmsAgentInstance>\conf, add the following line:
wrapper.java.additional.$$="-DXMS_DATA_DIR=<Catalog
location>"
e.g. wrapper.java.additional.14="-DXMS_DATA_DIR=C:\xms-tools-1.1\catalog"
We already mentioned this steps in step 2.
Step
11:à restart app server/instance, verify with
following url:
http://localhost:5050/xms-agent
Step
12:à On a Windows machine, run the xMS Agent
configuration script:
Step
12.a:à Connect to xMS Agent:
Set up xMS Tools and open the <xms-tools-home>\config\xms-server.properties
file. Specify the IP address of the machine where the xMS Agent is running and
the port number on which the xMS Agent is listening.
If you are deploying to a clustered
environment, specify the IP address and port number of the primary node of the
xCP application host cluster. For the xms-server-context-path
property, type xms-agent. These entries point
xMS Tools to the xMS Agent running on the application server.
Edit xms-server. properties @ <xms-tools-home>\config\xms-server.properties
and add/update following statements:
xms-server-host
= 127.0.0.1
xms-server-port
= 5050
#xms-server-schema
= <server host protocol.http or https>
xms-server-schema=http
xms-server-context-path
= xms-agent
Step
12.b:à Set up a password for the xMS Agent admin
user: Double-click xms.bat in <xms-tools-home>\bin. At the
prompt, type a password. Repeat to confirm the password. The EMC Documentum
xCelerated Management System Deployment Guide describes how to create and
configure additional users. Close the xms.bat console.
Note:- JAVA_HOME should point to java 1.7
Step
12.c:à Start the xMS Agent configuration script:
Double-click configure-xms-agent.bat in <xms-tools-home>\bin.
Step12.d:à In the new console, specify the password
(created in 12.b) for the xMS Agent admin user.
Step
12.e:à The
system imports the following configuration information:
• The
bootstrap-dctm-configuration.xml file from <xms-tools-home>\config
• Default environment templates
from <xms-tools-home>\blueprints\module-templates
Step
13:à You can now use the xMS Management Center to
register an environment by accessing following url
http://localhost:5050/xms-agent
user:admin
password:Reims.408
Registering a Environment through xms-agent
managemtn center
Step 1:à Access the following url:
http://localhost:5050/xms-agent
user:admin
password:Reims.408
Step 2:à User name:- admin, password:Reims.408
Actually , the password would be same as that
we will supposed to set it througn xms.bat, under xms-tools-1.1\bin.
Step 3:à
Step 4:àClick on catalog tab, then select one existing
environemnt.
Click on update template and after that click
on “create Template“.
Step 5:à provide the require informatio to create a
new custom template.
Step 6:à Click on “Environment“ tab and then click on “create Environment“. We can’t
create more than one environment within a xms.
Step 7:àprovide the require info.
Step 8: à provide account info for this environment.
User:dmadmin
Password:demo.demo
Step 9:à Add CustomHostGroup
Click on Add, to add new HostGroup
Step 10:à Click on Host tab to add host. We can’t create
multiple host with same host name or multiple host with same host IP.
But we can associate multiple host with same
host group (Not tested yet).
Step 11. à Click on “Services “ tab to configure host
details and other stuffs , for all services. Select service (one at a time) and
click on edit button
Step 12:àClick on properties (default) tab, and provide
require details. We should select only those host group (from corresponding
drop down), which are mapped with host. Here we couln’t find which host group
is mapped with host or not, but if we will select incorrect host group , it
would create problem in next steps.
Step 13:àClick on Endpoints tab, and provide the
endpoint details, by selecting endpoints and then click on edit button. Use
superuser credentials for all services, except few.
For App host service , provide login
credential whatevre we will supposed to provide during the configuration of
AppServer instance. We already did this stuff in starting , by updating tomcat-user.xml file.
Here it would be:
User:- admin
Pwd:-admin
For xPlore Service, we should use Installation
user credential in Endpoint definiton.
Step 14:- After creating environment, we have
to synchronize this environment, otherwise we will probably lost this
configuration when we restart our app server.
Click on the Environment tab and select the
environment and then click on “Maintenance“ button
Do the selected stuffs
Now the status of environment would be
“Maintenance“,
Click on refresh button, after few minutes,
the status becomes “Provisioned“
Step 15:à Check the status of the environment
Step 16:à Create xcp App and deploy it.
Before deployment , we need to configure
xms-agent in designer, do the follwoing selected in screen shots.
No comments:
Post a Comment