Troubleshooting Ensim Upgrade or Installer Issues
Problem : The host name of the server is incorrect.
Refer the log file /var/log/ensim/installer..-.log to review the list of successful and unsuccessful events recorded during the upgrade.
Check the file /etc/sysconfig/network. The host name must be a fully qualified domain name. See the following example.
Correct: myhost.mydomain.com
The file /etc/hosts should contain the host name and IP address of your server. If it does not, use an editor to modify the file.
—/etc/hosts begin file–
127.0.0.1 localhost.localdomain localhost
1.2.3.4 myhost.mydomain.com myhost
—/etc/hosts end file–
Ensim Install tips
Important: If you use the -x option with the installer to specify the network interface on which sites are to be provisioned, make sure that you add the IP address of the interface as the first entry in the /etc/hosts file before running the installer.
/etc/resolv.conf file
—/etc/resolv.conf begin file—
primary_name_server ip_address
secondary_name_server ip_address
—/etc/resolv.conf end file—
/etc/sysconfig/network file
—/etc/sysconfig/network begin file—
NETWORKING=yes
DOMAIN=mydomain.com
HOSTNAME=myhost.mydomain.com
GATEWAY=ip_address_gateway
—/etc/sysconfig/network end file—
Installing your SSL Certificate / Web Server Certificate / Secure Server Certificate in Ensim
Your certificate will be sent to you by email after you get that from SSl providers. The email message includes the web server certificate that you purchased in the body of the email message.
Copy the certificate from the body of the email and paste it into a text editor (such as notepad) to create text files. Name this file yourdomain.txt and save it in a convenient place.
These instructions apply for both Ensim Pro and Ensim 3.x.
1. Click SSL Settings - access to this link may differ depending on your version of Ensim:
If you are running Ensim Pro. In the shortcuts section of the Home page, click SSL Settings in the Web Server section:
Or if you are running Ensim 3.x, click the Services link on the left, then click the Edit button for the Apache Web Server service:
2. Then in the Apache Web Server Manager click the SSL Settings link.
Select Import at the bottom of the SSL Settings form.
3. Copy the contents of yourdomain.txt and paste it into the Certificate text box
Be sure to include —–BEGIN CERTIFICATE—– through —–END CERTIFICATE—–
4. Select Save.
5. To make security effective on your domain, restart the Web server. The domain is not secure until you do so.
Test your certificate by using a browser to connect to your server. Use the https protocol directive (e.g. https://your server/) to indicate you wish to use secure HTTP. Note: The padlock icon on your browser will be displayed in the locked position if your certificates are installed correctly and the server is properly configured for SSL.
Troubleshooting Issues with ensim installer
Issues that you may encounter during the installation. You may refer to the log file /var/log/ensim/installer..-.log for details.
Example:
During installation, the following message is displayed:
This means The host file is incorrect.
The file /etc/hosts should contain the host name and IP address of your server (see the following example). If it does not, use an editor to modify the file.
Example
—/etc/hosts begin file—
127.0.0.1
localhost.localdolocalhost
1.2.3.4 myhost.mydomain.com
myhost
—/etc/hosts end file—
where 1.2.3.4 is the IP address of myhost.mydomain.com
Also check the file /etc/sysconfig/network. The host name must be a fully qualified domain name.
See the following example.
Incorrect: myhost
Correct: myhost.mydomain.com
Find Ensim Version
To find the Parallels (Ensim) Pro appliance version, run the following command as root user.
A output of the command looks like CPVersion-OSVersion. For example, 10.2.0-fc.6.5 means, control panel version 10.2.0 is installed on a Fedora Core 6 server.
Another alternate method is to check the file at /usr/lib/opcenter/VERSION
$ cat /usr/lib/opcenter/VERSION
