When installing the Okta Provisioning Agent on Linux, administrators may encounter the error messages below, particularly when attempting to start the service using the command:

`service OktaProvisioningAgent start`
 

Common Error Messages:

• "/etc/init.d/OktaProvisioningAgent: line 14: /etc/rc.d/init.d/functions: No such file or directory"
• "Starting OktaProvisioningAgent (via systemctl): Failed to start OktaProvisioningAgent service: Unit OktaProvisioningAgent.service not found. [FAILED]"

• On-Premise Provisioning
• Okta Provisioning Agent
• Linux

These errors typically occur because the Okta Provisioning Agent uses the older init method for starting and managing processes, which may not be supported by the Linux distribution.

Identified Distros:

• Rocky Linux 9.3 (Blue Onyx)
• Red Hat Enterprise Linux (RHEL) 9.4

To resolve these errors and successfully start the service, adopt the newer systemd approach instead of the older init method. Follow the steps below:
 

1. Create and save the service unit file: Save the following configuration in: /lib/systemd/system/OktaProvisioningAgent.service

   [Unit]
   Description=Okta Provisioning Agent
   
   [Service]
   Type=forking
   ExecStart=/opt/OktaProvisioningAgent/OktaProvisioningAgent
   
   [Install]
   WantedBy=multi-user.target 
   

2. Reload systemd configurations: Run the following command to recognize the new service:

   sudo systemctl daemon-reload

3. Enable the service to start on boot: Run the following command to enable the service:

   sudo systemctl enable OktaProvisioningAgent

4. Start the service immediately: Run the following command to start the service:

   sudo systemctl start OktaProvisioningAgent

5. Check the service status: Run the following command to confirm the service is running correctly:

   sudo systemctl status OktaProvisioningAgent

Following these steps can ensure the Okta Provisioning Agent is started and managed using the supported systemd method.