Please note that these setup steps are only required if you run OfficeExpert...
- in a custom virtual network without public IP on Azure
Please also 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).
OfficeExpert provides a console and a graphical user interface in order 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:
- Linux user "root" (using the "passwd" command)
- VNC server (see Remote Appliance Access (VNC))
- Web user "config" (see User Settings)
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:
- 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"
Remote Access via VNC
Please note that remote VNC access is only possible if the OfficeExpert appliance received an IP address via DHCP.
Please refer to Remote Appliance Access (VNC) for more details on VNC access.
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, using Linux ping and ifconfig command. For more information about ping and ifconfig 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.
To change the IP address and DNS configuration please 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.
Please 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 them in case these two IP Ranges conflict with your internal network.
For details please refer to Customize Docker IP Settings.
Please adjust the host name (default is "OfficeExpert") in the Host Information application (Desktop Icon):
or via terminal: vim /etc/hostname
Time Zone Settings:
Please check the time zone settings of the appliance, use the Time and Date application to adjust.
It is very important to adjust the appliance's time zone. Please 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, please run the script: open terminal console and enter the following command:
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:
- Master node – FQDN of the OfficeExpert appliance
- 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 on that!