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

Procedure

  1. Open a command line prompt.
  2. Run the command-line tool as follows:
    TCMUploadAssembly.exe CONFIG.XML MY_ASSEMBLY.DLL PARAMETERS
    where:
    • CONFIG.XML is the name of your configuration file
    • MY_ASSEMBLY.DLL (which may also contain a path) is the name of your .NET assembly
    • PARAMETERS are 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."
      /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.
  3. 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.