In a previous blog, I quickly went through the different things to know about the silent installations as well as how to install the CS binaries. Once the CS binaries are installed, you can install/configure a few more components. On this second blog, I will continue with:
- Documentum docbroker/connection broker installation
- Configuration of a Documentum licence
1. Documentum docbroker/connection broker installation
As mentioned in the previous blog, the examples provided by Documentum contain almost all possible parameters but for this section, only a very few of them are required. The properties file for a docbroker/connection broker installation is as follow:
[dmadmin@content_server_01 ~]$ vi /tmp/dctm_install/CS_Docbroker.properties [dmadmin@content_server_01 ~]$ cat /tmp/dctm_install/CS_Docbroker.properties ### Silent installation response file for a Docbroker INSTALLER_UI=silent KEEP_TEMP_FILE=true ### Action to be executed SERVER.CONFIGURATOR.LICENSING=false SERVER.CONFIGURATOR.REPOSITORY=false SERVER.CONFIGURATOR.BROKER=true ### Docbroker parameters SERVER.DOCBROKER_ACTION=CREATE SERVER.DOCBROKER_PORT=1489 SERVER.DOCBROKER_NAME=Docbroker SERVER.PROJECTED_DOCBROKER_HOST=content_server_01.dbi-services.com SERVER.PROJECTED_DOCBROKER_PORT=1489 SERVER.DOCBROKER_CONNECT_MODE=dual ### Common parameters START_METHOD_SERVER=false MORE_DOCBASE=false SERVER.CONGINUE.MORECOMPONENT=false [dmadmin@content_server_01 ~]$
A short description of these properties:
- INSTALLER_UI: The mode to use for the installation, here it is obviously silent
- KEEP_TEMP_FILE: Whether or not you want to keep the temporary files created by the installer. These files are generated under the /tmp folder. I usually keep them because I want to be able to check them if something went wrong
- SERVER.CONFIGURATOR.LICENSING: Whether or not you want to configure a licence using this properties file. Here since we just want a docbroker/connection broker, it is obviously false
- SERVER.CONFIGURATOR.REPOSITORY: Whether or not you want to configure a docbase/repository. Same here, it will be false
- SERVER.CONFIGURATOR.BROKER: Whether or not you want to configure a docbroker/connection broker. That’s the purpose of this properties file so it will be true
- SERVER.DOCBROKER_ACTION: The action to be executed, it can be either CREATE, UPGRADE or DELETE. You can upgrade a Documentum environment in silent even if the source doesn’t support the silent installation/upgrade as long as the target version (CS 7.3, CS 16.4, …) does
- SERVER.DOCBROKER_PORT: The port the docbroker/connection broker will listen to (always the native port)
- SERVER.DOCBROKER_NAME: The name of the docbroker/connection broker to create/upgrade/delete
- SERVER.PROJECTED_DOCBROKER_HOST: The hostname to use for the dfc.properties projection for this docbroker/connection broker
- SERVER.PROJECTED_DOCBROKER_PORT: The port to use for the dfc.properties projection related to this docbroker/connection broker. It should obviously be the same as “SERVER.DOCBROKER_PORT”, don’t ask me why there are two different parameters for that…
- SERVER.DOCBROKER_CONNECT_MODE: The connection mode to use for the docbroker/connection broker, it can be either native, dual or secure. If it is dual or secure, you have 2 choices:
- Use the default “Anonymous” mode, which is actually not really secure
- Use a real “SSL Certificate” mode, which requires some more parameters to be configured (and you need to have the keystore and truststore already available):
- SERVER.USE_CERTIFICATES: Whether or not to use SSL Certificate for the docbroker/connection broker
- SERVER.DOCBROKER_KEYSTORE_FILE_NAME: The name of the p12 file that contains the keystore
- SERVER.DOCBROKER_KEYSTORE_PASSWORD_FILE_NAME: The name of the password file that contains the password of the keystore
- SERVER.DOCBROKER_CIPHER_LIST: Colon separated list of ciphers to be enabled (E.g.: EDH-RSA-AES256-GCM-SHA384:EDH-RSA-AES256-SHA)
- SERVER.DFC_SSL_TRUSTSTORE: Full path and name of the truststore to be used that contains the SSL Certificate needed to trust the targets
- SERVER.DFC_SSL_TRUSTSTORE_PASSWORD: The password of the truststore in clear text
- SERVER.DFC_SSL_USE_EXISTING_TRUSTSTORE: Whether or not to use the Java truststore or the 2 above parameters instead
- START_METHOD_SERVER: Whether or not you want the JMS to be re-started again once the docbroker/connection broker has been created. Since we usually create the docbroker/connection broker just before creating the docbases/repositories and since the docbases/repositories will anyway stop the JMS, we can leave it stopped there
- MORE_DOCBASE: Never change this value, it should remain as false as far as I know
- SERVER.CONGINUE.MORECOMPONENT: Whether or not you want to configure some additional components. Same as above, I would always let it as false… I know that the name of this parameter is strange but that’s the name that is coming from the templates… But if you look a little bit on the internet, you might be able to find “SERVER.CONTINUE.MORE.COMPONENT” as well… So which one is “correct”, which one isn’t is still a mystery for me. I’m using the first one but since I always set it to false, that doesn’t have any impact for me and I never saw any errors coming from the log files or anything.
Once the properties file is ready, you can install the docbroker/connection broker using the following command:
[dmadmin@content_server_01 ~]$ $DM_HOME/install/dm_launch_server_config_program.sh -f /tmp/dctm_install/CS_Docbroker.properties
That’s it, after a few seconds, the prompt will be returned and the docbroker/connection broker will be installed with the provided parameters.
2. Configuration of a Documentum licence
Once you have a docbroker/connection broker installed, you can configure/enable a certain amount of licences (actually you could have done it before). For this example, I will only enable the TCS but you can do it for all others too. The properties file for a licence configuration is as follow:
[dmadmin@content_server_01 ~]$ vi /tmp/dctm_install/CS_Licence.properties [dmadmin@content_server_01 ~]$ cat /tmp/dctm_install/CS_Licence.properties ### Silent installation response file for a Licence INSTALLER_UI=silent KEEP_TEMP_FILE=true ### Action to be executed SERVER.CONFIGURATOR.LICENSING=true SERVER.CONFIGURATOR.REPOSITORY=false SERVER.CONFIGURATOR.BROKER=false ### Licensing parameters SERVER.TCS_LICENSE=DummyLicenceForTCS ### Common parameters START_METHOD_SERVER=false MORE_DOCBASE=false SERVER.CONGINUE.MORECOMPONENT=false [dmadmin@content_server_01 ~]$
A short description of these properties – compared to the above ones:
- SERVER.CONFIGURATOR.LICENSING & SERVER.CONFIGURATOR.BROKER: This time, we will obviously set the broker to false and the licensing to true so we do not re-install another docbroker/connection broker
- Licences:
- SERVER.TCS_LICENSE: Licence string to enable the Trusted Content Services on this CS
- SERVER.XHIVE_LICENSE: Licence string to enable the XML Store Feature
- SERVER.AS_LICENSE: Licence string to enable the Archive Service
- SERVER.CSSL_LICENSE: Licence string to enable the Content Storage Service Licence
- aso… Some of these licences require more parameters to be added (XHIVE: “XHIVE.PAGE.SIZE”, “SERVER.ENABLE_XHIVE”, “SERVER.XHIVE_HOST”, aso…)
Once the properties file is ready, you can configure the licence(s) using the following command (same as previously, only the file changed):
[dmadmin@content_server_01 ~]$ $DM_HOME/install/dm_launch_server_config_program.sh -f /tmp/dctm_install/CS_Licence.properties
It might make sense to enable some licences during the installation of a specific docbase/repository so then that would be up to you to think about this. In the above example, I only enabled the TCS so it is available to all docbases/repositories that will be installed on this Content Server. Therefore, it makes sense to do separately, before the installation of the docbases/repositories.
You now know how to install and configure a docbroker/connection broker as well as how to enable licences using the silent installation provided by Documentum