Skip to main content
Code42 Support

Server settings reference

Available in:

StandardPremiumEnterprise
Small Business
Applies to:

Overview

From the Server Settings screen, you can access various Code42 server details, as well as configure email alerts related to free space and backup status.

Server settings

To view Server Settings, go to Settings > Server.

Server Settings screen

Item Description
a Current server version Displays the current version of the Code42 server software.
b Current console version Displays the current version of the administration console software.
c Daily accounting time Sets the time when the daily accounting job runs.
d Maintain archives every Specifies how often this destination performs archive maintenance on each archive.
e Keep expired cold storage archives for Specifies how long to store expired archives. When set to 0 days, archives are purged from disk the next time daily accounting runs following cold storage expiration.
f Archive maintenance queue Opens a view of backup archives currently waiting for maintenance to be performed.
g System logs Opens a view of the logs from this server.
h Website protocol, host and port

Sets the URL used for the administration console and for all system emails, including alerts and reports.

  • The protocol can be https:// or http://.
  • The host can be a hostname or an IP address (IPv4 or IPv6).
  • For https, use port 4285. For http, use port 4280.
i Primary network address

Sets the first-choice network address for communication with user devices and other Code42 servers.

  • Once a device connects to the authority server, these network address fields overwrite any information entered into the device.
  • The primary network address can be either a hostname or an IP address (IPv4 or IPv6), but a hostname is recommended for most environments.
j TLS port

Sets the messaging port that Code42 apps use when communicating with the Code42 server using Transport Layer Security (TLS). The default port is 4287.

k Legacy port

Sets the legacy messaging port that Code42 apps use when communicating with the Code42 server if a TLS connection cannot be established for any reason.

  • The default port is 4282.
  • You cannot change the value of this field. It is set automatically as 5 less than the TLS port.
  • Specify this port number in the Code42 server address you provide to Code42 apps for sign-in, for example:
    https://authority-server.example.com:4282
Configure apps with the legacy port
When you provide a Code42 server address to a Code42 app, provide the legacy port. The app adds 5 and tries to use the TLS port. If TLS fails, the app falls back to the legacy port.
l Secondary network address

Sets the fallback network address for communication with user devices and other Code42 servers.

  • Devices use the secondary network address only when they cannot reach the primary network address.
  • The secondary network address can be either a hostname or an IP address (IPv4 or IPv6), but an IP address is recommended in order to maintain connectivity in case DNS services are unavailable.
m

Proxy address

Sets the address of an HTTPS proxy server through which the authority server sends its requests to the Code42 licensing server.

  • The proxy address can be either a hostname or an IP address (IPv4 or IPv6), followed by a port number. An IP address is preferred in order to maintain connectivity when DNS services are unavailable.
  • You must provide a port number. There is no default port.
  • If no proxy is defined, requests go to the licensing server via port 443.
  • Requests to other Code42 servers do not go through the proxy.
    Requests to authority server and storage servers use your Code42 environment's standard ports.
n Auto-upgrade storage servers Enables or disables automatic upgrade of storage servers. When this option is enabled, the authority server will regularly attempt to upgrade any storage servers running an earlier version of the Code42 platform.
o Auto-upgrade devices Enables or disables automatic upgrade of Code42 app devices when a new device version is available. For more information, see Best Practices For Upgrading Your Devices.
p Language

Sets the administration console's default language.

  • The language setting can be overridden by the individual user from the administration console's toolbar language selector.
  • When Automatic is selected, the administration console displays the locale set for the host operating system.
q From address Sets the email address to send system mail from.
We recommend using an address within your company's domain to increase the probability that mail will be allowed through spam filters.
r Internal server

Enables or disables the internal email server, and displays or hides the custom mail server options below. We recommend that you use your own mail server for all production environments.

s Host Specifies the fully-qualified domain name (FQDN) or IP address of your mail server.
t SSL

Enables or disables email communication over the secure socket layer (SSL).

Emails not being sent
If you have enabled SSL but chosen to use the internal mail server, then you may not receive email notifications from the server. If this occurs, uncheck the SSL option and save your settings.
u Username and password Specifies the username and password for the account that the server will send mail from.
v Store point free space Sends an alert email to administrators when a store point's free space drops below the listed thresholds. Administrators receive one email when free space drops below the warning threshold and a second email when free space drops below the critical threshold.
w No backup for Sends an alert email to administrators when a device has not backed up to any destinations for more than the configured number of days. A single email is sent when each threshold is passed.
x Action Menu Contains available server commands.
y Reset Discards changes and resets settings to previously saved values.
z Save Saves changes.

Action menu

Item Description
Run Daily Accounting Execute the daily accounting job immediately.
Send Test Email Send a test email using your currently configured mail settings.
Send Logs

Use when our Customer Champions request your log files for troubleshooting

Displays a window in which you can enter your support ticket. When you click send, the necessary log server files are packaged and sent to our Customer Champions with the associated support ticket number.

