Linux Installation Best Practices

How you install Linux has an impact on Open Manage Network Manager’s installation. Here are some tested best practices:

• Make sure you follow the instructions in Important: Configure File Handles in Linux.

• You can install Linux in its Desktop option, or if you select Basic Server (default) - choose additional packages: XWindows, Basic / Core Gnome Desktop without Gnome utilities, although we suspect any Gnome will work)

• This application can run on any Linux desktop environment (CDE, KDE, Gnome, and so on) but the installer will only install shortcuts for CDE.

• Turn off SE Linux in /etc/selinux/config. Change SELINUX=disabled. This typically requires a reboot.

• You must install compatibility library from installation media (so it is compatible with installation)

compat-libstdc++-33.x86_64 3.2.3-69.el6 @InstallMedia.

• Add your IP and hostname to /etc/hosts. For example:

10.18.0.241 rh6Test

Also: verify that /etc/hosts points to new name-use the following command and you should see similar output.

[qa@rh6Test Desktop]$ cat /etc/hosts

10.18.0.241 rh6Test.local rh6Test # Added by NetworkManager

127.0.0.1 localhost.localdomain localhost

::1 rh6Test.local rh6Test localhost6.localdomain6 localhost6

Install Open Manage Network Manager on Linux

To install on Linux, follow these steps:

1. In the operating system, create new user by going to System > Administration > Users and Groups > Add User.

2. Disable Firewall with System > Administration > Firewall.

3. Disable SELINUX.

4. In System > Administration > Add/Remove Software:

a. Remove package “The shared libraries required for MySQL clients” = mysql-libs-5.1.52-1.el6_0.1 (x86_64)

a. Install package “Compatibility standard c++ libraries” = compat-libstdc++-33-3.2.3-69.el6 (x86_64)

5. Open /etc/security/limits.conf and ensure the following are at minimum 65535:

<installing user> soft nofile 65536

<installing user> hard nofile 65536

<installing user> soft nproc 65536

<installing user> hard nproc 65536

6. Restart Linux.

7. Create folder /opt/dorado, and chmod 777 the folder.

8. Install Open Manage Network Manager as described in Installation and Startup.

Troubleshooting:

Upon Login, if you see the message “Credentials are needed to access this application.” Add oware.appserver.ip=[application server IP address] to /oware/synergy/tomcat-XXX/webapps/ROOT/WEB-INF/class/portal-ext.properties.

Upgrading on Linux

The following are best practices for upgrading from a previous version of Open Manage Network Manager on a Linux machine (see also Upgrading from a Previous Version, if that applies):

1. Make sure Red Hat is not installed with a MySql database option (or remove the Linux MySql first). Make sure to remove or rename the my.cnf file for that previous installation. The origin of the configuration in the several my.cnf files on Linux is /opt/dorado/oware3rd/mysql/5.0.51-pc-linux-i686-64/my.cnf, so be sure to alter that one if you are reconfiguring Open Manage Network Manager’s MySql.

2. Ensure you have installed the 32-bit Linux Libraries, as described below.

3. Verify your previous version’s installation application server starts without exceptions

4. Back up the database, and any other resources that need manual installation. Consult Release notes for a list of these.

5. Proceed with the upgrade.

See Upgrading from a Previous Version for more.

Disable Firewalls

System->Administration->Firewall - You may be prompted to enter the root password; the password dialog may be hidden behind the Firewall Configuration Startup dialog.

Directories and permissions

Create the directory for the installation:

1. Open a terminal.

2. Change to Super User: su <enter> password: []

3. Create directory and configure its ownership and permissions:

mkdir /opt/

chown [your login name] /opt/[your installation directory]

chmod 775 /opt/[your installation directory]

[your login name] is the original non-root user available when you imported the machine. Replace [your login name] with whichever user you are logged in as or will be installing as.

You may need to change the permissions on the installer in our package in order to give it execute rights. If you have used the shared folder method from above, you can give the Linux installer rights as follows:

chmod uga+x /[Install Media Path]/linux_install.sh

Make sure that there is no other my.cnf file under the /etc directory. If there is, do the following:

mv /etc/my.cnf /etc/my.cnf.original

The origin of the configuration in the several my.cnf files on Linux is /opt/dorado/oware3rd/mysql/5.0.51-pc-linux-i686-64/my.cnf, so be sure to alter that one if you are reconfiguring Redcell’s MySql.

32-bit Linux Libraries

For Red Hat Enterprise 64 bit installations, you must identify the appropriate package containing 32-bit libtcl8.4.so (for the example below: tcl-8.4.13-3.fc6.i386.rpm for Red Hat).

