Home Operating Systems: AIX, HP-UX, Linux, Solaris
Run the setupadm script for the administration server
When using the IHS administration server, the setupadm script establishes permissions for configuration file updates.
You must run the setupadm command if we are installing IHS as a non-root user. The setupadm command is run in the <IHS_HOME>/bin so that you can properly use the administrative server with the WebSphere Application Server. The format for the command is as follows (on one line):
setupadm -usr <userName> -grp <groupName> -cfg <IHS Web server configuration file> -adm <IHS admistrative server configuration file> -plg <plug-in configuration file>
When using the administration server, you cannot update the configuration files after a default server installation, unless you run the setupadm script, or you set permissions manually.
The setupadm script prompts you for the following input:
- User ID - The user ID that you use to log on to the administration server. The script creates this user ID.
- Group name - The administration server accesses the configuration files and authentication files through group file permissions. The script creates the specified group through this script.
- Directory - The where you can find configuration files and authentication files.
- File name -
The following file groups and file permissions change:
- Single file name
- File name with wildcard
- All (default) - All of the files in the specific
- Processing - The setupadm script changes the group and file permissions of the configuration files and authentication files.
What to do next
The administration server requires read and write access to configuration files and authentication files to perform Web server configuration data administration. In addition to the Web server files, change the permissions to the targeted plug-in configuration files. See Setting permissions manually for instructions.
The administration server has to invoke apachectl restart as root to perform successful restarts of the IBM HTTP Server.