To get started installing Morpheus on CentOS/RHEL a few prepratory items should be addressed first.
First configure firewalld to allow access from users on port 80 or 443 (Or disable firewall if not required). It is also important to make sure the machine is self resolvable to its own hostname.
For RHEL: In order for the guacamole service (remote console) to properly install some additional optional repositories first need added.
RHEL 7.x Amazon:
yum-config-manager --enable rhui-REGION-rhel-server-optional
yum-config-manager --enable rhel-7-server-optional-rpms
For Amazon users a redhat subscription is not required if the appropriate yum REGION repository is added instead as demonstrated above.
IMPORTANT! If the machine is unable to resolve its own hostname (
nslookup hostname) some installation commands will be unable to verify service health during installation and fail.
Next simply download the relevant
.rpm package for installation. Morpheus release packages can be acquired from the downloads section in the Morpheus Hub. Please note the download section will only appear in the hub if you have an approved morpheus license. To request a license, visit https://morpheushub.com
TIP: Use the
wgetcommand to directly download the package to your appliance server. i.e.
Next we must install the package onto the machine and configure the morpheus services:
sudo rpm -i morpheus-appliance-x.x.x-1.x86_64.rpm sudo morpheus-ctl reconfigure
Once the installation is complete the web interface will automatically start up. By default it will be resolvable at
https://your_machine_name and in many cases this may not be resolvable from your browser. The url can be changed by editing
/etc/morpheus/morpheus.rb and changing the value of
appliance_url. After this has been changed simply run:
sudo morpheus-ctl stop morpheus-ui
sudo morpheus-ctl reconfigure
sudo morpheus-ctl start morpheus-ui
morpheus-uican take 2-3 minutes to startup before it becomes available.
There are additional post install settings that can be viewed in the Advanced Configuration section.
Once the browser is pointed to the appliance a first time setup wizard will be presented. Please follow the on screen instructions by creating the master account. From there you will be presented with the license settings page where a license can be applied for use (if a license is required you may request one or purchase one by contacting your sales representative).
More details on setting up infrastructure can be found in the Infrastructure section.
TIP: If any issues occur it may be prudent to check the morpheus log for details at