Do not use any x86_x64 rpms; these would not install the 32-bit libraries.

Any 32-bit tcl rpm that is of version 8.4 and provides libtcl8.4.so works. You can download them from Sourceforge: http://sourceforge.net. Download these, then issue the command:

rpm -ivh --force tcl-8.4.13-3.fc6.i386.rpm

This forces the installation of the 32-bit libraries on a 64-bit system. Ensure that your expect executable in your installation directory is properly linked by issuing the following commands:

[someone@RHEL5-64bit ~]$ which expect

/opt/dorado/oware3rd/expect/linux/bin/expect

[someone@RHEL5-64bit ~]$ ldd /opt/dorado/oware3rd/expect/linux/bin/expect

linux-gate.so.1 => (0xffffe000)

libexpect5.38.so => /opt/dorado/oware3rd/expect/linux/bin/libexpect5.38.so (0xf7fd2000)

libtcl8.4.so => /usr/lib/libtcl8.4.so (0x0094c000)

libdl.so.2 => /lib/libdl.so.2 (0x0033e000)

libm.so.6 => /lib/libm.so.6 (0x00315000)

libutil.so.1 => /lib/libutil.so.1 (0x00b8d000)

libc.so.6 => /lib/libc.so.6 (0x001ba000)

/lib/ld-linux.so.2 (0x0019d000)

Make sure that libtcl8.4.so maps to /lib/libtcl8.4.so An Alternative for Red Hat Linux:

1. Copy /usr/lib/libtcl8.4.so from a 32-bit RH system to /usr/local/lib/32bit on your 64-bit Red Hat system

2. As root, execute: ln –s /usr/local/lib/32bit/libtcl8.4.so /usr/lib/libtcl8.4.so

Linux Upgrade Procedure

The following are suggested upgrade steps, when you are installing a new version of Open Manage Network Manager, and a new Linux operating system. See also Upgrading from a Previous Version and the previous section, Upgrading on Linux:

1. Backup the MySQL database and copy the backup to another machine or network drive with the following command lines:

mysqldump -a -u root --password=dorado --routines owbusdb > owbusdb.mysql

mysqldump -a -u root --password=dorado owmetadb > owmetadb.mysql

mysqldump -a -u root --password=dorado lportal > lportal.mysql

The password may be different than the default (dorado).

2. Install the upgraded Linux (here, 6.2).

a. Prepare ISO DVDs. For example, Centos-6.2-x86_64-bin-DVD1 and DVDBi2

b. Select boot from cd-rom in the Boot Menu

c. Install linux 6.2

d. Select your install type. For example: Desktop. Best prac­tice is to use same settings for hostname, IP, and so on.

3. Install the Open Manage Network Manager upgrade on the updated Linux installation.

a. Make sure to look at Linux Installation Best Practices, Important: Configure File Handles in Linux and Install Open Manage Network Manager on Linux.

b. Remove package (if it exists) "The shared libraries required for MySQL clients" = mysql-libs-5.1.52-1.el6_0.1 (x86_64)

c. Install package "Compatibility standard c++ libraries" = compat-libstdc++-33-3.2.3-69.el6 (x86_64)

d. Install the Open Manage Network Manager upgrade. (5.2)

4. Import the MySQL database. Shutdown application server and webserver. Use ps-ef | grep java to confirm no running java process exists. Kill them if any exist.

a. Drop the database with the following command lines:

mysqladmin -u root --password=dorado drop owmetadb

mysqladmin -u root --password=dorado drop owbusdb

mysqladmin -u root --password=dorado drop lportal

b. Create a new database with the following command lines:

mysqladmin -u root --password=dorado create owmetadb

mysqladmin -u root --password=dorado create owbusdb

mysqladmin -u root --password=dorado create lportal

c. Import the backed up database:

mysql -u root --password=dorado owmetadb < owmetadb.mysql

mysql -u root --password=dorado owbusdb < owbusdb.mysql

mysql -u root --password=dorado lportal < lportal.mysql

To validate data:

d. Start the application server with: #service oware start

e. Start the webserver when the application server is ready: #service synergy start

f. Log in to confirm data were imported correctly

5. Upgrade Open Manage Network Manager further, if needed (to 5.3).

Shutdown application server and webserver. Use ps-ef | grep java to confirm no Java process exists. Kill any such process if it lingers.

a. Go to the installation package’s inux_install.bin directory, open a terminal and type . /etc/.dsienv.

b. Type ./linux_install.bin to start installing

The servers autostart when they finish installing. You may need to reboot the server if your performance monitor data do not appear.