Run the Event Management Configuration Script

Event Management Configuration › Run the Event Management Configuration Script

Run the Event Management Configuration Script

Include Event Management zFS in BPXPRMxx by updating your system BPXPRMxx member to include the new mount points for Event Management.

Adding the new mount points to your BPXPRMxx member allows the mounts to occur automatically when your system is IPLed.

If you selected Event Management for the installation, run the configuration script to customize certain files to your specific system.

If you did not run the fwsetup script against your SMP/E target USS file, run it now on the deployed-to system. If you did run fwsetup against the SMP/E target, run the shorter customization script fwmigrat, which requires no responses.

Both fwsetup script and fwmigrat script can be found in the designated Event Management directory (/cai/nsmem by default).

Note: Messages and prompts differ depending on whether you are running the script for the first time, rerunning the script, or reinstalling. Steps that do not run under all circumstances are appropriately identified.

Follow these steps:

Remove (not simply uncomment) any Event Management updates in your /etc/profile for previous Event Management installations.
Go into OMVS on your system and change to the Event Management directory.
```
cd /cai/nsmem
```
Invoke the script with the following command:
```
. fwsetup
```
Note: fwsetup executes many tasks. Wait during the execution of fwsetup. The text prompt is not automatically seen on the screen. To see the text prompt, press PF10 to refresh the screen when the status of the session changes from RUNNING to INPUT. You can press the refresh key any number of times. If you see the text prompts, type your response and press Enter, or press Enter to accept the default. Follow these steps until you see the CA Common Services installation has completed.

Important! Only press <Enter> if you are responding to a prompt or accepting the default to a prompt. If you press enter, you bypass the text prompt and cannot select a value for your response. Instead, you are accepting the default value.

The following messages display:
```
Installing CA Common Services...
```
```
Installing Event Management component...
```
Choose to activate Store and Forward or not.
If other Event Management nodes cannot be reached, the Event Management Store and Forward facility can save failed events for forwarding later.

Store and Forward (default: y)
Choose whether to create a rules file to restrict the use of certain message actions or allow all users to issue them.
Default behavior allows UNIXCMD and UNIXSH message actions to be submitted to this node (assuming there is a CAICCI connection) by all users. Event Management allows these two message actions to be restricted. The rules for these message actions are maintained through a utility named caevtsec. For more information about caevtsec, see the Administration Guide.
- For first-time installations:
  If the script does not find an existing rules file, decide if you want to create one.
```
Would you like to restrict the UNIXCMD and UNIXSH message actions for this host? 
```
```
These actions were not restricted in Unicenter release 1.5.(y/n) (default: n)
```
  After you answer, the following message appears:
```
Installing Star Server component...
```
- For reinstalling and rerunning the script:
  The script asks if you want to create a new rules file or use the existing one.
```
A version of the Event Security rules file has been detected on your system.
```
```
Answering y will preserve the original rules file (from the previous installation or upgrade) and will remove the restrictions of UNIXCMD and UNIXSH message actions for this host.
```
```
Answering n (default) will assume the restrictions previously enacted.
```
```
Would you like to recreate Event Security rules file? (y/n) (default: n)
```
  If you create a new rules file, the script informs you that the rules have been updated and the original rules file has been saved.
```
The original rules file has been preserved as /cai/nsmem/opr/config/<nodename>/actnode.prf.sav
```
Set environment variables.
To use Event Management, set certain environment variables, including PATH and LIBPATH.

You can have the system file etc/profile automatically set the Event Management environment variables in the /cai/nsmem/PROFILE file when a user logs in.
- If the environment variable UPDATE_ETC in the PROFILE file is set to Y (yes), /etc/profile is updated to run the PROFILE file automatically. Your EM environment variables are then set automatically when a user logs in.
- If the environment variable UPDATE_ETC in the PROFILE file is set to N (no), /etc/profile is not updated and all users have to set the EM environment variables.
- If the environment variable UPDATE_ETC was not set in the PROFILE file either during installation or later, you are asked whether you want to update /etc/profile.
  For first time installations, you can update /etc/profile to set variables automatically when users logon.
```
Do you want to update /etc/profile? (y/n)
```
  - If you use y (yes), /etc/profile is updated to set environment variables for all users when they log in.
  - If you use n (no), run the tngprofile script before attempting to issue any commands
  When reinstalling or rerunning the fwsetup script, if it is detected that /etc/profile has been previously updated to run the PROFILE file, you can receive the following messages and the option to update /etc/profile is bypassed.
```
WARNING! /etc/profile has been previously updated. Please check the contents of /etc/profile to be sure the entry is valid for the current installation. If not, remove the update and re-run this fwsetup script.
```
```
WARNING! /etc/csh.login has been previously updated. Please check the contents of the file to be sure the entry is valid for the current installation. If not, remove the update and re-run this fwsetup script.
```

The following message appears:

CA Common Services installation has completed.

Verify that fwsetup has completed successfully.
- If you indicated y to update /etc/profile, in that file you see the updates that are inserted for Event Management.
- Confirm that the /cai/nsmem/RW/config/ directory contains a subdirectory with the same name as the nodename for the system.