Install > Install HPE ITOC > Install agents on resources manually

Install agents on resources manually

This topic describes how to install Salt agents on your resources manually. To install agents on resources using the HPE ITOC UI, see Install an agent on a resource.

It is recommended to Apply HPE ITOC licenses before installing the agents.

HPE ITOC provides Salt agent installer packages for the following target resources:

Platform Agent Installer Package

Microsoft Windows 7,
Microsoft Windows 8,
Microsoft Windows 8.1,
Microsoft Windows Server 2008 R2,
Microsoft Windows Server 2012 R2, Microsoft Windows Server 2012

 Win64_minion-2014.7.5.exe
RHEL 5 x64, CentOS 5 x64, OEL 5 x64 RHEL5_minion-2014.7.2.1
RHEL 6 x64, CentOS 6 x64, OEL 6 x64 RHEL6_minion-2014.7.1.1
RHEL 7 x64, CentOS 7 x64, OEL 7 x64 RHEL7_minion-2014.7.1.1
SLES 11 SP2 x64 SLES11_minion-2014.7.4.184.2
Ubuntu 12.04 LTS x64 Ubuntu12045LTS_minion-2014.7.1
Ubuntu 14.04 LTS x64 Ubuntu14041LTS_minion-2014.7.5

Install agents on Linux systems

Use this procedure to install agents on Linux systems.

Copy the agent installation package on the HPE ITOC server

  1. Copy the agent install package for the target platform to the target server:

    $scp <itoc_install_directory>/salt/srv/salt/<install_package>
    user@minion_server:/tmp

    For example (using Red Hat Enterprise Linux 7):

    $scp /opt/hpe/itoc/salt/srv/salt/RHEL7_minion-2014.7.1.1 user@minion_server:/tmp

Run the agent installation package on the target server

  1. Run the agent install package using the HPE ITOC server FQDN:

    /tmp/<install_package> -- -f <ITOC_server_FQDN>

    For example:

    /tmp/RHEL7_minion-2014.7.1.1 -- -f itocserver.itoc.mysite.com

    The syntax -- -f is correct as shown above.

    To view available options for the installer, use the -- -h option:

    /tmp/RHEL7_minion-7.0.3 -- -h

    Verifying archive integrity... All good.

    .

    USAGE: install_minion.sh [-d | --dir] <itoc_install_directory> [-f | --fqdn] <salt_master_fqdn> [-h | --help]

    • -f | --fqdn : Salt Master host FQDN. Corresponding entry should be created in /etc/hosts by user to resolve it locally.
    • -d | --dir (optional): Directory where the Salt agent will be installed. The default value is /opt/hpe/itoc.
    • -h | --help (optional): Installer usage help.

    Next step: Accept the agent key on the HPE ITOC server

Install agents on Windows systems

