Apart from installation and setting up of documentum server and clientenvironment, there are many important tasks which needs to be handled by an Administrator in order for smooth and proper functioning of the set up.
Some of the tasks are mentioned below:1. Modifying the configurations of servers, docbroker.2. Creating new Docbases.3. Maintaining Docbases.4. Configuring, starting and shutting down servers.5. Changing session configuration.6. Managing content storage areas and content files.7. Managing users and groups.8. Managing security.
Utilities for Easy Handling of Administrative Task:
1.dm_error utilityWe encounter various content server errors with just with an error codewithout much information about it. Documentum has defined all the errorswith an expanded statement of the error, possible causes of it andprescribes possible solutions for the error. Utility should be executed in thecommand prompt of the content server.Syntax: dm_error
2.PreLoad UtilityAdministrator operations include activities called Dumping and Loading Docbase.Dump and Load operations can be used to do the following activities:a. Move a Docbase to one location to another.b. Duplicate a Docbase.c. Duplicate or move some portion of the Docbase.A dump operation creates a binary file of objects dumped from a Docbase. If a dumped object has associated content files, the content files are eitherreferenced by full path or included directly in the dump file. The load operation loads the objects and content files into another Docbase.PreLoad utility can be run on a dump file created to tell what all objects thatshould be created in the new Docbase before loading the dump file. Utility can also be used to create a DQL script that you can edit and then run to create the needed objects.Syntax:preload docbase [-Uusername] -Ppassword -dump_file filename [-script_file name]The docbase is the name of the Docbase into which you are loading the dumpfile. Filename is the name of the dump file, and name defines a name for theoutput DQL script. If you do not include a username, the current user isassumed.Note: This utility does not report all storage areas in the source Docbase, butonly those that have been copied into the dump file.
3.dmclean UtilityEvery Docbase requires a scheduled clean up need to be performed byadministrator. One such clean up includes removing orphaned content files.When users delete a document, or any object that has a content file associated with it, the system deletes the object and marks the content as an orphan. The system does not delete the actual content file. This must be done using the dmclean utility. Dmclean can be run using:
a. Documentum Administrator.b. A DQL EXECUTE statement.Syntax:EXECUTE do_methodWITH method = ’dmclean’,arguments = ’-no_content -no_note -no_wf_template’c. An Apply methodSyntax:apply,session,NULL,DO_METHOD,METHOD,S,dmclean, ARGUMENTS,S,’-no_content -no_note -no_wf_template’d. From Content Server command promptdmclean -docbase_name docbase -init_file init_file_name-no_content -no_note -no_wf_templateWhere wheredocbase is the name of the Docbase and init_file_nameis the name of the server.ini start up file for the Docbase’s server.
4.dmfilescan UtilityThis utility is used to scan the one or more storage area and find any contentfiles that do not have associated content objects. The utility scans for orphaned files which are over 24 hours old.Running the utility using EXECUTE statement:EXECUTE do_method WITH method = ’dmfilescan’,[arguments = ’[-s storage_area_name] [,-from directory1][,-to directory2]’]The utility automatically saves the output to a document that is stored inthe Temp cabinet. FALSE.) The output is a generated script that includesthe informational messages generated by the utility.Running the utility using Content Server command prompt:dmfilescan -docbase_name name -init_file init_file_name[-s storage_area_name][-from directory1][-to directory2]The init_file_name is the name of Content Server’s server.ini file. This isone of the server start up files.
5.dm_crypto_change_passphrase UtilityEvery installation of a Content Server creates a key called AdministrationEncryption Key (AEK). This is used to encrypt:a. The Docbase keys.b. Documentum passwords, such as those used by Content Server toconnect to the RDMS or any other Docbase.This AEK is stored at: %DOCUMENTUM%\dba\secure\aek.key and this key also are encrypted using a default passphrase provided by Documentum. It is always advisable to change the default passphrase. To change the default passphrase we can use dm_crypto_change_passphrase Utility.Syntax:dm_crypto_change_passphrase [-location location][-passphrase[old_passphrase]][-newpassphrase [new_passphrase]][-noprompt][-help]Location is the place where AEK is placed for which we need to change thepassphrase.old_passphrase is the old passphrase name.new_passphrase is the new passphrase name.-noprompt should be used if any one the argument mentioned above is notused. It’s like the end specify mentioning the end of arguments.-help returns help information for the utility.
6.IAPI UtilityIAPI Utility is used to issue direct method call to the server.Running the utility from the server command prompt:iapi32 [-Uusername|-ENV_CONNECT_USER_NAME][-Pos_password|-ENV_CONNECT_PASSWORD] [-Llogfile] [-X][-E][-V-][-Q] docbase|-ENV_CONNECT_DOCBASE_NAME [-Rinputfile][-Ftrace_level][-Sinit_level][-Iescape_character][-zZ][-Winteger][-Ksecure_mode]Order of the parameter does not hold importance.Username- Identifies the name who is starting the session.ENV_CONNECT_USER_NAME- User name in looked in the environmentvariable DM_USER_NAME.Password- User’s operating system password.ENV_CONNECT_PASSWORD- Password is looked in the environmentvariable DM_PASSWORD.-Llogfile – Directs the server to start a log file for the session.You must include the file name with the argument. You can specify afull path.-X Allows prompt for domain.-E Turns on echo.-V- Turns verbose mode off. The utility runs in verbosemode by default. If you turn verbose mode off, thesystem does not display the IAPI prompt, errormessages, or any responses to your commands(return values or status messages).-Q Directs the utility to provide a quick connection test. The utility attempts to connect and exits with a status of zero if successful or non-zero if not.It provides error messages if the attempt is not successful.Docbase- Docbase name which is intended to access.ENV_CONNECT_DOCBASE_NAM – finds the name of the docbasefrom environment variable DM_USER_NAME.-Rinputfile input file with API methods.-Ftrace_level Turns tracing on.-Sinit_level Defines the connection level established when youstart the API session.
-Iescape_character Defines an escape character for certain symbolssuch as a forward slash (/).-zZ Specifies Windows NT Unified Logon.7.IDQL UtilityIDQL is also a useful as a tool for testing and other tasks that support anapplication or installation because it allows you to run scripts and batch files.Running the utility from the server command prompt:idql32 [-n] [-wcolumnwidth][-Uusername|-ENV_CONNECT_USER_NAME][-Pos_password|-ENV_CONNECT_PASSWORD][-Ddomain]docbase|-ENV_CONNECT_DOCBASE_NAME [-Rinput_file][-X][-E][-Ltrace_level][-zZ][-Winteger][-Ksecure_mode]The parameter being the same as mentioned in above utility.
Some of the tasks are mentioned below:1. Modifying the configurations of servers, docbroker.2. Creating new Docbases.3. Maintaining Docbases.4. Configuring, starting and shutting down servers.5. Changing session configuration.6. Managing content storage areas and content files.7. Managing users and groups.8. Managing security.
Utilities for Easy Handling of Administrative Task:
1.dm_error utilityWe encounter various content server errors with just with an error codewithout much information about it. Documentum has defined all the errorswith an expanded statement of the error, possible causes of it andprescribes possible solutions for the error. Utility should be executed in thecommand prompt of the content server.Syntax: dm_error
2.PreLoad UtilityAdministrator operations include activities called Dumping and Loading Docbase.Dump and Load operations can be used to do the following activities:a. Move a Docbase to one location to another.b. Duplicate a Docbase.c. Duplicate or move some portion of the Docbase.A dump operation creates a binary file of objects dumped from a Docbase. If a dumped object has associated content files, the content files are eitherreferenced by full path or included directly in the dump file. The load operation loads the objects and content files into another Docbase.PreLoad utility can be run on a dump file created to tell what all objects thatshould be created in the new Docbase before loading the dump file. Utility can also be used to create a DQL script that you can edit and then run to create the needed objects.Syntax:preload docbase [-Uusername] -Ppassword -dump_file filename [-script_file name]The docbase is the name of the Docbase into which you are loading the dumpfile. Filename is the name of the dump file, and name defines a name for theoutput DQL script. If you do not include a username, the current user isassumed.Note: This utility does not report all storage areas in the source Docbase, butonly those that have been copied into the dump file.
3.dmclean UtilityEvery Docbase requires a scheduled clean up need to be performed byadministrator. One such clean up includes removing orphaned content files.When users delete a document, or any object that has a content file associated with it, the system deletes the object and marks the content as an orphan. The system does not delete the actual content file. This must be done using the dmclean utility. Dmclean can be run using:
a. Documentum Administrator.b. A DQL EXECUTE statement.Syntax:EXECUTE do_methodWITH method = ’dmclean’,arguments = ’-no_content -no_note -no_wf_template’c. An Apply methodSyntax:apply,session,NULL,DO_METHOD,METHOD,S,dmclean, ARGUMENTS,S,’-no_content -no_note -no_wf_template’d. From Content Server command promptdmclean -docbase_name docbase -init_file init_file_name-no_content -no_note -no_wf_templateWhere wheredocbase is the name of the Docbase and init_file_nameis the name of the server.ini start up file for the Docbase’s server.
4.dmfilescan UtilityThis utility is used to scan the one or more storage area and find any contentfiles that do not have associated content objects. The utility scans for orphaned files which are over 24 hours old.Running the utility using EXECUTE statement:EXECUTE do_method WITH method = ’dmfilescan’,[arguments = ’[-s storage_area_name] [,-from directory1][,-to directory2]’]The utility automatically saves the output to a document that is stored inthe Temp cabinet. FALSE.) The output is a generated script that includesthe informational messages generated by the utility.Running the utility using Content Server command prompt:dmfilescan -docbase_name name -init_file init_file_name[-s storage_area_name][-from directory1][-to directory2]The init_file_name is the name of Content Server’s server.ini file. This isone of the server start up files.
5.dm_crypto_change_passphrase UtilityEvery installation of a Content Server creates a key called AdministrationEncryption Key (AEK). This is used to encrypt:a. The Docbase keys.b. Documentum passwords, such as those used by Content Server toconnect to the RDMS or any other Docbase.This AEK is stored at: %DOCUMENTUM%\dba\secure\aek.key and this key also are encrypted using a default passphrase provided by Documentum. It is always advisable to change the default passphrase. To change the default passphrase we can use dm_crypto_change_passphrase Utility.Syntax:dm_crypto_change_passphrase [-location location][-passphrase[old_passphrase]][-newpassphrase [new_passphrase]][-noprompt][-help]Location is the place where AEK is placed for which we need to change thepassphrase.old_passphrase is the old passphrase name.new_passphrase is the new passphrase name.-noprompt should be used if any one the argument mentioned above is notused. It’s like the end specify mentioning the end of arguments.-help returns help information for the utility.
6.IAPI UtilityIAPI Utility is used to issue direct method call to the server.Running the utility from the server command prompt:iapi32 [-Uusername|-ENV_CONNECT_USER_NAME][-Pos_password|-ENV_CONNECT_PASSWORD] [-Llogfile] [-X][-E][-V-][-Q] docbase|-ENV_CONNECT_DOCBASE_NAME [-Rinputfile][-Ftrace_level][-Sinit_level][-Iescape_character][-zZ][-Winteger][-Ksecure_mode]Order of the parameter does not hold importance.Username- Identifies the name who is starting the session.ENV_CONNECT_USER_NAME- User name in looked in the environmentvariable DM_USER_NAME.Password- User’s operating system password.ENV_CONNECT_PASSWORD- Password is looked in the environmentvariable DM_PASSWORD.-Llogfile – Directs the server to start a log file for the session.You must include the file name with the argument. You can specify afull path.-X Allows prompt for domain.-E Turns on echo.-V- Turns verbose mode off. The utility runs in verbosemode by default. If you turn verbose mode off, thesystem does not display the IAPI prompt, errormessages, or any responses to your commands(return values or status messages).-Q Directs the utility to provide a quick connection test. The utility attempts to connect and exits with a status of zero if successful or non-zero if not.It provides error messages if the attempt is not successful.Docbase- Docbase name which is intended to access.ENV_CONNECT_DOCBASE_NAM – finds the name of the docbasefrom environment variable DM_USER_NAME.-Rinputfile input file with API methods.-Ftrace_level Turns tracing on.-Sinit_level Defines the connection level established when youstart the API session.
-Iescape_character Defines an escape character for certain symbolssuch as a forward slash (/).-zZ Specifies Windows NT Unified Logon.7.IDQL UtilityIDQL is also a useful as a tool for testing and other tasks that support anapplication or installation because it allows you to run scripts and batch files.Running the utility from the server command prompt:idql32 [-n] [-wcolumnwidth][-Uusername|-ENV_CONNECT_USER_NAME][-Pos_password|-ENV_CONNECT_PASSWORD][-Ddomain]docbase|-ENV_CONNECT_DOCBASE_NAME [-Rinput_file][-X][-E][-Ltrace_level][-zZ][-Winteger][-Ksecure_mode]The parameter being the same as mentioned in above utility.
Comments (0)
Post a Comment