11.2 Setting Up Your Custom Theme

To create a custom theme for the PTM Web Interface:

  1. Enable the SSH service on the appliance:

    1. Log in to the Appliance Management Console as the vaadmin user.

    2. Click System Services.

    3. Select the SSH service.

    4. Select Action > Start.

    5. Click Close to exit System Services.

  2. Start an SSH session and log in as the vaadmin user to the user appliance.

  3. Set up your custom theme files:

    1. Navigate to the /vastorage/ptm/themes/ directory.

    2. Create a subdirectory under themes for your custom theme, such as MyCompanyTheme.

    3. Copy the contents of the /vastorage/ptm/themes/TransformationManager directory to your new theme directory (/vastorage/ptm/themes/MyCompanyTheme).

    4. In your custom theme directory, update the custom CSS file for color variables;

      /vastorage/ptm/themes/<your_theme_directory>/en/web/theme_variables.tmcss

    5. In your custom theme directory, change the image files as appropriate to define your custom theme for the PTM Web Interface.

  4. Modify the transformationmanager-themes.cfg file with your custom settings:

    1. Open the /etc/opt/microfocus/ps_transform_mgr/config/transformationmanager-themes.cfg file in a text editor.

    2. Modify the server.theme directive to replace the TransformationManager theme with your custom theme MyCompanyTheme.

      For example, change this line:

      server.theme=TransformationManager

      to this:

      server.theme=MyCompanyTheme
    3. (Optional) Modify the lines that specify the product name.

      server.productname=<span>PlateSpin</span> Transformation Manager
      server.shortproductname=Transformation Manager
    4. Save your changes.

  5. Restart the PlateSpin Transformation Manager service to allow the theme changes to take effect.

    Do one of the following:

    • In your SSH session, enter the following at a terminal console:

      rcps_transform_mgr restart
    • Log in to the Appliance Management Console, click System Services, select PlateSpin Transformation Manager (ps_transform_mgr), then select Action > Restart.

  6. Log in to the PTM Web Interface to verify your UI changes.

    To make additional changes, return to the appliance to update your custom theme files as appropriate, then restart the service to apply the changes.

  7. After your theme changes are complete, end your SSH session.

  8. Disable the SSH service:

    1. Log in to the Appliance Management Console as the vaadmin user, then click System Services.

    2. Select the SSH service.

    3. Select Action > Stop.

    4. Click Close to exit System Services.

    5. Log out of the Appliance Management Console, then close your web browser.