menu

Configuration wizard

Configuration wizard can be used to initially configure Navixy platform or change some common settings.

All of the settings described below can be applied directly to the database and service configurations, but in this case there is a risk of malfunctioning if handled carelessly. Using the configurator avoids this risk.

If you have a non-standard platform installation, or your task is beyond the capabilities of this wizard, you can use the various configuration guides on this website for specific tasks or contact technical support.

Configuration wizard can only be used for Navixy instances installed automatically or deployed from AMI.

For platform installed manually (Linux or Windows) the wizard is not available.

To run the wizard, go to the Navixy package directory and run ./configure.sh

You will be greeted by the main menu:

configuration-menu

Below is the explanation of each menu and sub-menu:

The only option here is to change domain names.

The Configuration Wizard allows you to configure only three domain names - separate for API, for admin panel and for the user interface. If you need to perform the configuration using only one domain or with no domain name at all, you need to refer to the instruction for manual platform installation.

If you want to continue configuring three domain names, you will be prompted to enter the base domain first - that is, enter the second and top level domains, e.g. example.com.

Configuration wizard

After that, you need to sequentially specify domain names for API, admin panel and user interface. Be careful - here you specify only third-level domain names, without specifying the second and top levels.

Configuration wizard

Configuration wizard

Configuration wizard

Once all domains are specified, the wizard will show you the results of your configuration. If you need something to be changed, run the wizard once again

Configuration wizard

You can learn more information about domain names at this page.

Here you can apply settings of your SMS-gateway, and also specify credentials of service SMS sender.

Configuration wizard

1. Configure SMS gateway

The first option in this menu allows you to disable the SMS gateway if you already have one set up and no longer need to use it.
The other options allow you to apply settings for a specific SMS gateway service provider.
The last option allows you to connect the SMS gateway via SMPP protocol. This option is also suitable if your gateway provider is not on the list, but it supports SMPP on its side.

Configuration wizard

You can learn more about SMS gateways on the corresponding page on this website.

2. Configure FROM name and phone number

In this menu you can specify the number and name of the sender of service SMS messages, if necessary.

Configuration wizard

Configuration wizard

Here you can configure only feedback email settings.

Please note: Main email gateway settings are configured from the admin panel (more information on email gateway).

The script will ask you to specify the email address to receive user feedbacks from a help section (TO email address).

Configuration wizard

Then you will be asked about user email substitution.

Configuration wizard

Select YES to use the email address of the user to send feedback requests.

Select NO to replace the sender's email address with a specific one. In this case, the script will ask you to specify this email address (FROM email address).

Configuration wizard

Here you can specify the Google maps API key if you did not purchase the Premium GIS package from Navixy, but preferred to use the key you purchased yourself.(More information on API keys)

Configuration wizard

First, you need to specify Google API JavaScript key (required for maps availability).

Configuration wizard

Next, apply Google API server key (required for geocoding operations).

Configuration wizard

This section contains two options.

Configuration wizard
1. Change license key

Here you can specify the license key for your On-premise instance. The license key is applied during the initial installation of the platform, or if it is lost or corrupted for some reason (usually a consequence of tampering with the database). The license key is issued and provided by technical support.

After selecting this option, you will see a warning that changing the license key carelessly may cause the platform to become inoperable.

Configuration wizard

After that you need to apply the license key you received. This is a rather long combination of characters, so it can be quite difficult to enter manually. You can paste the key from a clipboard by using Shift+Insert combination. Alternatively, you can hold Shift and use mouse right click.

Configuration wizard

The key will be inserted into the database, and your instance will have a valid license.

2. Request trial key

This option can only be used to get a one-time trial key. The key is valid for 30 days.

  • You cannot re-issue or renew the trial key in this way.
  • You cannot restore a lost key in this way.
  • You cannot restore a disabled license in this way.

If your trial expired and you need to continue using your On-premise instance, contact technical support.

Plugins allow to modify or enable various functions of the platform. Since the configurator is designed for basic platform configuration, you can only find three plugins in this menu.

Configuration wizard

1. Activation code settings

Here you can enable or disable the use of mandatory activation codes for device registration. If the "Mandatory" option is enabled, users will not be able to register a device without an activation code.

Configuration wizard

2. Custom logo settings

Here you can set up a special logo for an individual user.
Please note: the logo for the entire platform is customized in the admin panel.
The configuration wizard will ask you to specify the user ID (it can be found in the admin panel or in the user interface)

Configuration wizard

Next, you need to specify a link to the user's logo. It can only be located on an external resource, there is no possibility to store it on the server. The recommended size is 400x400 pixels, PNG format.

Configuration wizard

The logo will be applied to the interface and to the reports.

3. Help section settings

Here you can choose whether to hide or show help section in the user interface (it is shown by default). Help section leads to Navixy website, so its disabling may be useful for white labeling.

Configuration wizard

This section allows you to enable and disable file storage.

Configuration wizard

It is used to store file and image attachments to the task forms and maintenance works. The default directory for storing files is /home/java/api-server/files.

This menu allows us to install SSL certificates if your platform is configured to use HTTPS. The only option here is to install SSL certificates.

You will see a warning that you will need a registered DNS record and a public IP address. Confirm to continue.

Automatic installation

The script will ask you whether you are going to use free Letsencrypt SSL certificates, or you want to use your own certificates.

LetsEncrypt

Select Yes to install free LetsEncrypt SSL certificates for your domains. This installation also implies certificates auto-prolonging every three months, which is also free

Automatic installation

The script will install the software needed to issue the certificate. You will need to accept the terms of service - enter y.

Automatic installation

Next, you will be prompted to select domains for which to install certificates. It is recommended that you do this for all domains at once. To do this, you do not need to specify anything, just leave the field empty and press Enter.

Automatic installation
Once certificates are issued and installed, your domains will be SSL-protected.
Your certificate

If you choose "NO" when the script asks you if you want to install a LetsEncrypt certificate, you will be directed to the menu to install your own SSL certificate.

To proceed, you must have a valid full-chain certificate as well as its private key. Place them somewhere on your server. The standard location is /etc/nginx/ssl.
First you need to specify a path to the certificate file:

Configuration wizard

Next, specify the path to the private key file:

Configuration wizard

The paths to your certificates will be inserted to Nginx configuration.

Certificates are now installed, and your domains are SSL-protected.

Video Telematics NEW
Open
Video Telematics NEW
Review incidents
Determine liability
Coach drivers
Learn more >
Open

This website uses cookies.
See our Privacy Policy to learn more.