Control-D Pre-Installation Procedures on UNIX

Before you install Control-D, you need to complete the following procedures:

  • The Control-D/Agent is installed only in the home directory of the account, its subdirectories, or any directory located in the NFS.

  • The home directory is a symbolic link to another location when the location is on the local disk.

  • The permissions of the account home directory must allow read and execute permissions to all users and full permission to the account owner.

    Minimum: 755.

  • BMC recommends that you, as the agent owner, maintain the status of being the exclusive user in its primary group when you use non-root mode, because some of the files created by the agent rely on group permissions, which makes them susceptible to being written by any user within the Agent primary group.

Configuring a User Account on UNIX

This procedure describes how to configure specific parameters for Control-D.

Before You Begin

  • The account cannot contain any data, must be solely dedicated to Control-D, and the name must not exceed 8 characters.

  • The Control-D/WebAccess, Control-D Delivery Server, and Control-D/Agent owner is a local user, an LDAP user, or an NIS user.

  • The Control-D/WebAccess, Control-D Delivery Server account home directory is saved to a local disk or NFS.

Ensure that tcsh shell is also installed on this machine when you use /bin/csh as the startup shell for the Control-D user, as the application uses it internally.

Begin

  1. Do one of the following:

    • Create a user account by typing the following command:

      /usr/sbin/useradd -u <numeric_user_id> -g <user_group> -d <user_home>

    • Create a group, by typing one of the following commands:

      • UNIX/Solaris: /usr/sbin/groupadd<user_group>

      • AIX: /usr/bin/mkgroup <user_group>

      You must define the <user_shell> account as one of the following names or programs:

      • /bin/csh

      • /bin/tcsh

      • /bin/sh (Control-D/Agent and Control-D only).

      • /bin/ksh (Control-D/Agent and Control-D only).

      • /bin/bash (Control-D/Agent only).

      • In a clustered environment, you need to create two accounts, one for each node. Both accounts require identical names and IDs, and both home directories must point to the same location on the shared disk.

  2. Configure the predefined limits that are designed to limit or prevent the excessive use of resources by a single process, as described in Control-D Limits on UNIX Accounts.

  3. Verify that the HOST environment variable is defined on all shells by running the env command.

    Contact your IT system administrator when the HOST environment variable is not defined.

  4. Verify that the HOME directory is configured with 755 permissions by running Is Id on the Agent account.

    Run the chmod command to set the permissions when the value is not 775.

    The UNIX User Account is configured.

Control-D Limits on UNIX Accounts

The following table describes Control-D limits on UNIX accounts. Each account must have the minimum limit settings when you install Control-D components in separate accounts. The computer kernel soft or hard setting must reflect the sum total that is required by each account.

Parameter

Description

datasize

Determines the maximum size of the data segment of a process.

BMC recommends that you set this value to unlimited.

stacksize

Determines the maximum size of the stack segment of a process.

BMC recommends that you use 8 MB on all UNIX computers.

coredumpsize

Determines the maximum size that a core dump can reach.

BMC recommends that you set this value to datasize, which generates a complete core dump when a failure might occur.

descriptors

Determines the maximum number of descriptors in use by a single process.

BMC recommends that you set this value to 4096.

Do not set the parameter value to unlimited.

memoryuse

Determines the maximum amount of memory used by a single process.

BMC recommends that the values is unlimited.

maxproc

Determines the maximum number of user processes.

Default: 4096

Setting Environment Variables in UNIX

This procedure describes how to set environment variables in UNIX, which enables you to see messages from the console.

Begin

  • Do one of the following:

    • Use the following syntax when you use csh or tcsh:

      setenv <envVar> <value>

      Add this command to the .cshrc file in the $HOME directory to permanently change the value.

      setenv DISPLAY myhost:0.0

    • Use the following syntax when you use sh or ksh:

      <envVar>=<value>

      export <envVar>>

      Add this command to the .profile file in the $HOMEdirectory to permanently change the value.

      DISPLAY=myhost:0.0

      export DISPLAY

      envVar> is the name of the environment variable.

      value> is the value assigned to the environment variable.

    The Environment Variable is set.