Dump Database

Immediately creates a database dump of this server's database. The authority server's database is required to recover a failed Code42 server or to move the Code42 server to different hardware.

Note: This item is dimmed if the Code42 server uses a PostgreSQL database.

Import Database

Import a database dump.

Note: This item is dimmed if the Code42 server uses a PostgreSQL database.

Restart Server Restart the Code42 server process
Upgrade Upgrade your server and clients to a newer version.

Archive maintenance queue

Go to Settings > Archive Maintenance to view the Archive Maintenance Queue for the server you signed in to.

Archive Maintenance screen

Item Description
a Action Menu Contains available archive maintenance commands.
b Maintenance Job GUID Displays the GUID of the device queued for archive maintenance.
c Type

Indicates the type and process that initiated the maintenance job. Possible types:

  • System - initiated by the system according to the configured maintenance interval, or in response to a detected error in the archive.
  • User - initiated by a user, either in the Code42 app or from the device details in the administration console.
  • Deep - Can apply to both system and user maintenance. Performs more in-depth maintenance on the archive. By default, scheduled to run once every 28 days.
d Status Displays the progress of maintenance job.
e Actions Click to cancel the job.

Action menu

Item Description
Adjust Maintenance Rates Displays the Adjust Maintenance Rates window.
Stop Maintenance Jobs Prevents maintenance jobs from running until Resume maintenance jobs is selected.

Adjust maintenance rates

To view Adjust Maintenance Rates, go to Settings > Archive Maintenance and from the action menu, click Adjust Maintenance Rates.

Adjust Maintenance Rates screen

Item Description
a Maintenance Rate, User Jobs Sets the percentage of a single CPU thread to use for archive maintenance on user jobs. A lower value results in more time needed for archive maintenance jobs.
b Maintenance Rate, System Jobs Sets the percentage of a single CPU thread to use for archive maintenance on system jobs. A lower value results in more time needed for archive maintenance jobs.
c Cancel Reverts changes and closes the Adjust Maintenance Rate window.
d Save Saves changes and closes the Adjust Maintenance Rate window.

Logs

To view Logs, go to Settings > Logs.

Logs screen

Item Description
a Log selector Selects the log to display. Default is the most recent general history log (history.log.0).
b Regular expression filter Filter the displayed logs using regular expressions.
c Log viewer Displays the contents of the selected log.
d Previous page Click to display the previous page of log information.
e Page selector Click a dot to select a specific page of logs. Mouse over a dot to see a tooltip of each page number.
f Next page Click to display the next page of log information.
g Page indicator Identifies the page of log information currently shown in the log viewer.

Storage server settings

Viewing the Server settings from the administration console of a storage server presents a limited number of configurable settings.

Storage server console

Item Description
a Name

Name of the storage server.

b Current server version

Version of the Code42 server software.

c Current console version Version of the administration console software.
d Archive maintenance queue

Displays the list of backup archives currently waiting for maintenance to be performed.

e System logs

Opens a view that displays the logs from this server.

f Website protocol, host and port

Sets the URL used for the administration console and for all system emails, including alerts and reports.

  • The protocol can be https:// or http://.
  • The host can be a hostname or an IP address (IPv4 or IPv6).
  • For https, use port 4285. For http, use port 4280.
g Primary network address

Sets the first-choice network address for communication with user devices and other Code42 servers.

  • Once a device connects to the authority server, these network address fields overwrite any information entered into the device.
  • The primary network address can be either a hostname or an IP address (IPv4 or IPv6), but a hostname is recommended for most environments.
h Secondary network address

Sets the fallback network address for communication with user devices and other Code42 servers.

  • Devices use the secondary network address only when they cannot reach the primary network address.
  • The secondary network address can be either a hostname or an IP address (IPv4 or IPv6), but an IP address is recommended in order to maintain connectivity in case DNS services are unavailable.
i Proxy address

Sets the address of an HTTPS proxy server through which the authority server sends its requests to the Code42 licensing server.

  • The proxy address can be either a hostname or an IP address (IPv4 or IPv6), followed by a port number. An IP address is preferred in order to maintain connectivity when DNS services are unavailable.
  • You must provide a port number. There is no default port.
  • If no proxy is defined, requests go to the licensing server via port 443.
  • Requests to other Code42 servers do not go through the proxy.
    Requests to authority server and storage servers use your Code42 environment's standard ports.
j Private address

Sets the address that other Code42 servers within the destination use to communicate with this Code42 server for internal statistics and data balancing traffic.

  • The private address can be either a hostname or an IP address (IPv4 or IPv6).
  • Only the address is accepted in this field. The port numbers—4283, 4286, and 4288—are not configurable.
k Language

Sets the default language for the administration console. When Automatic is selected, the administration console displays the locale in use by the authority server's operating system.

l Reset

Discards changes and resets settings to previously saved values.

m Save

Saves changes.