Install agent on UNIX and Linux computers from the command line

Your environment may require that you manually install the agent. Use the following procedures to manually install agents to UNIX and Linux computers for monitoring in System Center Operations Manager version 2025. The agent packages can be found in the following folder on a management server - %ProgramFiles%\Microsoft System Center\Operations Manager\Server\AgentManagement\UnixAgents\DownloadedKits. Import the required management packs for the specific version of UNIX/Linux you need to monitor. The management packs are available in the Operations Manager installation media, in the \ManagementPacks folder or you can download the latest version from the Download Center.

Install Operations Manager 2025 agent on UNIX and Linux computers

The following procedures show how to manually install agents to UNIX and Linux computers for monitoring in System Center Operations Manager version 2025.

Install the agent on Red Hat Enterprise Linux and SUSE Linux Enterprise Server

1. Transfer the Red Hat Enterprise agent to the Linux server:

   scx-<version>.rhel.<version>.<arch>.sh

   or for SUSE Linux Enterprise Server:

   scx-<version>.sles.<version>.<arch>.sh

2. To install the Red Hat Enterprise package, enter:

   sh ./scx-<version>.rhel.<version>.<arch>.sh --install --enable-opsmgr

   or for SUSE Linux Enterprise package, enter:

   sh ./scx-<version>.sles.<version>.<arch>.sh --install --enable-opsmgr

3. To verify that the package is installed, enter:

   rpm -q scx

4. To verify that the Microsoft SCX CIM Server is running, enter:

   scxadmin -status

Install the agent on RPM based Universal Linux Servers (Oracle and CentOS)

1. Transfer the agent (scx-<version>.universalr.<version>.<arch>.sh) to the Linux server. This should be done via SCP or FTP in binary mode.

2. To install the package, enter:

   sh ./scx-<version>.universalr.<version>.<arch>.sh --install --enable-opsmgr

3. To verify that the package is installed, enter:

   rpm -q scx

4. To verify that the Microsoft SCX CIM Server is running, enter:

   scxadmin -status

Install the agent on DPKG-based Universal Linux Servers (Debian and Ubuntu)

1. Transfer the agent (scx-<version>.universald.<version>.<arch>.sh) to the Linux server. This should be done via SCP or FTP in binary mode.

2. To install the package, enter:

   sh ./scx-<version>.universald.<version>.<arch>.sh --install --enable-opsmgr

3. To verify that the package is installed, enter:

   dpkg -l scx

4. To verify that the Microsoft SCX CIM Server is running, enter:

   scxadmin -status

Sign agent certificates

When you manually deploy an agent, you perform the first two steps that are typically handled by the Discovery Wizard, deployment and certificate signing. The certificate gets encrypted with SHA256. Then, you use the Discovery Wizard to add the computer to the management group.

If there are existing certificates on the system, they're reused during agent installation. New certificates aren't created. Certificates aren't automatically deleted when you uninstall an agent. You must manually delete the certificates that are listed in the folder /etc/opt/microsoft/scx/ssl for UNIX and /etc/opt/microsoft/scx/scom/certs folder for Linux. To regenerate the certificates at install, you must remove this folder before agent installation.

You must have already manually installed an agent before you start this procedure. You'll need a root or elevated account to perform the procedure.

Install certificates for UNIX and Linux support

1. On the computer that is running the UNIX or Linux operating system, locate the file /etc/opt/microsoft/scx/ssl/scx-host-<hostname>.pem and securely copy or transfer it to any location on the computer that is hosting Operations Manager.

2. On the computer that is hosting Operations Manager, on the Windows desktop, select Start, and select Run.

3. In the Run dialog, enter cmd, and then press Enter.

4. Change directories to the location where you copied the pem file.

5. Enter the command scxcertconfig -sign scx-host-<hostname>.pem scx_new.pem, and then press Enter. This command will self-sign your certificate (scx-host-<hostname>.pem) and then save the new certificate (scx-host-<hostname>_new.pem).

   Note

   Ensure that the location where Operations Manager is installed is in your path statement, or use the fully qualified path of the scxcertconfig.exe file.

6. Securely copy or transfer the scx_new.pem file into the /etc/opt/microsoft/scx/ssl folder on the computer that is hosting the UNIX or Linux operating system. This replaces the original scx-host-<hostname>.pem file.

7. Restart the agent by entering scxadmin -restart.

Discover computers after manual deployment

After you've manually deployed agents to UNIX and Linux computers, they still need to be discovered by Operations Manager by using the Discovery Wizard. For the Discovery type, select Discover only computers with the UNIX/Linux agent installed. For more information, see Install Agent on UNIX and Linux Using the Discovery Wizard.

Next steps

• To learn how to configure object discovery rules and disable discovery of a specific object, see Applying Overrides to Object Discoveries.

• To understand how to perform agent maintenance on UNIX and Linux computers, see Upgrading and Uninstalling Agents on UNIX and Linux Computers.

• To understand what options and steps need to be performed to properly uninstall the agent from your UNIX and Linux computers, review Manually Uninstalling Agents from UNIX and Linux Computers.