Administer scripts

As the Application Deployment administrator, you can manage the available scripts used for deploy, backup, rollback, and undeploy operations. These scripts are referenced by Code, Configuration File, and Windows Registry components. You can do the following:

• Creating a new script
• Modifying an existing script
• Deleting a script

Each of these processes is described briefly below—all topics assume that you have Application Deployment administrator privileges.

The contents of the script are copied when a version is created. Changes to scripts do not affect versions created previously.

Creating a new script

You must have permission to Manage Application Deployment in order to administer scripts.

Scripts are referenced in application components. They are used to facilitate deployment, backup, rollback, and undeploy operations. A set of basic scripts is provided “out of the box.” You can modify these scripts, or you can create new scripts. Users who have permission to create applications can reference these scripts when they create components.

To create a new script:

1. Go to the Administration screen (click Administration in the lower left corner).
2. In the left panel, click Scripts.
3. In the right panel, click Create Script. The New Script dialog opens.
4. Specify the following properties:
   • Name – enter a unique name (see Naming rules).
   • Component – type of component that will reference this script.
   • Purpose – select Deploy, Undeploy, Backup, or Rollback. Different components use scripts in different deployment phases. Only Windows Registry components, for example, use Deploy scripts.
   • Platform – select Windows or UNIX.
   • Primary – select this box if there are multiple scripts that serve this purpose for this type of component on this platform, and this is the default script for new components to use. This is useful, for example, when you are developing or testing a new script.
   • Type – select the script type. Available choices depend on the platform specified.
   • Content – enter the actual instructions that constitute the script.
5. You can also modify these properties for any existing script.
6. Click OK to save your changes and close the New Script dialog.

Modifying an existing script

You must have permission to Manage Application Deployment in order to administer scripts (see Set permissions).

You can modify any existing script by using the Edit Script dialog.

To modify a script:

1. Go to the Administration screen (click Administration in the lower left corner).
2. In the left panel, click Scripts.
3. In the right panel, select the script that you want to modify.
4. Click Edit Properties.. The Edit Script dialog opens.
5. Make any changes to the script’s properties (see Creating a new script).
6. Click OK to save your changes and close the Edit Script dialog.

Deleting a script

You must have permission to Manage Application Deployment in order to administer scripts (see Set permissions).

You can delete any existing script that is not In Use (used in a release).

To delete a script:

1. Go to the Administration screen (click Administration in the lower left corner).
2. In the left panel, click Scripts.
3. In the right panel, select the script that you want to delete.
4. Click Delete.
5. Click Yes to confirm.

If you want to delete a script, it must not be referenced by any release.