Bootstrapping on a Remote Machine with a Substitute User

You can include a substitute user for bootstrapping operations on a remote machine. When including a substitute user, you have two users that perform different remote operations on the target machine:

• A user that connects over SSH to the remote machine and copies the bootstrapper on the machine.
• A substitute user that installs and starts Platform Manager.

In this case, add the credentials for both users in the nodes/default/default/bootstrapInfo section of the infrastructure micro template or composite template that you use to bootstrap Platform Manager on a remote machine.

Before you add a substitute user in the template, consider the following requirements:

• The remote machine must have a POSIX-compliant operating system. This function is not supported on Windows operating systems.
• The substitute user must have read permissions for the home directory of the SSH user.
• The SSH user must have read permissions for the home directory of the substitute user. You can use the template with the substitute user to bootstrap new Platform Manager installations or migrate existing ones.

To define a substitute user, add the substituteUserCredentials: section in the nodes/default/default/bootstrapInfo section of the template. You can add the substitute user credentials as userName: and password: parameters or map the substitute user to a credentials alias, for example substituteUserCredentials: ${subst.credentials.alias}. The following example shows a sample template snippet with a substituteUserCredentials: section that references a credentials alias parameter:

environments:
  default:
    install.dir: /opt/webmethods
    bootstrapper: cc-def-10.5-milestone-lnxamd64.sh
    subst.credentials.alias: ${substitute-user}
    os.credentials.alias: ${ssh-user}
...
nodes:
  default:
    default:
      port: 8093   # Default Platform Manager HTTPS port.
      secure: true # Indicates that the connection will be over SSL.
      bootstrapInfo:
        installDir: ${install.dir}  # The installation directory.
        installer: ${bootstrapper}  # Name of the Command Central bootstrapper to use.
        substituteUserCredentials: ${subst.credentials.alias} # Substitute user credentials. 
        credentials: ${os.credentials.alias} # SSH connection credentials.
...