How do I update a Linux user’s home directory?

For more information on the new home directory format, please see this advisory.
Before making changes to your system, please review the general system administration best practices.

To migrate existing Linux users’ home directories to the new format:

Verify that /u2/eclipse/.profile has been updated:

vi /u2/eclipse/.profile

The following block of code must appear before “Setup the Eclipse environment.” If it doesn’t, add it:

# Move to the Eclipse account home directory
export ECLIPSEHOME=/u2/eclipse

After the .profile has been updated, backup the existing /etc/passwd file containing user information:

TIMESTAMP=`date +%Y%m%d.%H%M%S`
echo "`date`: backing up /etc/passwd to /etc/passwd.$TIMESTAMP"
cp /etc/passwd /etc/passwd.$TIMESTAMP

Run the following script to update the existing user’s home directories:

echo "`date`: started user migration"
awk -F":" '{ print $1 " " $6 }' /etc/passwd | egrep "$ECLIPSEHOME$" | sort | {
    while read LINE; do
        USERNAME=$(echo $LINE | awk '{print $1}')
        ECLIPSEHOME=$(echo $LINE | awk '{print $2}')
        echo "`date`: Setting $USERNAME's home directory to /home/$USERNAME with a link to $ECLIPSEHOME/.profile"
        mkdir -p /home/$USERNAME
        chown $USERNAME /home/$USERNAME
        usermod -d /home/$USERNAME $USERNAME
        ln -sf $ECLIPSEHOME/.profile /home/$USERNAME/.profile
        ln -sf $ECLIPSEHOME/.profile /home/$USERNAME/.bash_profile

Log in as an Eterm user to verify that the steps been completed properly. If you encounter any issues, please open a support request.

Review the updated user maintenance procedures.


How do I access Dell OpenManage?

The Dell OpenManage Server Administrator allows system administrators to manage individual servers from an integrated, Web browser-based graphical user interface (GUI). OMSA is designed for system administrators to manage systems locally and remotely on a network.

You may access the Dell OpenManage web interface from any computer (replace with your server’s LAN IP address):

  • Launch the OpenManage web interface (
  • Log in using your root username and password

What type of tasks can be performed using OMSA?

  • View the server’s hardware configuration
  • Check for hardware errors
  • Check for firmware updates
  • Replace or reconfigure storage


How do I add a user in AIX?

As with every command entered when performing system administration tasks from a command line, syntax is important. Please make sure that every character is entered exactly as shown below. To avoid common syntactical mistakes, we recommend you copy and paste the entire example commands into a text editor, make the necessary changes, and then paste the resulting commands into your terminal session.

  • NOTE: in the example below, we are adding a user with the username “johndoe.” Replace “johndoe” with the username you wish to add to the system.
  • Log into your server as root
  • Create a new user that’s a member of the “eclipse” user group:
mkuser johndoe
  • Set the user’s Linux login password:
passwd johndoe
  • NOTE: if you attempt to set a weak password, you may see a warning. If you are willing to accept using a weak password, simply type it in again and confirm to proceed. If you would like to create a user with a blank password, please see this article.
  • Create a link for the user’s profile, which will automatically launch Eclipse when they login:
Important: please verify that the order of arguments in the command is correct: /u2/eclipse/.profile must come first, followed by a space, and then the new user’s profile directory.
Important: please note there is a space between the source and destination locations.
ln -sf /u2/eclipse/.profile /home/johndoe/.profile
  • Open Eterm and log into the server using the newly created username and password. If you added the user correctly, ¬†you will be presented with the blue Eclipse login screen.


If you are presented with a prompt to update the directory’s VOC, modify the /u2/eclipse/.profile file as root, adding the following block of code before the “Setup the Eclipse environment” section:

# Move to the Eclipse account home directory
export ECLIPSEHOME=/u2/eclipse

If you’re still not able to log in using the new user’s credentials, please open a support request, and the Eclipse support team will provide assistance.