Note that these setup steps are only required if you run OfficeExpert

  • in a custom virtual network without public IP on Azure
  • on-premises.

Note that for VMWare deployments, we recommend raising the hardware version of the virtual machine according to your environment. Further information: https://kb.vmware.com/s/article/1010675

Welcome Screen and IP Address

After starting up the appliance for the first time, you should be presented with a panagenda OfficeExpert welcome screen. If your network has a public DHCP server available, the system might already have acquired an IP address and will display the URL. Use the shown IP address (interface URL) in your web browser to connect to the panagenda OfficeExpert web interface. If DHCP is not available within your network or the panagenda OfficeExpert appliance did not acquire any IP address, you have to configure the panagenda OfficeExpert appliance network settings (see Network Settings below).

Appliance Login

OfficeExpert provides a console and a graphical user interface which enables you to configure operating system level settings like network, time, and time zone settings.

Default login information:

user "root" with password "config"

Changing default credentials:

 Default credentials are supplied for setup and initial configuration. It is not recommended to keep using them after the appliance has been set up.

We strongly suggest changing the default credentials for these components:

Console

After login, basic information, such as disk space, system time, and IP address, are shown:

Graphical User Interface

There are two ways to use the GUI to configure your OfficeExpert appliance:

  1. Local with ESX Console (not available for Azure Deployments because you can't call a GUI via a simple ssh session!)
    In order to start the GUI locally, enter the command "startx"
    To start the GUI automatically when OfficeExpert is booted, please enter the following command: "systemctl set-default graphical.target"
  2. Remote Access via VNC

     Note that remote VNC access is only possible if the OfficeExpert appliance has received an IP address via DHCP.

    Please refer to  Remote Appliance Access (VNC) for more details on VNC access.

GUI Basics

The Applications menu provides access to all required applications:

You can access all required applications by using the desktop icons, too.


To check an established internet connection, a web browser (Mozilla Firefox) is available on the panagenda OfficeExpert appliance.

You can use the terminal window to check if your TCP/IP connection is established. To to this, use Linux's ping and ifconfig commands. For more information about these commands, type man ping or man ifconfig in the terminal console window.

panagenda OfficeExpert log files can be found within the /opt/panagenda/logs directory. Use the Files app to navigate to these log files.

To check the panagenda OfficeExpert appliances system behavior, you can use the installed system monitor.


Network Settings:

To change the IP address and DNS configuration, click on the Network icon. Select the Ethernet connection and click on Edit:

Go to the IPv4 Settings tab and select Manual from the Method drop-down menu to configure the network settings as required:

TIP: If you configure "DNS Search domains", not full qualified names will also be resolved.

The virtual appliance MUST be able to resolve its own host name. Please verify that by opening a terminal window (click "Terminal" on the desktop) and using the ping command. It is recommended that both host/common name as well full qualified domain name are pingable.

Be aware that the OfficeExpert appliance uses the following two IP ranges by default for the internal Docker communication:

192.168.237.0/24      (previous used IPs: 172.17.0.1/16)
192.168.238.0/24
      (previous used IPs: 172.20.0.1/16)

Please adjust these if the two IP Ranges conflict with your internal network.

For details please refer to Customize Docker IP Settings.


Please adjust the host name (by default "OfficeExpert") in the Host Information application (Desktop Icon):

or via terminal:  vim /etc/hostname


Time Zone Settings:

Check the time zone settings of the appliance and use the Time and Date application to adjust these.

It is very important to adjust the appliance's time zone. Reboot the appliance after changing the date/time settings as the web server and database system require a clean start with the new configuration.

or via terminal:  timedatectl set-timezone America/New_York


Configure Time Server:

Open a terminal and enter vim /etc/ntp.conf:
 
Please specify your internal NTP server in case you have any OR keep the existing NTP servers in the list:


Run Setup Script

In order to set up panagenda OfficeExpert for your environment, run the script, open terminal console, and enter the following command:

/opt/panagenda/appdata/setup/setup.sh

The setup script creates all docker containers and generates the required files (certificates, key files, configuration files, CA, etc.), and copies them to the master and worker nodes. 

The script will prompt for following information:

  1. Master node – FQDN of the OfficeExpert appliance

  2. Passwords – please set a SSL password (used for client simulations and the Windows Proxy host). The password needs to have at least 8 characters

OPTIONAL: Company-owned SSL certificate

Using the default SSL certificate shipped with OfficeExpert might lead to issues with the OfficeExpert ACE Teams App or the PowerBI templates. Please refer to SSL Certificate for further details.