nginx

nginx

Switches the web server you are using to nginx. It will also restart the service.
For details on the differences between Web servers, please refer to the KUSANAGI Web Server Configurations.

Example

kusanagi nginx --use nginx129

kusanagi nginx

Options

(No options)

If you are using "httpd", it will switch to "nginx".
If "nginx" is already running, "nginx" will restart.

NGINX Version

[--use {installed | nginx129 | nginx128 | nginx127 | nginx126}]

Discontinued options
--use nginx125 (discontinued as of 9.6.8 and Security Edition)
--use nginx124 (discontinued as of 9.6.8 and Security Edition)
--use nginx123 (discontinued as of 9.4.5)
--use nginx122 (discontinued as of 9.4.5)
--use nginx121 (discontinued as of 9.2.10)
--use nginx120 (discontinued as of 9.2.10)
--use nginx119 (discontinued as of 9.0.12)
--use nginx118 (discontinued as of 9.0.12)

Default: installed

Specifies the version of NGINX to be used. When one of the following NGINX is specified, it will start up.
"--use", "--reload", "--test", "--update-conf", "--status" and "--showpath" cannot be specified at the same time.

• --use installed: NGINX currently installed
• --use nginx129 : NGINX 1.29
• --use nginx128 : NGINX 1.28
• --use nginx127 : NGINX 1.27
• --use nginx126 : NGINX 1.26
• --use nginx125 (discontinued as of 9.6.8 and Security Edition) : NGINX 1.25
• --use nginx124 (discontinued as of 9.6.8 and Security Edition): NGINX 1.24
• --use nginx123 (discontinued as of 9.4.5) : NGINX 1.23
• --use nginx122 (discontinued as of 9.4.5) : NGINX 1.22
• --use nginx121 (discontinued as of 9.2.10) : NGINX 1.21
• --use nginx120 (discontinued as of 9.2.10) : NGINX 1.20
• --use nginx119 (discontinued as of 9.0.12) : NGINX 1.19
• --use nginx118 (discontinued as of 9.0.12) : NGINX 1.18

Reloading Configuration

[--reload]

Reloads configuration without disconnecting the session.
"--use", "--reload", "--test", "--update-conf", "--status" and "--showpath" cannot be specified at the same time.

Checking Configuration File

[--test]

Checks the configuration files only.
"--use", "--reload", "--test", "--update-conf", "--status" and "--showpath" cannot be specified at the same time.

Update Configuration File

Discontinued options
[--update-conf (discontinued as of Security Edition)]

Updates the configuration file to match the NGINX 1.25.1 specifications.
"--use", "--reload", "--test", "--update-conf" and "--status" cannot be specified at the same time.

Displaying Status

[--status]

Displays status of NGINX.
"--use", "--reload", "--test", "--update-conf", "--status" and "--showpath" cannot be specified at the same time.

Displaying Full Path of nginx Command

[--showpath]

Displays the full path of nginx command.
"--use", "--reload", "--test", "--status" and "--showpath" cannot be specified at the same time.

Output

# kusanagi nginx
nginx: the configuration file /etc/opt/kusanagi/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/opt/kusanagi/nginx/nginx.conf test is successful
Removed /etc/systemd/system/multi-user.target.wants/httpd.service.
Created symlink /etc/systemd/system/multi-user.target.wants/nginx.service -> /usr/lib/systemd/system/nginx.service.
nginx completed.