Promoting in GoAnywhere

[Support_Hans]

Question: I see a Promote option on some items in GoAnywhere. What does Promote do and what features can I promote?

Answer: Promotion is uploading a copy of an item from one GoAnywhere installation to another targeted installation. For example, after an item is tested, it could be promoted from that the test installation to a production installation of GoAnywhere. If the Admin User account is assigned to a custom Admin User Role, the custom role must provide the ability to manage, read, and write the item being promoted.

The features that may be promoted are: Projects, Triggers, Monitors, Web Users, Web User Groups, Secure Forms, Scheduled Jobs and Add-ons.

To promote a Project successfully:

1. You must have an Admin user profile on the destination system as well as:
• Project Designer role on both the source and target GoAnywhere installations.
• Read permission for the Project folder on the source GoAnywhere installation.
• Write permission for the Project folder on the target GoAnywhere installation.
• If the Admin User account is assigned to a custom Admin User Role, the custom role must provide the ability to manage, read, and write on the item being promoted.
• Access to the target Domain.

2. Click the More Actions icon next to the item, (the green cogwheel) then select Promote.

3. Enter values for the following fields:

-Target Server - the host name/IP address of the GoAnywhere installation. The value specified must be a URL of the form http://[host]:[port]/goanywhere where [host] is the host name or IP address of the target GoAnywhere installation, and [port] is the port number on which GoAnywhere server is running, which by default is 8000. An example value would be http://10.1.4.1:8000/goanywhere.

-User Name - the Admin user name to login to the target GoAnywhere installation.

-Password - the password for the Admin user to login. The password is case sensitive.

- Target Folder - The folder on the target installation into which to copy the Project(s).

- Create Target Folder - Indicate if the target folder should be created if it does not already exist.

-Replace/Update Target Item(s)?- indicate if the items should be replaced on the target GoAnywhere installation if they already exist with the same name in the target folder. This field applies to promoting Projects, Triggers, Monitors, Secure Forms, Schedulers, Resources, and Add-ons.

-Target Domain - the name of the target Domain on the target server. This field is required when the user is authorized to more than one Domain. Admin Users promoting Projects, Monitors, Secure Forms, Schedulers, and Resources must have access to the target Domain.

4. Click the Promote button after the fields above have been filled out.

Note: Promoting projects to a different version of GoAnywhere is not recommended, and may not work in some cases. Additionally, a command named CPYPROJECT is available for promoting Projects from the IBM i(iSeries). The CPYPROJECT command can be executed from a command line, placed in a CL program or run from the IBM i scheduler. This command is located in the default library named GOANYWHERE.

When promoting the following within GoAnywhere:

- Triggers- Trigger Manager role is required in order to promote Triggers. If your Admin User account is assigned a custom Admin user Role, your ability to view, modify, or execute actions on this page are based on the permissions specified for that role.

- Monitors- Job Manager role is required in order to promote Monitors.

- Web Users/Web User Groups- Web User Manager role is required in order to promote both Web Users and Web User Groups. Additional fields to fill out in order to promote Web User Groups include:

-Ignore User Membership- A Web User Group is typically linked to a number of Web Users. When promoting a Web User Group, this option can be specified to ignore all Web Users associated with the Web User Group. If this option is not specified, the Web Users associated with that group must already exist in GoAnywhere on the target system. When promoting Web User Groups and Web Users from one system to another, it is recommended to first promote the Web User Groups using the Ignore User Membership option and then promote the Web Users. The Web Users will be associated to the Web User Groups when they are promoted.

-Ignore Secure Forms- A Web User Group may be linked to a number of Secure Forms. When promoting a Web User group, this option can be specified to ignore all Secure Forms associated with the Web User Group. if this option is not specified, the Secure Forms associated with this group must already exist in GoAnywhere on the target system.

- Secure Forms- Secure Form Manager role is required in order to promote Secure Forms. Additional fields to fill out in order to promote include:

-Ignore Web User Membership- When a Secure Form is exported, the ZIP file contains a list of Web Users that are associated with the Secure Form. When importing, this option can be specified to ignore all Web Users associated with the Secure Form.

-Ignore Web User Group Membership- When a Secure form is exported, the ZIP file contains a list of Web User Groups that are associated with the Secure Form. When importing, this option can be specified to ignore all Web User Groups associated with the Secure Form.

- Schedulers- Job Manager role is required in order to promote Schedulers.

- Resources- Resource Manager role is required in order to promote Resources. Other permissions required for the Admin User include:
-Read permission for the Resource on the source GoAnywhere installation.
-Write permission for the Resource on the target GoAnywhere installation (if you chose to Replace Target Resource(s)).

Additionally, a command named CPYRES is available for promoting Resources from the IBM i (iSeries). The CPYRES command can be executed from a command line, placed in a CL program, run from the IBM i scheduler. This command is located in the installation library, which by default is GOANYWHERE.

Resources can also be promoted to another GoAnywhere server by using the promoteResource function in GoAnywhere Command (GACMD). Refer to the GoAnywhere Command User Guide for more information.

- Cloud Connectors/Add-ons- Product Admin role is required in order to promote Add-ons.
Note that promoting to a different version of GoAnywhere is not recommended, and may not work in some cases; Add-ons downloaded from the Marketplace cannot be promoted.