The software described in this documentation is either no longer supported or is in extended support.
Oracle recommends that you upgrade to a current supported release.

Chapter 4 Configuring Oracle Cloud Native Environment Services

This chapter contains information about any configuration options for Oracle Cloud Native Environment, including configuring the Platform API Server and Platform Agent services.

4.1 Configuring the Platform API Server

The Platform API Server runs as a Systemd service, named olcne-api-server. You can get logs for this service using:

sudo journalctl -u olcne-api-server

By default, the service runs on TCP port 8091. You can change this and other Platform API Server settings by editing the Systemd service unit file so that the binary is invoked to use additional options.

olcne-api-server options:
  • [-p|--port] port_number

    Specifies the port that the Platform API Server binds to. Defaults to 8091 if unspecified.

  • [-i|--installables] installables_path

    Specifies the path to the directory of installable modules. Defaults to /etc/olcne/modules.

  • [-x|--insecure]

    Allows the gRPC server to accept clients that do not securely establish their identity.

To reconfigure the Platform API Server to use any of these options, you can edit the Systemd unit file at /usr/lib/systemd/system/olcne-api-server.service and append the option to the ExecStart line. For example:

[Unit]
Description=Platform API Server for Oracle Cloud Native Environments
Wants=network.target
After=network.target

[Service]
ExecStart=/usr/libexec/olcne-api-server -i /etc/olcne/modules --port 9083
WorkingDirectory=/var/olcne
User=olcne
Group=olcne
Restart=on-failure

[Install]
WantedBy=multi-user.target

If you edit the Systemd unit file, you must run the following commands for the changes to take effect:

sudo systemctl daemon-reload
sudo systemctl restart olcne-api-server.service
Note

If you change the port value for this service, you should take this into account for all other instructions provided in the documentation.

4.2 Configuring the Platform Agent

The Platform Agent runs as a Systemd service, named olcne-agent. You can get logs for this service using:

sudo journalctl -u olcne-agent

By default, the service runs on TCP port 8090. You can change this and other Platform Agent settings by editing the Systemd service unit file so that the binary is invoked to use additional options.

Additional options available to olcne-agent include:

olcne-agent options:
  • [-p|--port] port-number

    Specifies the port that the Platform Agent service binds to. Defaults to 8090 if unspecified.

  • [-x|--insecure]

    Allows the gRPC server to accept clients that do not securely establish their identity.

To reconfigure the Platform Agent to use any of these options, you can edit the Systemd unit file at /usr/lib/systemd/system/olcne-agent.service and append the option to the ExecStart line.

If you edit the Systemd unit file, you must run the following commands for the changes to take effect:

sudo systemctl daemon-reload
sudo systemctl restart olcne-agent.service
Note

If you change the port value for this service, you should take this into account for all other instructions provided in the documentation.