Prerequisites

  1. Install the Python 2.7 64-bit library in on the Windows agent target. In the following example, %SystemDrive% is D.
    1. Modify the itoc.rex.salt.minion.windows.pythonloc = C:/python27 property in the <install_dir>/wildfly-8.1.0.Final/standalone/deployments/itoc.war/WEB-INF/classes/application.properties file to itoc.rex.salt.minion.windows.pythonloc = D:/python27
    2. Restart your service:

      <itoc_install_directory>/scripts/itoc restart appserver

  1. Install the PyWin32 64-bit library pointing to Python, installed in step 1.
  1. Select an SSH installation for Windows. HPE ITOC has been tested with the following two SSH installation options for Windows; however, you can use any other similar solution.
    • COPSSH 64-bit -https://www.itefix.net/copssh
    • BITVISE SSH - https://www.bitvise.com/

      All the Windows servers on a system must have either COPSSH or BITVISE SSH installed. Do not use both. HPE ITOC does not support a mix of COPSSH and BITVISE SSH on servers.

      By default, the application.properties file is configured to support COPSSH as follows (default configurations are shown in bold text):

      ## itoc.rex.salt.minion.windows.temp : salt minion temp dir for windows
      ## This is an optional property with default value C:/tmp
      itoc.rex.salt.minion.windows.temp = C:/tmp

      ## itoc.rex.salt.minion.windows.pythonloc : salt minion python location for windows
      ## This is an optional property with default value C:/python27
      itoc.rex.salt.minion.windows.pythonloc = C:/python27

      ## itoc.rex.salt.minion.windows.sshsaltloc : location for salt installation while access from SSH
      ## This is an optional property with default value /cygdrive/c/salt
      itoc.rex.salt.minion.windows.sshsaltloc = /cygdrive/c/salt

      ## itoc.rex.salt.minion.windows.sshenvtype : what kind of command set windows ssh uses (POSIX or Windows)
      ## This is an optional property with default value POSIX
      itoc.rex.salt.minion.windows.sshenvtype = POSIX

      To use BITVISE instead of COPSSH, the application.properties file must have the following information (shown in bold text):

      ## itoc.rex.salt.minion.windows.temp : salt minion temp dir for windows
      ## This is an optional property with default value C:/tmp
      itoc.rex.salt.minion.windows.temp = C:/tmp

      ## itoc.rex.salt.minion.windows.pythonloc : salt minion python location for windows
      ## This is an optional property with default value C:/python27
      itoc.rex.salt.minion.windows.pythonloc = C:/python27

      ## itoc.rex.salt.minion.windows.sshsaltloc : location for salt installation while access from SSH
      ## This is an optional property with default value /cygdrive/c/salt
      itoc.rex.salt.minion.windows.sshsaltloc = C:/salt

      ## itoc.rex.salt.minion.windows.sshenvtype : what kind of command set windows ssh uses (POSIX or Windows)
      ## This is an optional property with default value POSIX
      itoc.rex.salt.minion.windows.sshenvtype = Windows

      For both COPSSH and BITVISE, the user must ensure that:

      • The Python 2.7 64-bit library is installed in the directory specified by itoc.rex.salt.minion.windows.pythonloc, as shown in step 1.
      • itoc.rex.salt.minion.windows.sshsaltloc must be:
        • %SystemDrive%:/salt for BITVISE use.
        • /cygdrive/%SystemDrive%/salt for COPSSH use.
      • itoc.rex.salt.minion.windows.temp and itoc.rex.salt.minion.windows.sshsaltloc are pre-created.
        • itoc.rex.salt.minion.windows.temp must have read and write permissions for the Administrator and System users.
        • itoc.rex.salt.minion.windows.sshsaltloc must have read permissions.
      • All directory names specified in the application.properties files must use / as a
        separator, not \.

      • Appropriate firewall settings should be updated to allow the SSH server to communicate.

    HPE recommends that the user create a template Windows server with this configuration and clone it for easy configuration.

Install the agent on a Windows target

Use this procedure to install agents on Windows systems.

  1. Copy the Windows agent install file to the target server.
  2. Run the Windows agent install self-extracting executable:

    c:/temp/Win64_minion-2014.7.5.exe

    It extracts the package in the same location.

  1. Enter the following command to install the agent using the command prompt:

    cd minionpkg

    minionpkg\install_minion.bat itocserver.itoc.mysite.com
    Install finished successfully!

Next step: Accept the agent key on the HPE ITOC server

Accept the agent key on the HPE ITOC server

  1. List the available keys:

    $<itoc_install_directory>/salt/usr/bin/minion_reg.sh -L

    For example:

    $/opt/hpe/itoc/salt/usr/bin/minion_reg.sh -L

    Accepted Keys:

    itocserver.itoc.mysite.com

    Unaccepted Keys:

    targetserver.itoc.mysite.com

    Rejected Keys:

  2. Accept the agent with your selected key:

    $<itoc_install_directory>/salt/usr/bin/minion_reg.sh -a <target_FQDN> -y

    You can accept all agent keys at once. Install the agents on multiple target servers as needed for your environment, then accept all agent keys:
    $<itoc_install_directory>/salt/usr/bin/minion_reg.sh -A -y

    To view available options for the minion_reg.sh script, use the -h option:

    minion_reg.sh -h

Send Help Center feedback