NodeWorx Questions

How do I add commands to the jailed shell?

The jailed shell deliberately has a limited amount of commands that can be run. If it is necessary for users to access a specified command, jk_cp can be used from the root shell to add the command that should be enabled.

  1. Log into the CLI as root via SSH

  2. Run the following, replacing {command} with the command that should be enabled:

jk_cp /chroot /usr/bin/{command}

Where are the Apache web server configuration files?

InterWorx uses the standard Apache configuration file, located in /etc/httpd/httpd.conf.

This file controls some server wide variables, however, this file may be overwritten during an update, so if it is edited, it is recommended to keep a backup copy for reference.

Each domain is controlled through a virtual host file located under /etc/httpd/conf.d.

Domain vhosts are named the same as the domain in question, with .conf at the end. Example:

/etc/httpd/conf.d/vhost_mydomain.com.conf

Can I change the ports that services run on?

Yes the HTTP, HTTPS, SSH, and secondary SMTP server ports can be changed via NodeWorx.

  • Modifications to the HTTP and HTTPS ports can be made under System Services >Web Server. Detailed information on managing Apache settings in NodeWorx can be found here

    Apache ports

  • Modifications to the SSH port can be made under System Services > SSH Server. Detailed information on managing SSH settings in NodeWorx can be found here

    SSH ports

  • Modifications to the secondary SMTP port can be made under System Services > Mail Sever > MTA Settings. Detailed information on managing SMTP settings can be found here

    Note

    Customizing the secondary SMTP port is only possible for servers that are not using the Dovecot MSA. Servers using the Dovecot MSA must use ports 587 and/or 465 for secondary SMTP services. Infromation on the Dovecot MSA can be found here.

    SMTP secondary port

Where are the DNS Zone Files?

InterWorx Control Panel uses djbdns which does not use zone configuration files stored at the command line. DNS data is stored on the InterWorx database.

However, DNS zone information and records can be found in NodeWorx under System Services > DNS Server > Zones.

Where are the InterWorx log files located?

The InterWorx log files are located in the InterWorx home directory at /home/interworx/var/log.

Below are the most common log files saved at this location:

  • iworx.log - The most common log file used for InterWorx. Most errors will be in this log file

  • cron.log - Related to cron tasks

  • access.log - Apache access log for the iworx-web server

  • error.log - Apache error log for the iworx-web server

  • api.log - Records api interactions

  • lastyum.log - Records the yum output from the daily OS update (if enabled)

Important logs can also be found in /var/log:

  • messages - Contains system level errors or hardware failures

  • apf_log - InterWorx firewall related logs

  • maillog - vpopmail mail log

  • send/current - qmail send log

  • smtp/current - qmail smtp log

  • dovecot/dovecot.log - dovecot service log (imap/pop3)

  • mysqld.log - MySQL log

  • yum.log - yum package management log

Why does mail stay in my email queue?

Sometimes messages can’t be delivered immediately (e.g., problems with the receiving mail server), so the delivering server will queue the message and retry later. Once the maximum queue lifetime runs out (default is a week), the email will be removed from the queue.

More information on managing the mail queue can be found here.

Can I Update MySQL or PHP?

InterWorx does not distribute or include system-level versions of MySQL/MariaDB or PHP. Instead, it maintains its own internal PHP, and MySQL/MariaDB versions, which allows users the ability to install whichever MySQL/MariaDB or PHP version they would like.

Information on updating the system PHP version can be found here.

There currently is not an official guide to updating MySQL/MariaDB, however, most any guide found with a google search of “Update MySQL (or MariaDB) from [old version] to [new version]” should work without issue.

One thing to note, as of InterWorx 6.3.21, the installation script defaults to installing newer versions of PHP and MariaDB. However, specific versions can be specified using the -m and -p flags at installation. More detailed information on the install tool flags can be found here.