Running the Upload Assembly tool
Run the TCMUploadAssembly command-line executable to upload a .NET assembly to the Content Manager. You can specify parameters to override configuration settings.
About this task
Note: Certain changes to your assembly may cause the upload to fail if one or more of the uploaded items are in use. For example, if you remove a class that implements
ITemplate, your upload fails if there is a Compound Template that calls that class from one of its Template Building Blocks.
Procedure
- Open a command line prompt.
- Run the command-line tool as follows:
TCMUploadAssembly.exe CONFIG.XML MY_ASSEMBLY.DLL PARAMETERSwhere:CONFIG.XMLis the name of your configuration fileMY_ASSEMBLY.DLL(which may also contain a path) is the name of your .NET assemblyPARAMETERSare parameters from the configuration file that you want to override, which include the following:/folder:<tcmuri>-
Save the Template Building Block containing the .NET assembly to a Folder with the Content Manager URI (unique identifier) called
<tcmuri>. /bundle:<tcmuri>-
(optional) Add the Template Building Block containing the .NET assembly to a Bundle with the Content Manager URI called
<tcmuri>. /targeturl:<webserviceurl>-
provide a different URL (
<webserviceurl>) for the web service. /username:<nameofuser>- Provide a different user name to connect to the web service.
/password:<password>- Provide a different password when connecting to the web service.
/clientid:<clientId>- The client ID defined in Tridion Access Management the service account "Tridion Sites Content Manager API."
-
/secret:<secret> -
The client secret defined in Tridion Access Management for the service account "Tridion Sites Content Manager API."
Note: The default and maximum expiration is one year. After generating a new secret, be sure to update this configuration accordingly.
/verbose- Show extra debug information.
/uploadpdb:<true|false>- Upload or not upload a file with debug information (a .pdb file) along with the assembly.
/timeout:<seconds>- Explicitly set the amount of time, in seconds, that Tridion Sites allows for the uploading of the assembly. If omitted, this setting defaults to 100 seconds.
- If requested, provide the necessary user credentials to connect to Content Manager.
The authentication process can vary depend on how authentication is configured. You may be redirected to a browser window to sign in through an external identity provider. After a successful authentication, the browser will display a confirmation, at which point you can close the browser and return to the wizard.