Differences

This shows you the differences between two versions of the page.

--- maintenance:general:ova_installation_guide [2021/02/11 09:08] – ↷ Page name changed from maintenance:general:ova_installation_guide2 to maintenance:general:ova_installation_guide bdorlandt
+++ maintenance:general:ova_installation_guide [2024/07/03 12:31] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== VM installation guide ======
+This installation guide installs NetYCE version 7.x based on a Centos 7 on your Hypervisor. The OVA can be used for VirtualBox or VMware or the VDI could be extracted to used it with other hypervisors as well.
+This is by far the easiest installation method, as everything is already prepared.
+===== Hypervisor choices =====
+==== Virtualbox =====
+The received OVA file can be imported directly.
+==== VMware =====
+The received OVA file can be imported directly.
+==== KVM/Qemu =====
+Convert the vmdk file to qcow2:
+<code>tar xvf NetYCE_genesis.ova
+qemu-img convert -O qcow2 Genesis-disk001.vmdk Genesis-disk001.qcow2</code>
+Set up your own VM and link the created disk image.
+==== Hyper-V =====
+Convert the vmdk file to vhd:
+<code>tar xvf NetYCE_genesis.ova
+VBoxManage clonemedium disk Genesis-disk001.vmdk Genesis-disk001.vhd --format vhd</code>
+Set up your own VM and link the created disk image.
+===== VM instantiation =====
+At this point it is possible to assign one or multiple network interfaces. By default a single interface is provided. Depending on your setup requirements another interface might be desired to separate internal and external traffic.
+Make sure all your desired interfaces are assigned within your hyper-visor.
+| For testing on your laptop, you'll usually end up with 2 interfaces. One is your internal interface for connectivity to the NetYCE product and the other interface is connected to a NAT interface for access to the internet.
+===== CLI accounts =====
+If for some reason you need to log in explicitly, you may do so using either the:
+  * **root** account
+    * password: NetYCE01
+  * **yce** account
+    * password: NetYCE01
+    * sudo command: ''sudo -i''
+===== Setting up the network =====
+Once the VM is started it will automatically sign-in as the ''root'' user and the net_setup.pl script is automatically started.
+In case you missed it you may execute it manually ''net_setup.pl''
+Unless you have changed the settings in the hypervisor, these defaults apply:
+  * A single interface is present and enabled with DHCP
+During the questions, make sure to set up the following at least:
+  * Set the root password
+  * Set the yce user password
+  * Set the hostname/domain
+  * Set up the network interface(s)
+  * Set up NTP (if possbile, see [[maintenance:general:ova_installation_guide#caveats|caveats]])
+  * Set up the roles for the interfaces.
+If you made a mistake during these steps you can always back out (ctrl+c) and start the process again using ''net_setup.pl'' or ''/opt/yce/system/net_setup.pl''. More information on [[maintenance:general:tools:net_setup.pl|net_setup.pl]]
+  * reboot
+===== Setting up YCE =====
+Log into the system (local or via ssh) using the ''yce'' user and the password you've set.
+By default the system is reachable using HTTP.
+If you wish to enable SSL, the script ''[[maintenance:general:tools:mk_ssl_cert.pl|mk_ssl_cert.pl]]'' needs to be run. This script helps you to configure a 'certificate signing request' or can set up a 'self-signed certificate'.
+To enable this and to make other modifications, like making NetYCE DNS resolvable, the script ''[[maintenance:general:tools:yce_setup.pl|yce_setup.pl]]'' or ''/opt/yce/system/yce_setup.pl'' is used.
+The questions will be about the application set up, which will include:
+  * yce server roles. Set reachability, using IP or DNS with or without SSL
+Especially the DNS/IP based access is important. (It is either DNS or IP based, not both at the same time)
+If this installation is a test VM it is usually easier to set it up based on IP access. If this is a production/lab installation a DNS setup will probably be desired.
+The other defaults are usually good.
+===== Access =====
+You may now access the NetYCE application using your favorite browser using either the FQDN or the assigned IP address.
+The username and password for the browser are:
+  * user: NetYCE
+  * password: NetYCE01
+===== Q&A =====
+**Q** I'm logged in the GUI but can't see the grids.\\
+**A** You are trying to use the FQDN while the application is set to using the IP address or the other way around. Run ''yce_setup.pl'' and set DNS resolved to either yes/no, depending on your environment.
+**Q** After logging in nothing is shown at all.\\
+**A** Make sure you are allowed to access the NetYCE system using either TCP port 80/443 and port 8080. See: [[guides:reference:connection_matrix|YCE Connection matrix]]
+**Q** Where do I find the latest patches and licenses? \\
+**A** [[https://wiki.netyce.com/doku.php/downloads:system_updates:system_updates | Patches and licenses]]
+**Q** Can't access the GUI, showing ''<nowiki>{{ version }}</nowiki>'' \\
+**A** Make sure you've run '[[maintenance:general:tools:net_setup.pl|net_setup.pl]]' as root, '[[maintenance:general:tools:yce_setup.pl|yce_setup.pl]]' as 'yce'-user.
+  - verify all processes are running using 'go ps'
+  - if mysql is not running, execute: mysql_repair.sh as 'yce'-user
+  - execute 'go up' for the remaining processes
+  - Make sure all necessary ports are reachable, [[guides:reference:connection_matrix|connection matrix]]
+{{:downloads:gops.png?nolink |}}
+**Q** Could not connect to backend \\
+**A** Have you ran '[[maintenance:general:tools:yce_setup.pl|yce_setup.pl]]' as 'yce'-user and are you connecting using the chosen method. Either ip based or name (dns) based?
+  - verify all processes are running using 'go ps'
+  - execute 'yce_setup.pl' to verify if ''ip'' or ''dns''-based connections are set up.
+  - Make sure all necessary ports are reachable, [[guides:reference:connection_matrix|connection matrix]]
+===== Caveats =====
+==== NTP / time sync ====
+For every setup it is important to make sure you time is in sync. This is normally not an issue, when using NetYCE as a dedicated VM with NTP installed. Though if you choose to install NetYCE on your laptop without NTP and it happens to sleep for more than 24 hours, the time gets outdated.
+Solutions to address this:
+  * reboot the VM
+  * VirtualBox; install guest additions for your hypervisor:
+    * Make sure to enable a cdrom hardware in your hypervisor for this VM, so the guest additions can be mounted
+    * [[https://www.if-not-true-then-false.com/2010/install-virtualbox-guest-additions-on-fedora-centos-red-hat-rhel/|VirtualBox guest additions]]
+  * VMware; Enable 'time sync'
+    * [[https://pubs.vmware.com/bde-2/index.jsp?topic=%2Fcom.vmware.bigdataextensions.admin.doc%2FGUID-B54C8A8B-700D-4AE4-9DA3-9B35A62EFD3E.html|VMWare guest additions]]
+    * Virtual Machine Settings > Options > VMWare Tools > Synchronize guest time with host