WDT model files

WDT metadata models are descriptions of a WebLogic Server domain configuration, generally written in YAML but occasionally JSON. These models are not connected to a live domain and you edit them ‘offline’ before using the WebLogic Deploy Tooling (WDT) to build or modify live domains from the models.

See the WebLogic Deploy Tooling documentation for more information.

We recommend that you use the desktop application over the browser application when working with WDT model files.

Additionally, the WebLogic Remote Console assumes WDT model files are in YAML format. If you upload a file with no file extension, the WebLogic Remote Console will convert it to YAML format after you save your changes.

Create a new WDT model file

  1. Expand the Kiosk and beside the project name, click ⋮. Select Create Provider for New WDT Model File.
  2. Enter a name for the WDT model file provider. This is the name that will appear in the Project list of providers so you can identify which provider you’re working on.
  3. Enter a name for the WDT model file in the WDT Model Filename field. Include .yaml or .json at the end of the file name.
  4. Click Upload file and browse to the directory where you want to save the new WDT model file.
  5. Optional: Enable Use Sparse Template to create a WDT model file which does not contain any references to an Administration Server.
  6. Optional: Choose a property list provider from the WDT Variables dropdown list. If you add WDT variables to your WDT model file, you can update the variables in your WDT model file from a single location - the property list provider. If you don’t have a property list provider yet, you can edit the WDT model file settings later to add or change the associated WDT variables. See WDT Model Tokens for more information.
  7. Click OK to create the file.

Upload an existing WDT model file

If you’ve already created a WDT model file, you can upload it to WebLogic Remote Console where you can continue to edit it.

  1. Expand the Kiosk and beside the project name, click ⋮. Select Add WDT Model File Provider.
  2. Enter a name for the model in the Model Name field. This is the name that will appear in the Project list of providers so you can identify which provider you’re working on.
  3. Click Upload file and browse to the WDT model file (a YAML or JSON file).
  4. Optional: Choose a property list provider from the WDT Variables dropdown list. If you add WDT variables to your WDT model file, you can update the variables in your WDT model file from a single location - the property list provider. If you don’t have a property list provider yet, you can edit the WDT model file settings later to add or change the associated WDT variables. See WDT Model Tokens for more information.
  5. Click OK to upload the file.

Edit a WDT model file

  1. Expand the Kiosk and select the WDT model file you want to edit.

  2. Click WDT Model Tree and make your changes to the domain configuration. Make sure to click WDT Model Edit if you want to enter a model token.

    Option Description
    Default (unset) Restore field to its default value.
    Select Value Select a reference to a component that exists in the current WDT model file.
    Enter Value Enter a fixed value.
    Enter Model Token Enter a WDT model token.
    Enter Unresolved Reference Enter a reference to a component that does not exist in the current WDT model file but will exist at a later point.
    Select Model Token Variable Select a model token variable from the list of available options. The WDT model file must be connected with a property list to see this option.
    Create Model Token Variable Enter a Variable Name and Variable Value to create a new model token variable. New model token variables are added to the connected property list. The WDT model file must be connected with a property list to see this option.

    The WebLogic Remote Console auto-saves any changes you make to the WDT model file. You don’t need to commit changes to WDT model files.

  3. After you finish making changes, you can click Save Now (in the desktop application) or Download File (in the browser) to ensure all changes are saved and downloaded to your computer.

The browser application behaves differently than the desktop application. While changes to the WDT model file are still saved automatically as you move around the console, they are not saved to your computer. This means that once you’re satisfied with your changes, you must click Download File to download the updated WDT model file to your computer.

Do not refresh the browser page or you will lose all your changes.

If you want to restore fields to their default value, right-click on a field and click Restore to default.

WDT model tokens

WDT model tokens are variables that you can use to replace fixed values in WDT model files. With WDT model tokens, WDT model files become more versatile - you can create a single WDT model file with model tokens and when you build a domain from it, you only need to update the model token values, rather than create multiple, static WDT model files.

There are several types of model tokens including variable tokens, file tokens, and so on. Model tokens follow this format: @@TYPE:KEY@@, where TYPE is the model token type and KEY is the variable value. For example, you can declare a variable token by entering @@PROP:ABCDE@@ into a field.

See WDT Model Tokens in the WebLogic Deploy Tooling documentation for more information.

WDT variables

WDT variables make it even easier to manage WDT model tokens in the WebLogic Remote Console. When you add WDT variables to your WDT model file, you create a link between the WDT model file and a property list. You can then pull in properties from the property list and use them as WDT model tokens. Then, when you want to update a property value, just open the associated property list and make your changes there.

You can use both standalone WDT model tokens and WDT variables in a WDT model file, but only one property list provider per WDT model file. Multiple WDT model files can use the same property list.

Delete a WDT model file

This will only remove the WDT model file from the WebLogic Remote Console. It will remain in the location designated on your computer. However, if you are using the browser application (and want to keep this WDT model file), make sure to download the file before deleting it in WebLogic Remote Console.

This will not delete any associated property list providers.

  1. Expand the Kiosk and beside the WDT model file, click the Settings icon icon.

Build a WebLogic Server domain

When you’re satisfied with the properties of your WDT model file, you can transform it into a live WebLogic Server domain with WebLogic Deploy Tooling (WDT).

  1. Save the WDT model file in WebLogic Remote Console. Make a note of the location of the YAML or JSON file on your computer.
  2. If you haven’t already, download WDT from its GitHub repository.
  3. Follow the instructions in the WDT Documentation for building a domain from a model.

If WDT reports an error when opening the WDT model file from WebLogic Remote Console, upgrade your WDT to the latest available version and try again.